basic_string::end

傳回處理成功最後一個項目的位置在字串的 Iterator。

const_iterator end( ) const;
iterator end( );

傳回值

傳回處理成功最後一個項目的位置在字串的隨機存取 Iterator。

備註

end 通常用於測試 Iterator 是否已到達字串的結尾。 不應該取值 end 傳回的值。

如果 end 的傳回值指派給 const_iterator，無法修改字串物件。 如果 end 的傳回值指派給 iterator，可以修改字串物件。

範例

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

int main( ) 
{
   using namespace std;
   string str1 ( "No way out." ), str2;
   basic_string <char>::iterator str_Iter, str1_Iter, str2_Iter;
   basic_string <char>::const_iterator str1_cIter;

   str1_Iter = str1.end ( );
   str1_Iter--;
   str1_Iter--;
   cout << "The last character-letter of the string str1 is: " << *str1_Iter << endl;
   cout << "The full orginal string str1 is: " << str1 << endl;

   // end used to test when an iterator has reached the end of its string
   cout << "The string is now: ";
   for ( str_Iter = str1.begin( ); str_Iter != str1.end( ); str_Iter++ )
      cout << *str_Iter;
   cout << endl;

   // The dereferenced iterator can be used to modify a character
    *str1_Iter = 'T';
   cout << "The last character-letter of the modified str1 is now: "
        << *str1_Iter << endl;
   cout << "The modified string str1 is now: " << str1 << endl;

   // The following line would be an error because iterator is const
   // *str1_cIter = 'T';

   // For an empty string, end is equivalent to begin
   if ( str2.begin( ) == str2.end ( ) )
      cout << "The string str2 is empty." << endl;
   else
      cout << "The stringstr2  is not empty." << endl;
}

需求

標題: <string>

命名空間: std

請參閱

參考

basic_string Class