_strset, _wcsset, _mbsset
Set characters of a string to a character.
char*_strset(char*string,intc**);**
wchar_t*_wcsset(wchar_t*string,wchar_tc**);**
unsignedchar*_mbsset(unsignedchar*string,unsignedintc**);**
| Routine | Required Header | Compatibility |
| _strset | <string.h> | Win 95, Win NT |
| _wcsset | <string.h> or <wchar.h> | Win 95, Win NT |
| _mbsset | <mbstring.h> | Win 95, Win NT |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
| LIBC.LIB | Single thread static library, retail version |
| LIBCMT.LIB | Multithread static library, retail version |
| MSVCRT.LIB | Import library for MSVCRT.DLL, retail version |
Return Value
Each of these functions returns a pointer to the altered string. No return value is reserved to indicate an error.
Parameters
string
Null-terminated string to be set
c
Character setting
Remarks
The _strset function sets all the characters of string to c (converted to char), except the terminating null character. _wcsset and _mbsset are wide-character and multibyte-character versions of _strset. The data types of the arguments and return values vary accordingly. These three functions behave identically otherwise.
Generic-Text Routine Mappings
| TCHAR.H Routine | _UNICODE & _MBCS Not Defined | _MBCS Defined | _UNICODE Defined |
| _tcsset | _strset | _mbsset | _wcsset |
Example
/* STRSET.C */
#include <string.h>
#include <stdio.h>
void main( void )
{
char string[] = "Fill the string with something";
printf( "Before: %s\n", string );
_strset( string, '*' );
printf( "After: %s\n", string );
}
Output
Before: Fill the string with something
After: ******************************
See Also _mbsnbset, memset, strcat, strcmp, strcpy, _strnset