CKTIS / C
wcrtomb — převod širokého znaku na vícebajtovou sekvenci
wcrtomb kóduje jeden wchar_t podle LC_CTYPE a zachovává stav převodu v mbstate_t.
Verze: 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 zapisuje wc podle LC_CTYPE; výsledek nemusí být UTF-8. Buffer musí pojmout MB_CUR_MAX bajtů; MB_LEN_MAX stačí pro jakékoli locale.
Inicializujte mbstate_t pomocí {0} a zachovávejte stav mezi znaky. Pokud je ps == NULL, použije se interní stav.
Vrácená hodnota udává počet zapsaných bajtů včetně sekvencí změny stavu. Při chybě funkce vrátí (size_t)-1, nastaví errno na EILSEQ a ponechá stav nespecifikovaný.
L'\0' zapíše nulový bajt a obnoví počáteční stav. Ostatní znaky nepřidávají ukončovací znak. Pokud je s == NULL, wc se ignoruje: L'\0' se převede do interního bufferu, místo aby se měřila délka.
Příklady
#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;
}Výsledek
bytes=1, matches=1
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.