_mbsnbset_s, _mbsnbset_s_l

멀티바이트 문자열의 첫 번째 n 바이트 값을 지정된 문자로 설정합니다. 이러한 버전은 CRT의 _mbsnbset_l_mbsnbset 보안 기능에 설명된 대로 향상된 보안 기능을 제공합니다.

Important

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

구문

errno_t _mbsnbset_s(
   unsigned char *str,
   size_t size,
   unsigned int c,
   size_t count
);
errno_t _mbsnbset_s_l(
   unsigned char *str,
   size_t size,
   unsigned int c,
   size_t count,
   _locale_t locale
);
template <size_t size>
errno_t _mbsnbset_s(
   unsigned char (&str)[size],
   unsigned int c,
   size_t count
); // C++ only
template <size_t size>
errno_t _mbsnbset_s_l(
   unsigned char (&str)[size],
   unsigned int c,
   size_t count,
   _locale_t locale
); // C++ only

매개 변수

str
변경할 문자열입니다.

size
문자열 버퍼의 크기입니다.

c
단일 바이트나 멀티바이트 문자 설정입니다.

count
설정할 바이트 수입니다.

locale
사용할 로캘입니다.

반환 값

성공하면 0이고, 그렇지 않으면 오류 코드입니다.

설명

_mbsnbset_s 및 _mbsnbset_s_l 함수는 최대한 str의 처음 count바이트를 c로 설정합니다. count가 str의 길이보다 큰 경우 str의 길이가 count 대신 사용됩니다. 멀티바이트 문자이고 지정된 마지막 바이트count로 완전히 설정할 수 없는 경우 c 마지막 바이트는 빈 문자로 채워집니다. _mbsnbset_s 종료 _mbsnbset_s_l null을 끝에 str배치하지 마세요.

_mbsnbset_s 및 _mbsnbset_s_l은 c의 count 문자가 아니라 count바이트를 설정한다는 점을 제외하고는 _mbsnset와 유사합니다.

이 함수가 0이거나 count 0이면 str 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 예외가 생성됩니다.NULL 계속해서 실행하도록 허용된 경우 errno 는 EINVAL 로 설정되고 함수에서 NULL버전입니다. 또한 유효한 멀티바이트 문자가 아닌 경우 c 해당 문자 errno 로 EINVAL 설정되고 공백이 대신 사용됩니다.

출력 값은 로캘의 LC_CTYPE 범주 설정 설정의 영향을 받습니다. 자세한 내용은 setlocale를 참조하세요. _mbsnbset_s 버전의 이 함수 이 로캘 종속 동작의 현재 로캘을 사용하고 _mbsnbset_s_l 버전은 전달된 로캘 매개 변수를 사용한다는 점을 제외하고는 동일합니다. 자세한 내용은 Locale을 참조하세요.

C++에서는 템플릿 오버로드를 통해 이러한 함수를 사용하는 것이 보다 간단해집니다. 오버로드는 버퍼 길이를 자동으로 유추할 수 있으므로 크기 인수를 지정할 필요가 없습니다. 자세한 내용은 보안 템플릿 오버로드를 참조 하세요.

이러한 함수의 디버그 라이브러리 버전은 먼저 버퍼를 0xFE 채웁니다. 이 동작을 사용하지 않도록 설정하려면 .를 사용합니다 _CrtSetDebugFillThreshold.

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

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 정의 _MBCS 되지 않음	_MBCS 정의	_UNICODE 정의
_tcsnset_s	_strnset_s	_mbsnbset_s	_wcsnset_s
_tcsnset_s_l	_strnset_s _l	_mbsnbset_s_l	_wcsnset_s_l

요구 사항

루틴에서 반환된 값	필수 헤더
_mbsnbset_s	<mbstring.h>
_mbsnbset_s_l	<mbstring.h>

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

예시

// crt_mbsnbset_s.c
#include <mbstring.h>
#include <stdio.h>

int main( void )
{
   char string[15] = "This is a test";
   /* Set not more than 4 bytes of string to be *'s */
   printf( "Before: %s\n", string );
   _mbsnbset_s( string, sizeof(string), '*', 4 );
   printf( "After:  %s\n", string );
}

출력

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

참고 항목

문자열 조작
_mbsnbcat, _mbsnbcat_l
_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l
_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l