Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

wcrtomb — convertire un carattere wide in una sequenza multibyte

wcrtomb codifica un wchar_t secondo LC_CTYPE e conserva lo stato di conversione in mbstate_t.

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

Sintassi

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

wcrtomb scrive wc secondo LC_CTYPE; il risultato non è necessariamente UTF-8. Il buffer deve poter contenere MB_CUR_MAX byte; MB_LEN_MAX è sufficiente per qualsiasi locale.

Inizializza mbstate_t con {0} e conserva lo stato tra i caratteri. Se ps == NULL, viene usato uno stato interno.

Il valore restituito indica il numero di byte scritti, incluse le sequenze di cambiamento di stato. In caso di errore, la funzione restituisce (size_t)-1, imposta errno a EILSEQ e lascia lo stato non specificato.

L'\0' scrive un byte nullo e ripristina lo stato iniziale. Gli altri caratteri non aggiungono un terminatore. Se s == NULL, wc viene ignorato: L'\0' viene convertito in un buffer interno invece di misurare la lunghezza.

Esempi

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

Risultato

bytes=1, matches=1

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti