Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C

wcrtomb — convertir un carácter ancho a una secuencia multibyte

wcrtomb codifica un wchar_t según LC_CTYPE y conserva el estado de conversión en mbstate_t.

Versión: C23; repository compiler flag, production runtime not attested

Sintaxis

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

wcrtomb escribe wc según LC_CTYPE; el resultado no es necesariamente UTF-8. El búfer debe poder contener MB_CUR_MAX bytes; MB_LEN_MAX basta para cualquier locale.

Inicializa mbstate_t con {0} y conserva el estado entre caracteres. Si ps == NULL, se usa un estado interno.

El valor devuelto indica el número de bytes escritos, incluidas las secuencias de cambio de estado. Si se produce un error, devuelve (size_t)-1, establece errno en EILSEQ y deja el estado sin especificar.

L'\0' escribe un byte nulo y restaura el estado inicial. Los demás caracteres no añaden un terminador. Si s == NULL, se ignora wc: se convierte L'\0' en un búfer interno, en lugar de medir la longitud.

Ejemplos

#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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes