std:: mbrtoc8

헤더 파일에 정의됨 <cuchar>
std:: size_t mbrtoc8 ( char8_t * pc8, const char * s, std:: size_t n, std:: mbstate_t * ps ) ;		(C++20부터)

좁은 멀티바이트 문자를 UTF-8 인코딩으로 변환합니다.

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

멀티바이트 문자의 UTF-8 인코딩이 * s 에서 하나 이상의 UTF-8 코드 유닛으로 구성된 경우, 이 함수의 첫 번째 호출 후 * ps 는 mbrtoc8 의 다음 호출이 * s 를 고려하지 않고 추가 UTF-8 코드 유닛을 기록하도록 업데이트됩니다.

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

생성된 UTF-8 코드 유닛이 u8 ' \0 ' 인 경우, 변환 상태 * ps 는 초기 시프트 상태를 나타냅니다.

이 함수가 사용하는 멀티바이트 인코딩은 현재 활성화된 C 로캘에 의해 지정됩니다.

목차 1 매개변수 2 반환 값 3 예제 4 참고 항목

매개변수

pc8	-	결과 UTF-8 코드 단위가 기록될 위치에 대한 포인터
s	-	입력으로 사용되는 멀티바이트 문자 문자열에 대한 포인터
n	-	검사할 수 있는 s의 바이트 수 제한
ps	-	멀티바이트 문자열을 해석할 때 사용되는 변환 상태 객체에 대한 포인터

반환값

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

• ​ 0 ​ s 에서 변환된 문자(그리고 null이 아닌 경우 * pc8 에 저장된)가 null 문자인 경우.
• s 에서 성공적으로 변환된 멀티바이트 문자의 바이트 수 [ 1 ... n ] .
• static_cast < std:: size_t > ( - 3 ) 여러 코드 유닛으로 구성된 인코딩을 가진 문자로부터 다음 UTF-8 코드 유닛이 * pc8 에 기록된 경우. 이 경우 입력으로부터 어떤 바이트도 처리되지 않습니다.
• static_cast < std:: size_t > ( - 2 ) 다음 n 바이트가 불완전하지만 지금까지는 유효한 멀티바이트 문자를 구성하는 경우. * pc8 에는 아무것도 기록되지 않습니다.
• static_cast < std:: size_t > ( - 1 ) 인코딩 오류가 발생한 경우. * pc8 에는 아무것도 기록되지 않으며, EILSEQ 값이 errno 에 저장되고, * ps 의 값은 지정되지 않습니다.

예제

이 섹션은 불완전합니다 이유: 예제 없음

참고 항목

c8rtomb (C++20)	UTF-8 문자열을 좁은 멀티바이트 인코딩으로 변환 (함수)
mbrtoc16 (C++11)	좁은 멀티바이트 문자를 UTF-16 인코딩으로 변환 (함수)
C documentation for mbrtoc8