База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

wcrtomb — преобразуване на широк знак в многобайтова последователност

wcrtomb кодира един wchar_t според LC_CTYPE и запазва състоянието на преобразуване в mbstate_t.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

wcrtomb записва wc според LC_CTYPE; резултатът не е непременно UTF-8. Буферът трябва да побира MB_CUR_MAX байта; MB_LEN_MAX е достатъчен за всяка локализация.

Инициализирайте mbstate_t с {0} и запазвайте състоянието между знаците. Ако ps == NULL, се използва вътрешно състояние.

Върнатата стойност показва броя записани байтове, включително последователностите за смяна на състоянието. При грешка функцията връща (size_t)-1, задава errno на EILSEQ и оставя състоянието неопределено.

L'\0' записва нулев байт и възстановява началното състояние. Другите знаци не добавят завършващ знак. Ако s == NULL, wc се игнорира: L'\0' се преобразува във вътрешен буфер, вместо да се измерва дължината.

Примери

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

Резултат

bytes=1, matches=1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници