Spec-Zone.ru › C

wctob

Определено в заголовочном файле <wchar.h>
int wctob( wint_t c );
(с C95)

Сужает символ широкой кодировки c, если его многобайтовый эквивалент в начальном состоянии сдвига — это один байт.

Это обычно возможно для символов из набора символов ASCII, поскольку большинство многобайтовых кодировок (таких как UTF-8) используют один байт для кодирования этих символов.

Параметры

c - символ широкой кодировки для сужения

Значение возврата

EOF если c не представляет многобайтовый символ длиной 1 в начальном состоянии сдвига.

в противном случае — однобайтовое представление c как unsigned char преобразованное в int

Пример

#include <locale.h>
#include <wchar.h>
#include <stdio.h>
#include <assert.h>
 
void try_narrowing(wchar_t c)
{
    int cn = wctob(c);
    if(cn != EOF)
        printf("%#x narrowed to %#x\n", c, cn);
    else
        printf("%#x could not be narrowed\n", c);
}
 
int main(void)
{
    char* utf_locale_present = setlocale(LC_ALL, "th_TH.utf8");
    assert(utf_locale_present);
    puts("In Thai UTF-8 locale:");
    try_narrowing(L'a');
    try_narrowing(L'๛');
 
    char* tis_locale_present = setlocale(LC_ALL, "th_TH.tis620");
    assert(tis_locale_present);
    puts("In Thai TIS-620 locale:");
    try_narrowing(L'a');
    try_narrowing(L'๛');
}

Возможный вывод:

In Thai UTF-8 locale:
0x61 narrowed to 0x61
0xe5b could not be narrowed
In Thai TIS-620 locale:
0x61 narrowed to 0x61
0xe5b narrowed to 0xfb

Ссылки

  • Стандарт C11 (ISO/IEC 9899:2011):
    • 7.29.6.1.2 Функция wctob (стр. 441)
  • Стандарт C99 (ISO/IEC 9899:1999):
    • 7.24.6.1.2 Функция wctob (стр. 387)

См. также

btowc
(C95)
расширяет однобайтовый символ узкой кодировки до символа широкой кодировки, если это возможно
(функция)
Документация C++ для wctob

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/string/multibyte/wctob

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API