_mbsnbset_s, _mbsnbset_s_l

아티클
04/10/2013

첫 번째 설정 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 set 함수, 기껏해야 첫 번째 count 바이트의 str 에 c.경우 count 의 길이 보다 큰 경우 str, 길이 str 대신 사용 됩니다 count.경우 c 멀티 바이트 문자가 하 고 지정 된 마지막 바이트 전적으로 설정할 수 없습니다 count, 마지막 바이트 공백 문자로 채워집니다._mbsnbset_s및 _mbsnbset_s_l 를 종료 하는 대신 끝에 null str.

_mbsnbset_s및 _mbsnbset_s_l 유사 _mbsnset을 설정 하는 것을 제외 하 고 count 바이트 대신 count 자 c.

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

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

C + +에서이 함수 템플릿 오버 로드에 의해 단순화 됩니다. 오버 로드 버퍼 길이 자동으로 유추 하 고 있으므로 size 인수를 지정할 필요가 있습니다.자세한 내용은 보안 템플릿 오버 로드을 참조하십시오.

이러한 함수의 디버그 버전이 먼저 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 );
}