mbrtoc8

헤더 파일에 정의됨 <uchar.h>
size_t mbrtoc8 ( char8_t * restrict pc8, const char * restrict s, size_t n, mbstate_t * restrict ps ) ;		(C23부터)

좁은 멀티바이트 문자를 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 가 널 포인터인 경우, n 과 pc8 의 값은 무시되며, 이 호출은 mbrtoc8 ( nullptr, "" , 1 , ps ) 와 동일합니다.

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

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

목차 1 매개변수 2 반환 값 3 예제 4 참조 5 함께 보기

매개변수

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

반환값

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

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

예제

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

참고문헌

참고 항목

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