_mbsnbset_s, _mbsnbset_s_l

아티클
06/09/2015

처음은 n 지정된 문자를 멀티 바이트 문자 문자열의 바이트를 설정하세요. 이러한 버전의 _mbsnbset, _mbsnbset_l에는 CRT의 보안 기능에 설명된 대로 보안 향상 기능이 포함됩니다.

중요

이 API는 Windows 런타임에서 실행되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /ZW에서 지원하지 않는 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 함수는 c 에서 str 의 첫 count 바이트를 설정합니다. count 이 str 의 길이보다 큰 경우, count 대신에 str 이 사용됩니다. c가 멀티바이트 문자이고 count에 의해 지정된 마지막 바이트로 전부 설정될 수 없는 경우, 마지막 바이트는 공백 문자를 사용하여 패딩됩니다. _mbsnbset_s 및 _mbsnbset_s_l는 종료 null을 str의 끝에 놓지 않습니다.

_mbsnbset_s 및 _mbsnbset_s_l는 그들이 c의 count 문자보다 count 바이트를 설정한다는 것을 제외하고 _mbsnset과 비슷합니다.

만약 str가 NULL 또는 count이 0인 경우, 이 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 예외를 생성합니다. 계속해서 실행하도록 허용된 경우, 이러한 함수는 errno 를 EINVAL 로 설정하고 NULL을 반환합니다. 또한, c 이 유효한 멀티 바이트 문자가 아닌 경우, errno 은 EINVAL 으로 설정하고 공백은 대신 사용됩니다.

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

C++에서, 이러한 함수를 사용하는 것은 템플릿 오버로드에 의해 단순화됩니다. 오버로드는 자동으로 버퍼의 길이를 추정할 수 있고, 크기 인수를 지정할 필요를 없앱니다. 자세한 내용은 안전한 템플릿 오버로드을 참조하십시오.

이러한 함수의 디버그 버전은 우선 0xFD로 버퍼를 채웁니다. 이 동작을 사용하지 않으려면 _CrtSetDebugFillThreshold를 사용하십시오.

제네릭 텍스트 라우팅 매핑

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