_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l

아티클
06/09/2015

문자에 문자열의 문자를 설정합니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l를 참조하십시오.

중요

_mbsset 와 _mbsset_l 는 Windows 런타임에 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 CRT 함수를 참조하십시오.

char *_strset(
   char *str,
   int c 
);
char *_strset_l(
   char *str,
   int c,
   locale_t locale
);
wchar_t *_wcsset(
   wchar_t *str,
   wchar_t c 
);
wchar_t *_wcsset_l(
   wchar_t *str,
   wchar_t c,
   locale_t locale
);
unsigned char *_mbsset(
   unsigned char *str,
   unsigned int c 
);
unsigned char *_mbsset_l(
   unsigned char *str,
   unsigned int c,
   _locale_t locale
);

매개 변수

str
설정할 Null 종료 문자열입니다.
c
문자 설정입니다.
locale
사용할 로캘입니다.

반환 값

변경된 문자열에 대한 포인터를 반환합니다.

설명

이 _strset 함수는 str 에서 ( char로 변환될) c 인 모든 문자로 설정합니다 (널 종료 문자 제외). _wcsset및 _mbsset_l 는 _strset 의 멀티 바이트 문자 또는 와이드 문자 버전입니다. 인수 및 반환 값의 데이터 형식에 따라 달라집니다. 그렇지 않다면 이러한 함수는 동일하게 작동합니다.

_mbsset 매개 변수의 유효성을 검사합니다. str 이 null 포인터인 경우, 설명된 매개 변수 유효성 검사 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우, _mbsset 는 NULL 을 반환하고, errno 에 EINVAL를 설정합니다. _strset 와 _wcsset 는 매개 변수를 확인 하지 않습니다.

출력 값은 로캘의 LC_CTYPE 범주 설정에 영향을 받습니다. 자세한 내용은 setlocale, _wsetlocale을 참조하십시오. _l 접미사가 없는 버전이 현재 로캘을 사용하거나 _l 접미사가 있는 버전이 전달된 로캘 매개 변수 대신일 경우를 제외하고는 해당 함수의 버전과 동일합니다. 자세한 내용은 로캘을 참조하십시오.

보안 정보
이러한 함수는 버퍼 오버런 위협에 노출될 수 있습니다.버퍼 오버런은 불필요한 권한 상승을 발생시킬 수 있으므로 시스템 공격에 사용될 수 있습니다.자세한 내용은 버퍼 오버런 방지를 참조하십시오.

제네릭 텍스트 라우팅 매핑

TCHAR.H 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_tcsset	_strset	_mbsset	_wcsset
_tcsset_l	_strset_l	_mbsset_l	_wcsset_l

요구 사항

루틴	필수 헤더
_strset	<string.h>
_strset_l	<tchar.h>
_wcsset	<string.h> 또는 <wchar.h>
_wcsset_l	<tchar.h>
_mbsset, _mbsset_l	<mbstring.h>

호환성에 대한 자세한 내용은 호환성을 참조하십시오.

예제

// crt_strset.c
// compile with: /W3

#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[] = "Fill the string with something.";
   printf( "Before: %s\n", string );
   _strset( string, '*' ); // C4996
   // Note: _strset is deprecated; consider using _strset_s instead
   printf( "After:  %s\n", string );
}