다음을 통해 공유

_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset_mbsnset_l

  • 아티클

문자열의 문자를 지정된 문자로 초기화합니다. 이러한 함수의 더 안전한 버전이 있습니다. 참조 _strnset_s, _strnset_s_l, _wcsnset_s, _wcsnset_s_l_mbsnset_s, _mbsnset_s_l.

Important

Windows 런타임에서 실행되는 애플리케이션에서는 _mbsnset 및 _mbsnset_l을 사용할 수는 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

char *_strnset(
   char *str,
   int c,
   size_t count
);
char *_strnset_l(
   char *str,
   int c,
   size_t count,
   _locale_t locale
);
wchar_t *_wcsnset(
   wchar_t *str,
   wchar_t c,
   size_t count
);
wchar_t *_wcsnset_l(
   wchar_t *str,
   wchar_t c,
   size_t count,
   _locale_t locale
);
unsigned char *_mbsnset(
   unsigned char *str,
   unsigned int c,
   size_t count
);
unsigned char *_mbsnset_l(
   unsigned char *str,
   unsigned int c,
   size_t count,
   _locale_t locale
);

매개 변수

str
변경할 문자열입니다.

c
문자 설정입니다.

count
설정할 문자의 수입니다.

locale
사용할 로캘입니다.

반환 값

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

설명

_strnset 함수는 str의 최대 첫 count자를 char로 변환된 c로 설정합니다. count가 str의 길이보다 큰 경우 str의 길이가 count 대신 사용됩니다.

_wcsnset 및 _mbsnset는 _strnset의 와이드 문자 및 멀티바이트 문자 버전입니다. _wcsnset의 문자열 인수와 반환 값은 와이드 문자 문자열입니다. _mbsnset의 문자열 인수와 반환 값은 멀티바이트 문자 문자열입니다. 그렇지 않으면 이들 세 함수는 동일하게 작동합니다.

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

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

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

일반 텍스트 루틴 매핑

TCHAR.H 루틴 _UNICODE 및 _MBCS 정의되지 않음 정의된 _MBCS 정의된 _UNICODE
_tcsnset _strnset _mbsnbset _wcsnset
_tcsnset_l _strnset_l _mbsnbset_l _wcsnset_l

요구 사항

루틴에서 반환된 값 필수 헤더
_strnset <string.h>
_strnset_l <tchar.h>
_wcsnset <string.h> 또는 <wchar.h>
_wcsnset_l <tchar.h>
_mbsnset, _mbsnset_l <mbstring.h>

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

예시

// crt_strnset.c
// compile with: /W3
#include <string.h>
#include <stdio.h>

int main( void )
{
   char string[15] = "This is a test";
   /* Set not more than 4 characters of string to be *'s */
   printf( "Before: %s\n", string );
   _strnset( string, '*', 4 ); // C4996
   // Note: _strnset is deprecated; consider using _strnset_s
   printf( "After:  %s\n", string );
}

Before: This is a test
After:  **** is a test

참고 항목

문자열 조작
Locale
멀티바이트 문자 시퀀스 해석
strcat, , wcscat_mbscat
strcmp, , wcscmp_mbscmp
strcpy, , wcscpy_mbscpy
_strset, _strset_l, _wcsset, _wcsset_l, _mbsset_mbsset_l