Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

wcrtomb — converter um carácter largo numa sequência multibyte

wcrtomb codifica um wchar_t de acordo com LC_CTYPE e preserva o estado de conversão em mbstate_t.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

wcrtomb escreve wc de acordo com LC_CTYPE; o resultado não é necessariamente UTF-8. O buffer tem de comportar MB_CUR_MAX bytes; MB_LEN_MAX é suficiente para qualquer locale.

Inicialize mbstate_t com {0} e mantenha o estado entre caracteres. Se ps == NULL, é utilizado um estado interno.

O valor devolvido indica o número de bytes escritos, incluindo sequências de mudança de estado. Em caso de erro, a função devolve (size_t)-1, define errno como EILSEQ e deixa o estado indeterminado.

L'\0' escreve um byte nulo e repõe o estado inicial. Os outros caracteres não acrescentam um terminador. Se s == NULL, wc é ignorado: L'\0' é convertido para um buffer interno, em vez de se medir o comprimento.

Exemplos

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

Resultado

bytes=1, matches=1

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes