basic_string::operator

文字列の指定したインデックス位置に文字への参照を提供します。

const_reference operator[](
   size_type _Off
) const;
reference operator[](
   size_type _Off
);

パラメーター

• _Off
  参照する要素の位置のインデックス。

戻り値

パラメーターのインデックスで指定された位置にある文字列内の文字への参照。

解説

文字列の最初の要素のインデックスにゼロがあり、次の要素が、正の整数 n 長さの文字列に数値 n ~ 1. でインデックスされる n 番目の要素と同様、継続的に送信されます。

operator[] を読み取る提供および文字列の要素への書き込みアクセスのメンバー関数 場所: 高速です。

operator[]、パラメーターとして渡されるインデックスが、メンバー関数は 場所: ため、有効ではありません。を使用する必要があるかどうかはチェックされません。メンバー関数に渡される 場所: 無効なインデックス (低いインデックスは、以上で文字列のサイズが大きくする out_of_range のクラス 0 (ゼロ) の例外をスローします。無効なインデックスは operator[] に未定義の動作が渡されましたが、文字列の長さと等しいインデックスは const 文字列の有効なインデックスであり、このインデックスを渡すと演算子は null 文字を返します。

返される参照は**[const]** の文字列以外の文字列の再割り当てと変更によって無効になることがあります。

_SECURE_SCL 1 でコンパイルする場合は、ランタイム エラーは、文字列の範囲外の要素にアクセスしようとすると発生します。詳細については、「チェックを行う反復子」を参照してください。

使用例

// basic_string_op_ref.cpp
// compile with: /EHsc
#include <string>
#include <iostream>

int main( )
{
   using namespace std;
   string str1 ( "Hello world" ), str2 ( "Goodbye world" );
   const string cstr1 ( "Hello there" ), cstr2 ( "Goodbye now" );
   cout << "The original string str1 is: " << str1 << endl;
   cout << "The original string str2 is: " << str2 << endl;

   // Element access to the non-const strings
   basic_string <char>::reference refStr1 = str1 [6];
   basic_string <char>::reference refStr2 = str2.at ( 3 );

   cout << "The character with an index of 6 in string str1 is: "
        << refStr1 << "." << endl;
   cout << "The character with an index of 3 in string str2 is: "
        << refStr2 << "." << endl;

   // Element access to the const strings
   basic_string <char>::const_reference crefStr1 = cstr1 [ cstr1.length ( ) ];
   basic_string <char>::const_reference crefStr2 = cstr2.at ( 8 );

   if ( crefStr1 == '\0' )
      cout << "The null character is returned as a valid reference."
           << endl;
   else
      cout << "The null character is not returned." << endl;
   cout << "The character with index of 8 in the const string cstr2 is: "
        << crefStr2 << "." << endl;
}

出力

The original string str1 is: Hello world
The original string str2 is: Goodbye world
The character with an index of 6 in string str1 is: w.
The character with an index of 3 in string str2 is: d.
The null character is returned as a valid reference.
The character with index of 8 in the const string cstr2 is: n.

必要条件

ヘッダー: <string>

名前空間: std

参照

関連項目

basic_string Class