다음을 통해 공유

_strset, _strset_l, _wcsset, _wcsset_l, _mbsset_mbsset_l

  • 아티클

문자열의 문자를 특정 문자로 설정합니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. _strset_s, _strset_s_l, _wcsset_s, _wcsset_s_l, _mbsset_s, _mbsset_s_l을 참조하세요.

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbsset 및 _mbsset_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 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 함수는 종료 null 문자를 제외한 str의 모든 문자를 char로 변환된 c로 설정합니다. _wcsset 및 _mbsset_l은 _strset의 와이드 문자 및 멀티바이트 문자 버전이며, 인수 및 반환 값의 데이터 형식은 버전에 따라 다릅니다. 그 외의 경우에는 이들 함수가 동일하게 작동합니다.

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

출력 값은 로캘의 LC_CTYPE 범주 설정에 영향을 받습니다. 자세한 내용은 setlocale를 참조하세요. _l 접미사가 없는 함수는 현재 로캘을 사용하고 _l 접미사가 있는 함수는 전달된 로캘 매개 변수를 대신 사용한다는 점을 제외하고 이러한 함수의 버전은 동일합니다. 자세한 내용은 Locale을 참조하세요.

Important

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

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

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 );
}

Before: Fill the string with something.
After:  *******************************

참고 항목

문자열 조작
Locale
멀티바이트 문자 시퀀스 해석
_mbsnbset, _mbsnbset_l
memset, wmemset
strcat, , wcscat_mbscat
strcmp, , wcscmp_mbscmp
strcpy, , wcscpy_mbscpy
_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset_mbsnset_l