char_traits::assign
Assigns one character value to another or to a range of elements in a string.
static void assign(
char_type& _CharTo,
const char_type& _CharFrom
);
static char_type *assign(
char_type* _StrTo,
size_t _Num,
char_type _CharFrom
);
Parameters
**_**CharFrom
The character whose value is to be assigned._CharTo
The element that is to be assigned the character value._StrTo
The string or character array whose initial elements are to be assigned character values._Num
The number of elements that are going to be assigned values.
Return Value
The second member function returns a pointer to the string whose first _Num elements have been assigned values of _CharFrom.
Example
// char_traits_assign.cpp
// compile with: /EHsc
#include <string>
#include <iostream>
int main( )
{
using namespace std;
// The first member function assigning
// one character value to another character
char ChTo = 't';
const char ChFrom = 'f';
cout << "The initial characters ( ChTo , ChFrom ) are: ( "
<< ChTo << " , " << ChFrom << " )." << endl;
char_traits<char>::assign ( ChTo , ChFrom );
cout << "After assigning, the characters ( ChTo , ChFrom ) are: ( "
<< ChTo << " , " << ChFrom << " )." << endl << endl;
// The second member function assigning
// character values to initial part of a string
char_traits<char>::char_type s1[] = "abcd-1234-abcd";
char_traits<char>::char_type* result1;
cout << "The target string s1 is: " << s1 << endl;
result1 = char_traits<char>::assign ( s1 , 4 , 'f' );
cout << "The result1 = assign ( s1 , 4 , 'f' ) is: "
<< result1 << endl;
}
The initial characters ( ChTo , ChFrom ) are: ( t , f ).
After assigning, the characters ( ChTo , ChFrom ) are: ( f , f ).
The target string s1 is: abcd-1234-abcd
The result1 = assign ( s1 , 4 , 'f' ) is: ffff-1234-abcd
Requirements
Header: <string>
Namespace: std