Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

wcrtomb — prevod širokého znaku na multibajtovú sekvenciu

wcrtomb kóduje jeden wchar_t podľa LC_CTYPE a zachováva stav konverzie v mbstate_t.

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

Syntax

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

wcrtomb zapisuje wc podľa LC_CTYPE; výsledok nemusí byť UTF-8. Buffer musí pojať MB_CUR_MAX bajtov; MB_LEN_MAX stačí pre akékoľvek locale.

Inicializujte mbstate_t pomocou {0} a zachovávajte stav medzi znakmi. Ak je ps == NULL, použije sa interný stav.

Vrátená hodnota udáva počet zapísaných bajtov vrátane sekvencií zmeny stavu. Pri chybe funkcia vráti (size_t)-1, nastaví errno na EILSEQ a ponechá stav nešpecifikovaný.

L'\0' zapíše nulový bajt a obnoví počiatočný stav. Ostatné znaky nepridávajú ukončovací znak. Ak je s == NULL, wc sa ignoruje: L'\0' sa prevedie do interného buffera namiesto merania dĺžky.

Príklady

#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;
}

Výsledok

bytes=1, matches=1

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje