wctob

 

C

语言

头文件

类型支持

程序工具

变参数函数支持

动态内存管理

错误处理

日期和时间工具

字符串库

算法

数值

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

字符串库

字节字符串

多字节字符串

宽字符串

 

空终止多字节字符串

宽/多字节转换
mbsinit (C95)
mbtowc mbstowcsmbstowcs_s (C11) btowc (C95) mbrtowc (C95) mbsrtowcsmbsrtowcs_s (C95)(C11) mbrtoc16 (C11) c16rtomb (C11) c32rtomb (C11) mbrtoc32 (C11)	mblen wctombwctomb_s (C11) wcstombswcstombs_s (C11) wctob (C95) wcrtombwcrtomb_s (C95)(C11) wcsrtombswcsrtombs_s (C95)(C11) mbrlen (C95)
类型
mbstate_t (C95)

 

定义于头文件 <wchar.h>
int wctob( wint_t c );		(C95 起)

若宽字符 c 的多字节字符等价在初始迁移状态为单字节，则窄化它。

这典型地对来自 ASCII 字符集的字符可行，因为大多数多字节编码（如 UTF-8 ）用单字节编码这些字符。

参数

c

-

要窄化的宽字符

返回值

若 c 不表示在初始迁移状态长度为 1 的多字节字符，则返回 EOF 。

否则，返回 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 standard (ISO/IEC 9899:2011):

• 7.29.6.1.2 The wctob function (p: 441)

• C99 standard (ISO/IEC 9899:1999):

• 7.24.6.1.2 The wctob function (p: 387)

参阅

btowc (C95)

将单字节窄字符加宽成宽字符，倘若可能 (函数)