basic_string::assign
文字列の内容に新しい文字の値を割り当てます。
basic_string<CharType, Traits, Allocator>& assign(
const value_type* _Ptr
);
basic_string<CharType, Traits, Allocator>& assign(
const value_type* _Ptr,
size_type _Count
);
basic_string<CharType, Traits, Allocator>& assign(
const basic_string<CharType, Traits, Allocator>& _Str,
size_type off,
size_type _Count
);
basic_string<CharType, Traits, Allocator>& assign(
const basic_string<CharType, Traits, Allocator>& _Str
);
basic_string<CharType, Traits, Allocator>& assign(
size_type _Count,
value_type _Ch
);
template<class InIt>
basic_string<CharType, Traits, Allocator>& assign(
InputIterator _First,
InputIterator _Last
);
basic_string<CharType, Traits, Allocator>& assign(
const_pointer _First,
const_pointer _Last
);
basic_string<CharType, Traits, Allocator>& assign(
const_iterator _First,
const_iterator _Last
);
パラメーター
_Ptr
対象文字列に割り当てる C 文字列内の文字へのポインター。_Count
元の文字列で、最大で、追加する文字数。_Str
文字は、対象の文字列に割り当てられたソース文字列。_Ch
割り当てる文字値。_First
対象範囲に割り当てるソース文字列の最初の文字の範囲を指定する入力反復子、const_pointer、または const_iterator。_Last
対象範囲に割り当てるソース文字列の範囲の最後の文字を超えて 1 をアドレス指定する入力反復子、const_pointer、または const_iterator。off
新しい文字が割り当てられ開始位置。
戻り値
メンバー関数によって新しい文字が割り当てられている文字列オブジェクトへの参照。
解説
文字列の新しい値を割り当てることができます。 新しい値は、C 文字列または単一文字のいずれかです。 operator= は新しい値が単一のパラメーターで記述できる場合に使用される可能性がある; 文字列内の部分文字列は対象に割り当てるかを指定するために、複数のパラメーターを持つメンバー関数 割り当てを使用できます。
使用例
// basic_string_assign.cpp
// compile with: /EHsc
#include <string>
#include <iostream>
int main( )
{
using namespace std;
// The first member function assigning the
// characters of a C-string to a string
string str1a;
const char *cstr1a = "Out There";
cout << "The C-string cstr1a is: " << cstr1a << "." << endl;
str1a.assign ( cstr1a );
cout << "Assigning the C-string cstr1a to string str1 gives: "
<< str1a << "." << endl << endl;
// The second member function assigning a specific
// number of the of characters a C-string to a string
string str1b;
const char *cstr1b = "Out There";
cout << "The C-string cstr1b is: " << cstr1b << endl;
str1b.assign ( cstr1b , 3 );
cout << "Assigning the 1st part of the C-string cstr1b "
<< "to string str1 gives: " << str1b << "."
<< endl << endl;
// The third member function assigning a specific number
// of the characters from one string to another string
string str1c ( "Hello " ), str2c ( "Wide World " );
cout << "The string str2c is: " << str2c << endl;
str1c.assign ( str2c , 5 , 5 );
cout << "The newly assigned string str1 is: "
<< str1c << "." << endl << endl;
// The fourth member function assigning the characters
// from one string to another string in two equivalent
// ways, comparing the assign and operator =
string str1d ( "Hello" ), str2d ( "Wide" ), str3d ( "World" );
cout << "The original string str1 is: " << str1d << "." << endl;
cout << "The string str2d is: " << str2d << endl;
str1d.assign ( str2d );
cout << "The string str1 newly assigned with string str2d is: "
<< str1d << "." << endl;
cout << "The string str3d is: " << str3d << "." << endl;
str1d = str3d;
cout << "The string str1 reassigned with string str3d is: "
<< str1d << "." << endl << endl;
// The fifth member function assigning a specific
// number of characters of a certain value to a string
string str1e ( "Hello " );
str1e.assign ( 4 , '!' );
cout << "The string str1 assigned with eclamations is: "
<< str1e << endl << endl;
// The sixth member function assigning the value from
// the range of one string to another string
string str1f ( "Hello " ), str2f ( "Wide World " );
cout << "The string str2f is: " << str2f << endl;
str1f.assign ( str2f.begin ( ) + 5 , str2f.end ( ) - 1 );
cout << "The string str1 assigned a range of string str2f is: "
<< str1f << "." << endl << endl;
}
必要条件
ヘッダー: の <文字列>
名前空間: std