Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

wcrtomb — konwersja znaku szerokiego na wielobajtowy

wcrtomb koduje jeden wchar_t zgodnie z LC_CTYPE, zachowując stan konwersji w mbstate_t.

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <wchar.h>
size_t wcrtomb(char * restrict s, wchar_t wc, mbstate_t * restrict ps);

wcrtomb zapisuje reprezentację wc zgodną z LC_CTYPE, niekoniecznie UTF-8. Bufor musi pomieścić MB_CUR_MAX bajtów; MB_LEN_MAX wystarcza dla dowolnego locale.

Zainicjalizuj mbstate_t przez {0} i zachowuj stan między znakami. ps == NULL wybiera stan wewnętrzny.

Wynik to liczba zapisanych bajtów, łącznie z sekwencjami przesunięcia. Błąd zwraca (size_t)-1, ustawia errno na EILSEQ i pozostawia stan nieokreślony.

L'\0' zapisuje bajt zerowy i przywraca stan początkowy. Inne znaki nie dodają terminatora. s == NULL ignoruje wc: działa jak konwersja L'\0' do bufora wewnętrznego, nie jak pomiar długości.

Przykłady

#include <limits.h>
#include <locale.h>
#include <stdio.h>
#include <wchar.h>

int main(void)
{
    if (setlocale(LC_CTYPE, "C") == NULL)
        return 1;

    mbstate_t state = {0};
    char buffer[MB_LEN_MAX];
    size_t n = wcrtomb(buffer, L'A', &state);
    if (n == (size_t)-1)
        return 1;
    printf("bytes=%zu, matches=%d\n", n,
           n == 1 && buffer[0] == 'A');
    return 0;
}

Wynik

bytes=1, matches=1

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła