Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C

wcrtomb — pretvorba širokog znaka u višebajtni niz

wcrtomb kodira jedan wchar_t prema LC_CTYPE i čuva stanje pretvorbe u mbstate_t.

Verzija: 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 zapisuje wc prema LC_CTYPE; rezultat nije nužno UTF-8. Međuspremnik mora moći primiti MB_CUR_MAX bajtova; MB_LEN_MAX dovoljan je za bilo koji locale.

Inicijalizirajte mbstate_t s {0} i čuvajte stanje između znakova. Ako je ps == NULL, koristi se interno stanje.

Vraćena vrijednost označava broj zapisanih bajtova, uključujući nizove za promjenu stanja. U slučaju pogreške funkcija vraća (size_t)-1, postavlja errno na EILSEQ i ostavlja stanje nedefiniranim.

L'\0' zapisuje nulti bajt i vraća početno stanje. Ostali znakovi ne dodaju završni znak. Ako je s == NULL, wc se zanemaruje: L'\0' pretvara se u interni međuspremnik, umjesto da se mjeri duljina.

Primjeri

#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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori