C++

參考

<string>

basic_string

類模板
<string>

std::basic_string

template < class charT,           class traits = char_traits<charT>,    // basic_string::traits_type           class Alloc = allocator<charT>        // basic_string::allocator_type           > class basic_string;
通用字串類
要放回的字元的basic_string是 string 類對於任何字元型別的泛化（請參閱 string 以獲取描述）。

模板引數

charT
字元型別。
字串由該型別的字元序列構成。
這應是一個非陣列的 POD 型別。
特性 (traits)
字元特性類，它定義了 basic_string 物件所使用的字元的基本屬性（請參閱 char_traits）。
traits::char_type應與charT.
別名為成員型別basic_string::traits_type.
Alloc
用於定義儲存分配模型的分配器物件型別。預設情況下，使用 allocator 類模板，它定義了最簡單的記憶體分配模型並且與值無關。
別名為成員型別basic_string::allocator_type.

注意：由於第一個模板引數未被別名為任何成員型別，charT在本參考中被用來指代此型別。

sub_match for string literals (class)

string
字串類 (class)
wstring
寬字串類 (class)
u16string
16位字元字串類 (class)
u32string
32位字元字串類 (class)

成員型別

成員型別定義說明
traits_type第二個模板引數 (特性 (traits))預設為char_traits<charT>
allocator_type第三個模板引數 (Alloc)預設為allocator<charT>
value_typetraits_type::char_type應與charT
引用allocator_type::reference對於預設的 allocatorcharT&
const_referenceallocator_type::const_reference對於預設的 allocatorconst charT&
指標allocator_type::pointer對於預設的 allocatorcharT*
const_pointerallocator_type::const_pointer對於預設的 allocatorconst charT*
iterator一個指向charT的 隨機訪問迭代器，可轉換為const_iterator
const_iterator一個指向const charT
reverse_iteratorreverse_iterator<iterator>
const_reverse_iteratorreverse_iterator<const_iterator>
difference_typeallocator_type::difference_type相同，通常與 ptrdiff_t 一樣
size_typeallocator_type::size_type的無符號整數型別，通常與 size_t 一樣
成員型別定義說明
traits_type第二個模板引數 (特性 (traits))預設為char_traits<charT>
allocator_type第三個模板引數 (Alloc)預設為allocator<charT>
value_typetraits_type::char_type應與charT
引用value_type&
const_referenceconst value_type&
指標allocator_traits<allocator_type>::pointer對於預設的 allocatorcharT*
const_pointerallocator_traits<allocator_type>::const_pointer對於預設的 allocatorconst charT*
iterator一個指向charT的 隨機訪問迭代器，可轉換為const_iterator
const_iterator一個指向const charT
reverse_iteratorreverse_iterator<iterator>
const_reverse_iteratorreverse_iterator<const_iterator>
difference_typeallocator_traits<allocator_type>::difference_type相同，通常與 ptrdiff_t 一樣
size_typeallocator_traits<allocator_type>::size_type的無符號整數型別，通常與 size_t 一樣

成員函式

（建構函式）
構造 basic_string 物件 (公共成員函式)
(解構函式)
字串解構函式 (public member function)
operator=
字串賦值 (公共成員函式)

迭代器:
begin
返回指向起始位置的迭代器 (公開成員函式)
end
返回指向末尾的迭代器 (公開成員函式)
rbegin
返回指向反向起始位置的反向迭代器 (公開成員函式)
rend
返回指向反向末尾的反向迭代器 (公開成員函式)
cbegin
返回指向起始位置的 const_iterator (公開成員函式)
cend
返回指向末尾的 const_iterator (公開成員函式)
crbegin
返回指向反向起始位置的 const_reverse_iterator (公開成員函式)
crend
返回指向反向末尾的 const_reverse_iterator (公開成員函式)

容量:
size
返回大小 (公開成員函式)
長度
返回字串的長度 (公共成員函式)
max_size
返回最大大小 (公開成員函式)
resize
調整字串大小 (公共成員函式)
容量
返回分配儲存的大小 (公共成員函式)
reserve
請求更改容量 (公共成員函式)
clear
清除字串 (公共成員函式)
empty
測試字串是否為空 (公共成員函式)
shrink_to_fit
縮小到適合 (公共成員函式)

元素訪問:
operator[]
獲取字串的字元 (public member function)
at
獲取字串的字元 (public member function)
back
訪問最後一個字元 (公共成員函式)
front
訪問第一個字元 (public member function)

修改器:
operator+=
追加到字串 (public member function)
append
追加到字串 (public member function)
push_back
將字元附加到字串 (公共成員函式)
assign
將內容分配給字串 (public member function)
insert
插入到字串 (public member function)
erase
從字串中刪除字元 (公共成員函式)
replace
替換字串的一部分 (public member function)
swap
交換字串值 (公共成員函式)
pop_back
刪除最後一個字元 (public member function)

字串操作:
c_str
獲取 C 字串等效項
data
獲取字串資料 (public member function)
get_allocator
獲取分配器 (公開成員函式)
copy
從字串複製字元序列 (public member function)
find
查詢字串中第一次出現(公共成員函式)
rfind
在字串中查詢最後一次出現 (公共成員函式)
find_first_of
在字串中查詢字元 (公共成員函式)
find_last_of
從字串末尾查詢字元 (公共成員函式)
find_first_not_of
在字串中查詢非匹配字元 (公共成員函式)
find_last_not_of
從字串末尾查詢不匹配的字元 (公共成員函式)
substr
生成子字串 (公共成員函式)
compare
比較字串 (公共成員函式)

非成員函式過載

`operator+`
連線字串 (function template)
關係運算符
basic_string的關係運算符 (函式模板)
swap
交換兩個字串的值(函式模板)
operator>>
從流中提取字串(函式模板)
operator<<
將字串插入流 (function template)
getline
從流獲取行到字串 (函式模板)

成員常量

npos
size_type 的最大值 (public static member constant)