_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l

아티클
04/10/2013

문자 또는 제공 된 횟수 내에서 바이트의 수를 반환합니다.

중요
_mbsnbcnt_mbsnbcnt_l, _mbsnccnt, 및 _mbsnccnt_l Windows 런타임에서 실행 되는 응용 프로그램에서 사용할 수 없습니다.자세한 내용은 /zw에 지원 되는 CRT 함수.

size_t _strncnt(
   const char *str,
   size_t count
);
size_t _wcsncnt(
   const wchar_t *str,
   size_t count
);
size_t _mbsnbcnt(
   const unsigned char *str,
   size_t count 
);
size_t _mbsnbcnt_l(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);
size_t _mbsnccnt(
   const unsigned char *str,
   size_t count
);
size_t _mbsnccnt_l(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);

매개 변수

str
검사할 문자열입니다.
count
문자 또는 바이트를 검사할 str.
locale
사용 하는 로캘.

반환 값

_mbsnbcnt및 _mbsnbcnt_l 발견 되는 바이트 수를 반환 합니다. 첫 번째에서 count 의 멀티 바이트 문자 str._mbsnccnt및 _mbsnccnt_l 발견 되는 문자의 개수를 반환 합니다. 첫 번째에서 count 바이트의 str.NULL 문자를 검사 하기 전에 발생 한 경우 str 가 완료 되는 바이트 또는 문자 앞에 있는 NULL 문자를 찾을 수 반환 합니다.경우 str 미만 이루어진 count 문자 또는 바이트 수를 반환 한다는 점에서 문자 또는 바이트 수가 문자열의.경우 count 작으면 0 보다는 0을 반환 합니다.이전 버전에서는 이러한 함수 반환 값 형식의 했습니다 int 대신 size_t.

_strncnt첫 번째 문자의 개수를 반환 합니다. count 싱글바이트 문자열의 바이트 str._wcsncnt첫 번째 문자의 개수를 반환 합니다. count 와이드 문자를 와이드 문자 문자열의 str.

설명

_mbsnbcnt및 _mbsnbcnt_l 찾을 수 바이트의 개수를 계산 합니다. 첫 번째에서 count 의 멀티 바이트 문자 str._mbsnbcnt및 _mbsnbcnt_l 대체 mtob 대신 사용 해야 하 고 mtob.

_mbsnccnt및 _mbsnccnt_l 문자들의 개수를 계산 합니다. 첫 번째에서 count 바이트의 str.경우 _mbsnccnt 및 _mbsnccnt_l 더블 바이트 문자의 두 번째 바이트는 NULL이 발생 하는 경우 첫 번째 바이트 NULL로도 간주 되며 반환 되는 카운트 값에 포함 되지 않습니다._mbsnccnt및 _mbsnccnt_l 대체 btom 대신 사용 해야 하 고 btom.

경우 str null 포인터 또는 count 0 인 경우에 설명 된 대로 이러한 함수는 잘못 된 매개 변수 처리기를 호출 매개 변수 유효성 검사, errno 로 설정 된 EINVAL, 함수가 0을 반환 합니다.

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

일반 텍스트 루틴 매핑

루틴	_UNICODE 및 _mbcs가 정의 되어 있지 않습니다	_Mbcs가 정의	_Unicode가 정의
_tcsnbcnt	_strncnt	_mbsnbcnt	_wcsncnt
_tcsnccnt	_strncnt	_mbsnbcnt	n/a
_wcsncnt	n/a	n/a	_mbsnbcnt
_wcsncnt	n/a	n/a	_mbsnccnt
n/a	n/a	_mbsnbcnt_l	_mbsnccnt_l

요구 사항

루틴	필수 헤더
_mbsnbcnt	<mbstring.h>
_mbsnbcnt_l	<mbstring.h>
_mbsnccnt	<mbstring.h>
_mbsnccnt_l	<mbstring.h>
_strncnt	<tchar.h>
_wcsncnt	<tchar.h>

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

예제

// crt_mbsnbcnt.c

#include  <mbstring.h>
#include  <stdio.h>

int main( void )
{
   unsigned char str[] = "This is a multibyte-character string.";
   unsigned int char_count, byte_count;
   char_count = _mbsnccnt( str, 10 );
   byte_count = _mbsnbcnt( str, 10 );
   if ( byte_count - char_count )
      printf( "The first 10 characters contain %d multibyte characters\n", char_count );
   else
      printf( "The first 10 characters are single-byte.\n");
}

Output

The first 10 characters are single-byte.

해당 .NET Framework 항목

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

참고 항목

참조

문자열 조작 (CRT)

로캘

멀티 바이트 문자 시퀀스로 해석

_mbsnbcat, _mbsnbcat_l

다음을 통해 공유