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

CKTIS / C

<uchar.h> — utilidades Unicode

El encabezado <uchar.h> proporciona tipos de unidades de código Unicode y funciones de conversión entre los formatos UTF correspondientes y la codificación multibyte de la configuración regional LC_CTYPE vigente.

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

Sintaxis

#include <uchar.h>

<uchar.h> declara char8_t, char16_t, char32_t, size_t y mbstate_t. En las conversiones, los tres primeros tipos representan unidades de código de UTF-8, UTF-16 y UTF-32, respectivamente. Una unidad de código no siempre representa un carácter completo.

Los pares mbrtoc8/c8rtomb, mbrtoc16/c16rtomb y mbrtoc32/c32rtomb convierten entre la codificación multibyte de la configuración regional LC_CTYPE vigente y el formato UTF correspondiente. La codificación elegida en tiempo de compilación para los literales ordinarios no determina la codificación multibyte que usan estas funciones. No des por hecho que la codificación multibyte vigente es UTF-8; conserva el estado de mbstate_t entre llamadas relacionadas.

El ejemplo cuenta las unidades de código de un literal UTF-8 sin incluir el terminador, con independencia de la configuración regional. No llama a ninguna de estas funciones de conversión. La opción del compilador del repositorio no acredita que estas funciones estén disponibles en el entorno de ejecución de producción.

Ejemplos

#include <stdio.h>
#include <uchar.h>

#if !defined(__STDC_VERSION_UCHAR_H__)
typedef unsigned char char8_t;
#endif

int main(void)
{
    const char8_t text[] = u8"é";
    const size_t units = sizeof text / sizeof text[0] - 1;
    printf("%zu\n", units);
    return 0;
}

Resultado

2

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