Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/string/multibyte/wctob"

From cppreference.com
< cpp‎ | string‎ | multibyte
m (Update links.)
Line 5: Line 5:
 
}}
 
}}
  
Narrows a wide character {{tt|c}} if its multibyte character equivalent in the initial shift state is a single byte.
+
窄化宽字符 {{tt|c}} ,若其多字节字符等价版本在初始迁移状态为单字节。
  
This is typically possible for the characters from the ASCII character set, since most multibyte encodings (such as UTF-8) use single bytes to encode those characters.
+
这典型地对来自 ASCII 字符集的字符可行,因为大多数多字节编码(例如 UTF-8 )用单字节编码那些字符。
  
===Parameters===
+
===参数===
 
{{par begin}}
 
{{par begin}}
{{par | c | wide character to narrow}}
+
{{par | c |要窄化的宽字符}}
 
{{par end}}
 
{{par end}}
  
===Return value===
+
===返回值===
{{lc|EOF}} if {{tt|c}} does not represent a multibyte character with length {{c|1}} in initial shift state.
+
{{tt|c}} 在初始迁移状态不表示长度为 {{c|1}} 的多字节字符则为 {{lc|EOF}}
  
Otherwise, the single-byte representation of {{tt|c}} as {{c|unsigned char}} converted to {{c|int}}
+
否则,为作为 {{c|unsigned char}} {{tt|c}} 的单字节表示,转换为 {{c|int}}
  
===Example===
+
===示例===
 
{{example
 
{{example
 
  |  
 
  |  
Line 57: Line 57:
 
}}
 
}}
  
===See also===
+
===参阅===
 
{{dsc begin}}
 
{{dsc begin}}
 
{{dsc inc | cpp/string/multibyte/dsc btowc}}
 
{{dsc inc | cpp/string/multibyte/dsc btowc}}
Line 65: Line 65:
 
{{dsc end}}
 
{{dsc end}}
  
[[de:cpp/string/multibyte/wctob]]
+
{{langlinks|de|en|es|fr|it|ja|pt|ru}}
[[es:cpp/string/multibyte/wctob]]
+
[[fr:cpp/string/multibyte/wctob]]
+
[[it:cpp/string/multibyte/wctob]]
+
[[ja:cpp/string/multibyte/wctob]]
+
[[pt:cpp/string/multibyte/wctob]]
+
[[ru:cpp/string/multibyte/wctob]]
+
[[zh:cpp/string/multibyte/wctob]]
+

Revision as of 01:29, 10 October 2017

Defined in header <cwchar>
int wctob( std::wint_t c );

窄化宽字符 c ,若其多字节字符等价版本在初始迁移状态为单字节。

这典型地对来自 ASCII 字符集的字符可行,因为大多数多字节编码(例如 UTF-8 )用单字节编码那些字符。

Contents

参数

c - 要窄化的宽字符

返回值

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

否则,为作为 unsigned charc 的单字节表示,转换为 int

示例

#include <clocale>
#include <cwchar>
#include <iostream>
 
void try_narrowing(wchar_t c)
{
    int cn = std::wctob(c);
    if(cn != EOF)
        std::cout << '\'' << c << "' narrowed to " << +cn << '\n';
    else
        std::cout << '\'' << c << "' could not be narrowed\n";
}
 
int main()
{
    std::setlocale(LC_ALL, "th_TH.utf8");
    std::cout << std::hex << std::showbase << "In Thai UTF-8 locale:\n";
    try_narrowing(L'a');
    try_narrowing(L'๛');
 
    std::setlocale(LC_ALL, "th_TH.tis620");
    std::cout << "In Thai TIS-620 locale:\n";
    try_narrowing(L'a');
    try_narrowing(L'๛');
}

Output:

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

参阅

widens a single-byte narrow character to wide character, if possible
(function) [edit]
narrows characters
(public member function of std::basic_ios<CharT,Traits>) [edit]
invokes do_narrow
(public member function of std::ctype<CharT>) [edit]
C documentation for wctob