std::basic_string

 

C++

語言

概念

實用工具庫

字符串庫

容器庫

算法庫

迭代器庫

數值算法庫

輸入/輸出庫

本地化庫

正則表達式庫 （C++11）

原子操作庫 （C++11）

線程的支持庫 （C++11）

 

字符串庫

|- class="t-nv-h1"

| colspan="5" |

null結尾的字符串

原文：

Null-terminated strings

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

|-

|- class="t-nv-h1"

| colspan="5" |

類

原文：

Classes

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

|-

位元組的字符串

多位元組字符串

寬字符串

basic_string

char_traits

 

std::basic_string

|- class="t-nv-h1"

| colspan="5" |

成員函數

原文：

Member functions

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

|-

|- class="t-nv-h1"

| colspan="5" |

常量

原文：

Constants

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

|-

|- class="t-nv-h1"

| colspan="5" |

非成員函數

原文：

Non-member functions

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

|-

|- class="t-nv-h1"

| colspan="5" |

Helper類

原文：

Helper classes

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

|-

basic_string::basic_string

basic_string::operator=

basic_string::assign

basic_string::get_allocator

元素的訪問 原文： Element access 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

basic_string::at

basic_string::operator[]

basic_string::front （C++11）

basic_string::back （C++11）

basic_string::data

basic_string::c_str

迭代器 原文： Iterators 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

basic_string::begin basic_string::cbegin （C++11）

basic_string::end basic_string::cend （C++11）

basic_string::rbegin basic_string::crbegin （C++11）

basic_string::rend basic_string::crend （C++11）

容量 原文： Capacity 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

basic_string::empty

basic_string::size

basic_string::length

basic_string::max_size

basic_string::reserve

basic_string::capacity

basic_string::shrink_to_fit （C++11）

操作 原文： Operations 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

basic_string::clear

basic_string::insert

basic_string::erase

basic_string::push_back

basic_string::pop_back （C++11）

basic_string::append

basic_string::operator+=

basic_string::compare

basic_string::replace

basic_string::substr

basic_string::copy

basic_string::resize

basic_string::swap

搜索 原文： Search 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

basic_string::find

basic_string::rfind

basic_string::find_first_of

basic_string::find_first_not_of

basic_string::find_last_of

basic_string::find_last_not_of

basic_string::npos

operator+

operator== operator!= operator< operator> operator<= operator>=

swap(std::basic_string)

operator<< operator>>

getline

stoi stol stoll （C++11） （C++11） （C++11）

stoul stoull （C++11） （C++11）

stof stod stold （C++11） （C++11） （C++11）

to_string （C++11）

to_wstring （C++11）

hash<std::string> hash<std::wstring> hash<std::u32string> hash<std::u16string> （C++11）

 

在頭文件 <string> 中定義
template<     class CharT,     class Traits = std::char_traits<CharT>,     class Allocator = std::allocator<CharT> > class basic_string;

類模板basic_string存儲和處理字符類型的對象序列（即特化的std::char_traits對象或兼容的特性類）。

原文：

The class template basic_string stores and manipulates sequences of char-like objects (that is, objects for which a specialization of std::char_traits or compatible traits class is provided).

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

basic_string中的元素連續存儲，也就是說，對於一個basic_strings，[0, s.size())中的任意n都滿足&*(s.begin() + n) == &*s.begin() + n，或者，與之等價，一個指向s[0]的指針可以傳遞給函數，這個函數接收charT[]數組第一個元素的指針。 （since C++11）

原文：

The elements of a basic_string are stored contiguously, that is, for a basic_string s, &*(s.begin() + n) == &*s.begin() + n for any n in [0, s.size()), or, equivalently, a pointer to s[0] can be passed to functions that expect a pointer to the first element of a charT[] array. （since C++11）

這段文字是通過 Google Translate 自動翻譯生成的。
您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。

為常見字符類型提供的一些特化類:

在頭文件 <string> 中定義
類型	定義
std::string	std::basic_string<char>
std::wstring	std::basic_string<wchar_t>
std::u16string	std::basic_string<char16_t>
std::u32string	std::basic_string<char32_t>

成員類型

成員類型	定義
traits_type	Traits
value_type	Traits::char_type
allocator_type	Allocator
size_type	無符號整型（通常是size_t）
difference_type	有符號整型 (通常是ptrdiff_t)
reference	Allocator::reference （until C++11） value_type& （since C++11）
const_reference	Allocator::const_reference （until C++11） const value_type& （since C++11）
pointer	Allocator::pointer （until C++11） std::allocator_traits<Allocator>::pointer （since C++11）
const_pointer	Allocator::const_pointer （until C++11） std::allocator_traits<Allocator>::const_pointer （since C++11）
iterator	RandomAccessIterator
const_iterator	隨機訪問常迭代器
reverse_iterator	std::reverse_iterator<iterator>
const_reverse_iterator	std::reverse_iterator<const_iterator>

成員函數

(constructor)	構造basic_string 原文： constructs a basic_string 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
operator=	為字符串賦值 (公共成員函數)
assign	為字符串賦值 (公共成員函數)
get_allocator	返回關聯的分配器 (公共成員函數)
元素的訪問 原文： Element access 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
at	訪問指定位置的字符，帶邊界檢查 (公共成員函數)
operator[]	訪問指定位置的字符 (公共成員函數)
front （C++11）	訪問的第一個字符 原文： accesses the first character 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
back （C++11）	訪問的最後一個字符 原文： accesses the last character 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
data	返回一個指針，指向一個字符串的第一個字符 原文： returns a pointer to the first character of a string 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
c_str	返回一個不可修改的C風格字符串 原文： returns a non-modifiable standard C character array version of the string 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
迭代器 原文： Iterators 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
begin cbegin （C++11）	返回指向字符串第一個元素的迭代器 原文： returns an iterator to the beginning 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
end cend （C++11）	返回指向字符串尾端的迭代器 原文： returns an iterator to the end 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
rbegin crbegin （C++11）	返回一個指向字符串最後一個元素的反向迭代器 原文： returns a reverse iterator to the beginning 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
rend crend （C++11）	返回一個指向字符串前端的反向迭代器 原文： returns a reverse iterator to the end 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
容量 原文： Capacity 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
empty	檢查字符串是否為空 原文： checks whether the string is empty 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
size length	返回字符數量 (公共成員函數)
max_size	返回最大字符數量 原文： returns the maximum number of characters 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
reserve	預留存儲空間 原文： reserves storage 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
capacity	返回當前分配的存儲空間可容納的最大字符數量 原文： returns the number of characters that can be held in currently allocated storage 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
shrink_to_fit （C++11）	通過釋放未使用的內存減少內存使用 原文： reduces memory usage by freeing unused memory 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
操作 原文： Operations 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
clear	刪除全部內容 原文： clears the contents 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
insert	插入字符 原文： inserts characters 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
erase	刪除字符 (公共成員函數)
push_back	向末尾添加字符 原文： appends a character to the end 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
pop_back （C++11）	刪除最後一個字符 原文： removes the last character 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
append	向末尾添加字符（串） 原文： appends characters to the end 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
operator+=	向末尾添加字符（串） 原文： appends characters to the end 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
compare	比較兩個字符串 原文： compares two strings 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
replace	替換出現的每一個指定的字符 原文： replaces every occurrence of specified characters 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
substr	返回子字符串 原文： returns a substring 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
copy	複製字符 原文： copies characters 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
resize	改變存儲的字符數 原文： changes the number of characters stored 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
swap	交換字符串的內容 原文： swaps the contents 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
搜索 原文： Search 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
find	在字符串中尋找字符（串） (公共成員函數)
rfind	尋找字符（串）最後一次出現的位置 原文： find the last occurrence of a substring 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
find_first_of	尋找字符串中任意字符第一次出現的位置 原文： find first occurrence of characters 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
find_first_not_of	尋找字符串中任意字符第一次缺失的位置 原文： find first absence of characters 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
find_last_of	尋找字符串中任意字符最後一次出現的位置 原文： find last occurrence of characters 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共成員函數)
find_last_not_of	尋找字符串中任意字符最後一次缺失的位置 (公共成員函數)
常量 原文： Constants 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
npos [靜態的]</div></div>	特殊值。確切的含義取決於具體情況。 原文： special value. The exact meaning depends on the context 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (公共靜態成員常量)

非成員函數

operator+	連接兩個字符串或字符和字符串 (函數模板)
operator== operator!= operator< operator> operator<= operator>=	按字典順序比較兩個字符串 原文： lexicographically compares two strings 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數模板)
std::swap(std::basic_string)	特化的std::swap算法 原文： specializes the std::swap algorithm 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數模板)
輸入/輸出 原文： Input/output 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
operator<< operator>>	在字符串上執行流式I/O (函數模板)
getline	從的I/O流讀取數據，並寫入字符串 原文： read data from an I/O stream into a string 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數)
數值轉換 原文： Numeric conversions 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。
stoi stol stoll （C++11） （C++11） （C++11）	將字符串轉換為有符號整數 原文： converts a string to an signed integer 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數)
stoul stoull （C++11） （C++11）	將字符串轉換為無符號整數 原文： converts a string to an unsigned integer 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數)
stof stod stold （C++11） （C++11） （C++11）	將字符串轉換為浮點值 原文： converts a string to an floating point value 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數)
to_string （C++11）	將整數或浮點值轉換為string 原文： converts an integral or floating point value to string 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數)
to_wstring （C++11）	將整數或浮點值轉換為wstring 原文： converts an integral or floating point value to wstring 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (函數)

字面值

定義於 std::literals::string_literals 名字空間
operator""s (C++14)	將字符數組字面值轉換為 basic_string (函數)

輔助類

std::hash<std::string> std::hash<std::u16string> std::hash<std::u32string> std::hash<std::wstring> （C++11） （C++11） （C++11） （C++11）

支持字符串的哈希函數 原文： hash support for strings 這段文字是通過 Google Translate 自動翻譯生成的。 您可以幫助我們檢查、糾正翻譯中的錯誤。詳情請點擊這裡。 (類模板特化)