basic_string Class

由範本類別 basic_string 的物件來控制序列的標準 C++ 字串類別，而且通常稱為字串，但不是應該將它們搞混了 null 結尾 C-字串使用標準的 C++ 程式庫。 字串類別是一個容器，可以字串使用標準的型別，例如使用比較和串連運算、 iterator 和 STL 演算法，並複製，類別配置器與指派管理記憶體。

template <
   class CharType,
   class Traits=char_traits<CharType>, 
   class Allocator=allocator<CharType> 
>
class basic_string

參數

• CharType
  單一字元字串中儲存的資料型別。 標準 C++ 程式庫可以提供這個樣板類別，與型別定義的兩個特製化字串，為型別的項目char，和 wstring，為型別的項目wchar_t。

• Traits
  數個重要內容 CharType basic_string 特製化中的項目會說明此類別所特性。

• Allocator
  表示會封裝字串配置及解除配置記憶體的詳細資料的預存的配置器物件的型別。 預設值是配置器*<Type>。*

許多成員函式需要運算元序列的項目。 您可以指定這類運算元序列都算一個幾種方法。

項目	描述
_Ch	以字元值的一個項目_Ch。
_Count, _Ch	重複的_Count每個項目值 _Ch。
_Ptr	Null 結尾的順序，例如 c 字串，與 CharType 型別的char、 開始在_Ptr (其中不得為 null 指標)，終止元素是值的地方value_type而非運算元順序的一部份。
_Ptr _Count	一系列的_Count項目，其起始地_Ptr。
_Str	Basic_string 物件所指定的順序。
_Str，_Off，_Count	Basic_string 物件的子字串， _Str與最多_Count項目 (或透過字串的結尾，取其先) 位置開始 _Off。
_First _Last	Iterator 以分隔項目的序列_First和_Last，在範圍 [_First、 _Last)，這可能會重疊順序，由其成員函式被呼叫的字串物件控制。

如果位置引數 (例如_Off) 是在呼叫的字串結尾之外製作basic_string成員函式，函式報告超出範圍錯誤藉由擲回的物件型別的 out_of_range 類別。

如果函式則要求產生序列的長度超過 max_size 項目時，此函式報告長度錯誤藉由擲回的物件型別的 length_error 類別。

參考、 指標和 iterator，以指定受控制序列的項目可能會變得不正確或為非第一次的呼叫之後，會變更受控制的序列中，函式的任何呼叫-const 成員函式。

建構函式

basic_string

建構為空白或初始化由特定的字元或也就是所有的複本或其他的字串物件的部分或 c 字串的字串。

Typedef

allocator_type	表示的型別allocator於字串物件的類別。
const_iterator	提供隨機存取 iterator 的型別可以存取和讀取const在字串中的項目。
const_pointer	提供型別，變數的指標， const在字串中的項目。
const_reference	提供參考的型別const項目儲存在字串的讀取和執行const作業。
const_reverse_iterator	提供型別，隨機存取 iterator，可以閱讀任何const在字串中的項目。
difference_type	此型別提供兩個相同的字串內的項目，請參閱的 iterator 之間的差異。
Iterator	提供隨機存取 iterator，可讀取或修改任何在字串中的元素型別。
npos	不帶正負號的整數值初始化為 – 1，表示其中一個 「 找不到 」 或 「 所有的剩餘字元 」 搜尋功能就會失敗。
pointer	提供型別，變數的指標，字串或字元陣列中的字元項目。
參考	提供儲存在字串中的項目參考型別。
reverse_iterator	此型別提供隨機存取 iterator，可讀取或修改已還原的字串中的項目。
size_type	在字串中的項目數不帶正負號整數類資料型別。
traits_type	個字元特性的型別儲存在字串中的項目。
value_type	儲存在字串中字元的型別表示的型別。

成員函式

append	將字元加入至字串結尾。
assign	為字串的內容指定新的字元值。
at	傳回字串中的指定位置處的項目參考。
back
begin	傳回 iterator 定址字串中的第一個項目。
c_str	將字串的內容轉換為 c-style，null 結尾字串。
capacity	傳回最多可以儲存在字串，而不增加字串的記憶體配置的項目。
cbegin	傳回常數的 iterator 定址字串中的第一個項目。
cend	傳回常數的 iterator，解決後續在字串中的最後一個元素的位置。
clear	會清除所有的項目使用字串。
compare	比較指定的字串，以判斷兩個字串相等，或其中一個是您小於另一個字串。
copy	會複製最多指定的字元數從來源字串中的索引位置為目標的字元陣列。 已取代。 請改用 basic_string::_Copy_s。
crbegin	傳回常數的 iterator，反轉字串的第一個元件能解決。
crend	傳回常數的 iterator，解決後續反轉字串的最後一個元素的位置。
_Copy_s	會複製最多指定的字元數從來源字串中的索引位置為目標的字元陣列。
data	將字串的內容轉換成字元陣列中。
empty	測試是否該字串包含的字元。
end	Iterator 可解決成功在字串中的最後一個元素的位置，它會傳回。
清除	移除項目或項目範圍中為指定的位置中的字串。
find	會在字串中搜尋符合指定的一連串字元的子字串首次出現的順向方向。
find_first_not_of	搜尋到字串的第一個字元不是指定之任何的字串項目。
find_first_of	搜尋到字串比對任何項目指定之字串的第一個字元。
find_last_not_of	搜尋到字串的最後一個字元不是指定之任何的字串項目。
find_last_of	搜尋到字串是指定之字串的元素的最後一個字元。
front	傳回字串中的第一個項目的參考。
get_allocator	傳回一份allocator物件，用來建構字串。
插入	將項目或項目的數字或範圍的項目插入指定位置的字串。
length	傳回字串中的目前的項目數目。
max_size	傳回的字元字串，也可能包含的最大數目。
pop_back	會清除該字串的最後一個元素。
push_back	將元素加入至字串結尾。
rbegin	反轉字串中的第一個項目會回到 iterator。
rend	反轉字串中傳回 iterator 那些點只是超出最後一個項目。
replace	以取代項目中指定位置的字串中指定的字元或從其他的範圍或字串或 c 字串複製的字元。
reserve	設定數字的字串的容量至少大為指定的數字。
resize	指定新的大小，一字串，附加，或清除所需的項目。
rfind	符合指定的一連串字元的子字串首次出現反向搜尋字串。
shrink_to_fit	丟棄額外容量的字串。
size	傳回字串中的目前的項目數目。
substr	複製子字串最多某些數量的字元字串中開始從指定的位置。
交換	交換兩個字串的內容。

運算子

運算子 + =	將字元附加至字串中。
operator=	為字串的內容指定新的字元值。
operator[]	提供指定的索引，在字串中字元的參考。

需求

標頭: <string>

Namespace: 標準

請參閱

參考

在標準 C++ 程式庫中的執行緒安全

其他資源

basic_string 成員

<string> 成員