_mbsbtype, _mbsbtype_l
문자열 내에서 바이트의 형식을 반환합니다.
Important
이 API는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.
구문
int _mbsbtype(
const unsigned char *mbstr,
size_t count
);
int _mbsbtype_l(
const unsigned char *mbstr,
size_t count,
_locale_t locale
);
매개 변수
mbstr
멀티바이트 문자 시퀀스의 주소입니다.
count
문자열의 헤드로부터의 바이트 오프셋입니다.
locale
사용할 로캘입니다.
반환 값
_mbsbtype 지정된 _mbsbtype_l 바이트에 대한 테스트 결과를 나타내는 정수 값을 반환합니다. 다음 표의 매니페스트 상수는 Mbctype.h에 정의됩니다.
| 반환 값 | 바이트 형식 |
|---|---|
_MBC_SINGLE (0) |
싱글바이트 문자입니다. 예를 들어 코드 페이지 932 _mbsbtype 에서 지정된 바이트가 0x7E 또는 0xA1 0xDF 범위 0x20 내에 있으면 0을 반환합니다. |
_MBC_LEAD (1) |
멀티바이트 문자의 선행 바이트입니다. 예를 들어 코드 페이지 932 _mbsbtype 에서 지정된 바이트가 범위 0x81(0x9F 또는 0xE0 ) 0xFC 내에 있으면 1을 반환합니다. |
_MBC_TRAIL(2) |
멀티바이트 문자의 후행 바이트입니다. 예를 들어 코드 페이지 932 _mbsbtype 에서 지정된 바이트가 범위 0x40(0x7E 또는 0x80- 0xFC 내에 있으면 2를 반환합니다. |
_MBC_ILLEGAL (-1) |
NULL 에서 오프셋 count 의 바이트 앞에 있는 문자열, 잘못된 문자 또는 null 바이트입니다 mbstr. |
설명
_mbsbtype 함수는 멀티바이트 문자열에서 바이트 형식을 결정합니다. 이 함수는 mbstr에서 count 오프셋에 있는 바이트만 검사하여 지정된 바이트 앞에 있는 잘못된 문자를 무시합니다.
출력 값은 로캘의 LC_CTYPE 범주 설정에 영향을 받습니다. 자세한 내용은 setlocale를 참조하세요. _l 접미사가 없는 이러한 함수 버전은 이 로캘 종속 동작에 현재 로캘을 사용하고 _l 접미사가 있는 버전은 전달된 로캘 매개 변수를 대신 사용한다는 점을 제외하고는 동일합니다. 자세한 내용은 Locale을 참조하세요.
입력 문자열이NULL면 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우 errno 는 EINVAL 로 설정되고 함수에서 _MBC_ILLEGAL버전입니다.
기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT 전역 상태를 참조하세요.
요구 사항
| 루틴에서 반환된 값 | 필수 헤더 | 선택적 헤더 |
|---|---|---|
_mbsbtype |
<mbstring.h> | <mbctype.h>* |
_mbsbtype_l |
<mbstring.h> | <mbctype.h>* |
* 반환 값으로 사용되는 매니페스트 상수의 경우
호환성에 대한 자세한 내용은 호환성을 참조하세요.