basic_string::operator

Zawiera odwołanie do znaku o określonym indeksie w ciągu.

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

Parametry

• _Off
  Indeks pozycji elementu, który ma się odwoływać.

Wartość zwracana

Odwołanie do znaku ciągu w pozycji określonej przez parametr indeksu.

Uwagi

Pierwszy element w ciągu ma indeks równy zero, a następujące elementy są indeksowane kolejno przez dodatnich liczb całkowitych, tak aby ciąg o długości n ma nth element indeks z numerem n - 1.

**operator[]**jest szybsze niż funkcji członka w za dostarczanie odczytu i zapisu do elementów ciąg.

**operator[]**nie sprawdza, czy indeks przekazywana jako parametr jest prawidłowy, ale funkcji członka w , a więc powinien być używany w ważność nie jest pewne.Nieprawidłowy indeks (indeks mniejszej od zera lub większa niż lub równa rozmiarowi ciągu) przekazany do funkcji członka w wyrzuca out_of_range klasy wyjątek.Nieprawidłowy indeks przekazany do operator[] skutkuje niezdefiniowane zachowanie, ale indeks równa długość ciągu jest prawidłowym indeksem const ciągi i operator zwraca znak null przekazano tego indeksu.

Zwracane odwołanie może unieważnione przez ciąg przeniesieniom lub modyfikacji dla non -const ciągów.

Podczas kompilowania z _SECURE_SCL 1, błąd wykonania nastąpi próba uzyskania dostępu do elementu poza granicami ciąg. Aby uzyskać więcej informacji, zobacz Zaznaczone iteratory.

Przykład

// 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;
}

Dane wyjściowe

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.

Wymagania

Nagłówek: <ciąg>

Przestrzeń nazw: std

Zobacz też

Informacje

basic_string — Klasa