basic_string Class

[アーティクル]
03/15/2013

テンプレートクラス basic_string をオブジェクトが制御シーケンス標準 C++ の文字列クラスは、通常は文字列として呼ばれますが、null で終わる C、標準 C++ ライブラリ全体で使用される文字列を混同しません。文字列クラス比較および連結操作、反復子、および STL アルゴリズムを使用して、コピーなどの標準の種類として文字列の使用を有効するコンテナーにはクラスのアロケーターで割り当てメモリを管理します。

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

パラメーター

CharType
1 つの文字を文字列に格納できるデータ型。標準 C++ ライブラリのこのテンプレートクラスは、型定義を持つ 2 つの特殊な形式を提供する文字列、要素の型をchar、および wstring、型の要素をwchar_t。
Traits
各種の重要なプロパティを CharType クラスによって説明する要素では、basic_string 専門特徴。
Allocator
文字列の割り当てとメモリの割り当て解除の詳細をカプセル化するストアドアロケーターオブジェクトを表す型。既定値はアロケーター*<Type>.*

多くのメンバー関数では、オペランドシーケンスの要素が必要です。ようなオペランドシーケンスいくつかの方法を指定できます。

要素	Description
_Ch	1 つの要素が文字値_Ch。
_Count, _Ch	繰り返しの_Count要素ごとに値 _Ch 。
_Ptr	C 文字列などの null で終わるシーケンスで、 CharType タイプのchar、最初に_Ptr (は、null ポインターを指定する必要がありますいない)、末尾の要素の値ですvalue_typeし、オペランドシーケンスの一部ではありません。
_Ptr、です。	一連の_Countで始まる要素_Ptr。
_Str	Basic_string オブジェクトによって指定された順序を指定します。
_、_Off です	Basic_string オブジェクトの部分_Strで最大_Count要素 (または文字列の末尾から、早い) 位置から開始 _Off 。
_First、_Last	シーケンスの要素の反復子によって区切られた_Firstと_Last、範囲に [_First、_Last)、メンバー関数が呼び出されます、文字列オブジェクトが制御シーケンスが重なる場合があります。

位置の引数の場合 (など_Off) の呼び出しで文字列の末尾を超えたが、 basic_stringメンバー関数、関数報告範囲外のエラー型のオブジェクトをスローすることによって out_of_range クラス。

関数より長いシーケンスの生成を要求するかどうか max_size 要素、関数は、レポートの長さのエラー型のオブジェクトをスローすることによってクラスの length_error。

参照、ポインター、および被制御シーケンスの要素を指定する反復子できます無効になる可能性は、被制御シーケンスを変更する関数呼び出しの後、または後、最初の呼び出し以外に-const メンバー関数します。

コンストラクター

basic_string

空または特定の文字がコピーのすべてまたはいくつか他の string オブジェクトの部分を初期化または C 文字列 string を構築します。

Typedef

allocator_type	型を表す、 allocatorクラスの文字列オブジェクト。
const_iterator	ランダムアクセスの反復子を提供する型がアクセスして読み取ることができます、 const 、文字列内の要素。
const_pointer	ポインターを提供する型は、 const 、文字列内の要素。
const_reference	参照を提供する型は、 constの読み取りおよび実行する文字列に格納されている要素const操作。
const_reverse_iterator	いずれかがランダムアクセスの反復子を提供する種類を読むconst 、文字列内の要素。
difference_type	同じ文字列内の要素を参照してください 2 つの反復子の違いを提供する型。
iterator	読み取りまたは文字列内の任意の要素を変更できます、ランダムアクセス反復子を提供する型。
npos	-1 は"not found"を示す「残りすべての文字」に初期化、符号なしの整数値、検索関数が失敗した場合します。
ポインター	文字の要素では、文字列または文字配列へのポインターを提供する型。
参照	文字列に格納されている要素への参照を提供する型。
reverse_iterator	読み取りまたは取り消された文字列内の要素を変更できます、ランダムアクセス反復子を提供する型。
size_type	符号なしの整数型、文字列内の要素の数を指定します。
traits_type	文字列に格納されている要素の型を文字の特徴。
value_type	文字列に格納されている文字の種類を表す型。

メンバー関数

append	文字は、文字列の末尾に追加されます。
assign	文字列の内容を新しい文字の値を割り当てます。
at	文字列内の指定された位置にある要素への参照を返します。
back
begin	文字列の最初の要素のアドレスを指定する反復子を返します。
c_str	文字列の内容は、C スタイルの null で終わる文字列として変換します。
capacity	文字列のメモリ割り当てを増やすことなくが文字列に格納できる要素の最大数を返します。
cbegin	文字列の最初の要素のアドレス指定 const の反復子を返します。
cend	文字列内の最後の要素を成功の場所のアドレスを const 反復子を返します。
clear	文字列のすべての要素を消去します。
compare	2 つの文字列が等しい場合、またはいずれか他のよりあります少ない場合を決定する、指定した文字列と文字列を比較します。
copy	最大文字数を指定、ソース文字列内のインデックス位置からターゲット文字配列にコピーします。使用は推奨されていません。代わりに、basic_string::_Copy_s を使用してください。
crbegin	取り消された文字列内の最初の要素のアドレスはの const 反復子を返します。
crend	取り消された文字列内の最後の要素を成功の場所のアドレスがの const 反復子を返します。
_Copy_s	最大文字数を指定、ソース文字列内のインデックス位置からターゲット文字配列にコピーします。
データ	文字列の内容を文字の配列に変換します。
empty	文字列に文字が含まれているかどうかをテストします。
End	文字列内の最後の要素を成功の場所に対応する反復子を返します。
消去	要素または要素の範囲内の指定された位置から文字列を削除します。
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	取り消された文字列内の最初の要素に反復子を返します。
rend	反復子、取り消された文字列内指し示す、最後の要素を返します。
replace	要素は、文字列内の指定した位置に指定した文字またはその他の範囲または文字列 C 文字列からコピーする文字に置き換えられます。
reserve	文字列の容量を少なくとも指定された数と同程度に大きな数値を設定します。
resize	追加または必要に応じて要素の消去は、文字列の新しいサイズを指定します。
rfind	文字列は、逆方向の指定した一連の文字に一致する部分文字列の最初の位置を検索します。
shrink_to_fit	文字列の余分な容量を破棄します。
size	要素の現在の数を文字列で返します。
substr	多くていくつかの文字の部分文字列から、文字列の先頭の指定した位置からにコピーします。
スワップ	2 つの文字列の内容を交換します。

演算子

演算子 + =	文字列に文字を追加します。
operator=	文字列の内容を新しい文字の値を割り当てます。
operator[]	文字への参照は、文字列内の指定したインデックスを提供します。

必要条件

ヘッダー: <string>

名前空間: std

参照

その他の技術情報

basic_string メンバー

<string> メンバー

次の方法で共有