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.