Namespaces
Variants

std:: mbrtowc

From cppreference.net
C++
Text processing library
Null-terminated multibyte strings
헤더 파일에 정의됨 <cwchar>
std:: size_t mbrtowc ( wchar_t * pwc,

const char * s,
std:: size_t n,

std:: mbstate_t * ps ) ;

좁은 멀티바이트 문자를 와이드 문자로 변환합니다.

만약 s 가 null 포인터가 아니라면, 최대 n 바이트까지의 멀티바이트 문자 문자열을 검사하여( s 가 가리키는 바이트부터 시작) 다음 멀티바이트 문자를 완성하는 데 필요한 바이트 수를 결정합니다(시퀀스 전환 포함). 함수가 s 에 있는 다음 멀티바이트 문자가 완전하고 유효하다고 판단하면, 이를 해당 와이드 문자로 변환하여 * pwc 에 저장합니다( pwc 가 null이 아닌 경우).

만약 s 가 널 포인터라면, n 과 pwc 의 값은 무시되며, 이 호출은 std :: mbrtowc ( nullptr, "" , 1 , ps ) 와 동일합니다.

생성된 와이드 문자가 널 문자인 경우, * ps 에 저장된 변환 상태는 초기 시프트 상태입니다.

목차

매개변수

pwc - 결과로 생성될 와이드 문자가 기록될 위치에 대한 포인터
s - 입력으로 사용되는 멀티바이트 문자 문자열에 대한 포인터
n - 검사 가능한 s 내의 바이트 수 제한
ps - 멀티바이트 문자열을 해석할 때 사용되는 변환 상태에 대한 포인터

반환값

다음 중 먼저 적용되는 항목:

  • ​ 0 ​ s 에서 변환된 문자(그리고 null이 아닌 경우 pwc 에 저장된)가 null 문자인 경우.
  • [ 1 ... n ] s 에서 성공적으로 변환된 멀티바이트 문자의 바이트 수.
  • static_cast < std:: size_t > ( - 2 ) 다음 n 바이트가 불완전하지만 지금까지 유효한 멀티바이트 문자를 구성하는 경우. * pwc 에는 아무것도 기록되지 않음.
  • static_cast < std:: size_t > ( - 1 ) 인코딩 오류가 발생한 경우. * pwc 에는 아무것도 기록되지 않으며, EILSEQ 값이 errno 에 저장되고, * ps 의 값은 지정되지 않은 상태로 남음.

예제

이 코드 실행 
#include <clocale>
#include <cstring>
#include <cwchar>
#include <iostream>
void print_mb(const char* ptr)
{
    std::mbstate_t state = std::mbstate_t(); // 초기 상태
    const char* end = ptr + std::strlen(ptr);
    int len;
    wchar_t wc;
    while ((len = std::mbrtowc(&wc, ptr, end-ptr, &state)) > 0)
    {
        std::wcout << "다음 " << len << " 바이트는 문자 " << wc << '\n';
        ptr += len;
    }
}
int main()
{
    std::setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 좁은 멀티바이트 인코딩
    const char* str = "z\u00df\u6c34\U0001d10b"; // 또는 u8"zß水𝄋"
                      // 또는 "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";
    print_mb(str);
}

출력: 

다음 1 바이트는 문자 z
다음 2 바이트는 문자 ß
다음 3 바이트는 문자 水
다음 4 바이트는 문자 𝄋

참고 항목

다음 멀티바이트 문자를 와이드 문자로 변환
(함수)
주어진 상태로 와이드 문자를 멀티바이트 표현으로 변환
(함수)
[virtual]
ExternT 에서 InternT 로 문자열 변환 (예: 파일에서 읽을 때)
( std::codecvt<InternT,ExternT,StateT> 의 가상 protected 멤버 함수)
C documentation for mbrtowc