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.