Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

wcrtomb — convertir un caractère large en séquence multioctet

wcrtomb encode un wchar_t selon LC_CTYPE et conserve l’état de conversion dans mbstate_t.

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

Syntaxe

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

wcrtomb écrit wc selon LC_CTYPE ; le résultat n’est pas nécessairement de l’UTF-8. Le tampon doit pouvoir contenir MB_CUR_MAX octets ; MB_LEN_MAX suffit pour n’importe quelle locale.

Initialisez mbstate_t avec {0} et conservez l’état entre les caractères. Si ps == NULL, un état interne est utilisé.

La valeur renvoyée indique le nombre d’octets écrits, séquences de changement d’état comprises. En cas d’échec, la fonction renvoie (size_t)-1, définit errno à EILSEQ et laisse l’état indéterminé.

L'\0' écrit un octet nul et rétablit l’état initial. Les autres caractères n’ajoutent pas de terminaison. Si s == NULL, wc est ignoré : L'\0' est converti dans un tampon interne, au lieu de mesurer la longueur.

Exemples

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

Résultat

bytes=1, matches=1

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources