다음을 통해 공유


_mbsnbset, _mbsnbset_l

첫 번째 설정 n 는 지정 된 문자를 멀티 바이트 문자 문자열의 바이트 수입니다.보다 안전한 버전의이 함수를 사용할 수 있습니다. see _mbsnbset_s, _mbsnbset_s_l.

중요중요

이 API는 Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

unsigned char *_mbsnbset(
   unsigned char *str,
   unsigned int c,
   size_t count 
);
unsigned char *_mbsnbset_l(
   unsigned char *str,
   unsigned int c,
   size_t count,
   _locale_t locale
);

매개 변수

  • str
    변경 하려는 문자열입니다.

  • c
    싱글바이트 문자와 멀티 바이트 문자를 설정 합니다.

  • count
    설정 될 수 있는 바이트 수입니다.

  • locale
    사용 하는 로캘.

반환 값

_mbsnbset바뀐된 문자열에 대 한 포인터를 반환 합니다.

설명

_mbsnbset 및 _mbsnbset_l set 함수, 기껏해야 첫 번째 count 바이트의 str 에 c.경우 count 의 길이 보다 큰 경우 str, 길이 str 대신 사용 됩니다 count.경우 c 멀티 바이트 문자가 하 고 지정 된 마지막 바이트 전적으로 설정할 수 없습니다 count, 마지막 바이트 공백 문자로 채워집니다._mbsnbset및 _mbsnbset_l 종료를 배치 하지 마십시오 끝에 null str.

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

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

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

보안 참고 이 API 버퍼 오버런 문제에서 가져온에 대 한 잠재적인 위협을 초래 합니다.버퍼 오버런 문제는 자주 방법 시스템 공격에 불필요 한 권한 상승의 결과입니다.자세한 내용은 버퍼 오버런 방지.

일반 텍스트 루틴 매핑

Tchar.h 루틴

_UNICODE 및 _mbcs가 정의 되어 있지 않습니다

_Mbcs가 정의

_Unicode가 정의

_tcsnset

_strnset

_mbsnbset

_wcsnset

_tcsnset_l

_strnset_l

_mbsnbset_l

_wcsnset_l

요구 사항

루틴

필수 헤더

_mbsnbset

<mbstring.h>

_mbsnbset_l

<mbstring.h>

자세한 호환성에 대 한 내용은 호환성 소개에서 합니다.

예제

// crt_mbsnbset.c
// compile with: /W3
#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( string, '*', 4 ); // C4996
   // Note; _mbsnbset is deprecated; consider _mbsnbset_s
   printf( "After:  %s\n", string );
}

Output

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

해당 .NET Framework 항목

해당 사항 없음. 표준 C 함수를 호출 하려면 PInvoke. 자세한 내용은 플랫폼 호출 예제.

참고 항목

참조

문자열 조작 (CRT)

_mbsnbcat, _mbsnbcat_l

_strnset, _strnset_l, _wcsnset, _wcsnset_l, _mbsnset, _mbsnset_l

_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l