KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

wcrtomb — een breed teken omzetten naar een multibytereeks

wcrtomb codeert één wchar_t volgens LC_CTYPE en bewaart de conversiestatus in mbstate_t.

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

Syntax

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

wcrtomb schrijft wc volgens LC_CTYPE; het resultaat is niet noodzakelijk UTF-8. De buffer moet ruimte bieden aan MB_CUR_MAX bytes; MB_LEN_MAX volstaat voor elke locale.

Initialiseer mbstate_t met {0} en behoud de status tussen tekens. Als ps == NULL, wordt een interne status gebruikt.

De geretourneerde waarde is het aantal geschreven bytes, inclusief statuswisselsequenties. Bij een fout retourneert de functie (size_t)-1, stelt errno in op EILSEQ en blijft de status onbepaald.

L'\0' schrijft een nulbyte en herstelt de beginstatus. Andere tekens voegen geen terminator toe. Als s == NULL, wordt wc genegeerd: L'\0' wordt naar een interne buffer omgezet, in plaats van de lengte te meten.

Voorbeelden

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

Resultaat

bytes=1, matches=1

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen