Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

wcrtomb — pretvorba širokega znaka v večbajtno zaporedje

wcrtomb kodira en wchar_t glede na LC_CTYPE in ohranja stanje pretvorbe v mbstate_t.

Različica: C23; repository compiler flag, production runtime not attested

Sintaksa

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

wcrtomb zapiše wc glede na LC_CTYPE; rezultat ni nujno UTF-8. Medpomnilnik mora sprejeti MB_CUR_MAX bajtov; MB_LEN_MAX zadostuje za kateri koli locale.

mbstate_t inicializirajte z {0} in ohranjajte stanje med znaki. Če je ps == NULL, se uporabi notranje stanje.

Vrnjena vrednost označuje število zapisanih bajtov, vključno z zaporedji za spremembo stanja. Ob napaki funkcija vrne (size_t)-1, nastavi errno na EILSEQ in pusti stanje nedoločeno.

L'\0' zapiše ničelni bajt in obnovi začetno stanje. Drugi znaki ne dodajo zaključnega znaka. Če je s == NULL, se wc prezre: L'\0' se pretvori v notranji medpomnilnik, namesto da bi se izmerila dolžina.

Primeri

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

Rezultat

bytes=1, matches=1

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri