| Localization library | |||||||||||||||||||||||||
| Regular expressions library(C++11) | |||||||||||||||||||||||||
| Formatting library(C++20) | |||||||||||||||||||||||||
| Null-terminated sequence utilities | |||||||||||||||||||||||||
| Byte strings | |||||||||||||||||||||||||
| Multibyte strings | |||||||||||||||||||||||||
| Wide strings | |||||||||||||||||||||||||
| Primitive numeric conversions | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
| Text encoding identifications | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Member functions | ||||
wstring_convert::converted | ||||
Defined in header <locale> | ||
std::size_t converted()constnoexcept; | ||
Returns the number of source characters that were successfully processed by the most recentfrom_bytes() orto_bytes().
Contents |
#include <codecvt>#include <iostream>#include <locale>#include <string> int main(){std::string utf8="z\u00df\u6c34\U0001d10b";// or u8"zß水𝄋"// or "\x7a\xc3\x9f\xe6\xb0\xb4\xf0\x9d\x84\x8b";std::cout<<"original UTF-8 string size: "<< utf8.size()<<'\n'; // the UTF-8 - UTF-32 standard conversion facetstd::wstring_convert<std::codecvt_utf8<char32_t>,char32_t> cvt; // UTF-8 to UTF-32std::u32string utf32= cvt.from_bytes(utf8);std::cout<<"UTF-32 string size: "<< utf32.size()<<'\n';std::cout<<"converted() == "<< cvt.converted()<<'\n'; // UTF-32 to UTF-8 utf8= cvt.to_bytes(utf32);std::cout<<"new UTF-8 string size: "<< utf8.size()<<'\n';std::cout<<"converted() == "<< cvt.converted()<<'\n';}
Output:
original UTF-8 string size: 10UTF-32 string size: 4converted() == 10new UTF-8 string size: 10converted() == 4
The following behavior-changing defect reports were applied retroactively to previously published C++ standards.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 2174 | C++11 | wstring_convert::converted was not required to be noexcept | required |
| converts a wide string into a byte string (public member function)[edit] | |
| converts a byte string into a wide string (public member function)[edit] |
