| 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 | |||||||||||||||||||||||||
| |||||||||||||||||||||||||
Defined in header <cstdlib> | ||
std::size_t wcstombs(char* dst,constwchar_t* src,std::size_t len); | ||
Converts a sequence of wide characters from the array whose first element is pointed to bysrc to its narrow multibyte representation that begins in the initial shift state. Converted characters are stored in the successive elements of the char array pointed to bydst. No more thanlen bytes are written to the destination array.
Each character is converted as if by a call tostd::wctomb, except that the wctomb's conversion state is unaffected. The conversion stops if:
Contents |
In most implementations, this function updates a global static object of typestd::mbstate_t as it processes through the string, and cannot be called simultaneously by two threads,std::wcsrtombs should be used in such cases.
POSIX specifies a common extension: ifdst is a null pointer, this function returns the number of bytes that would be written todst, if converted. Similar behavior is standard forstd::wcsrtombs.
| dst | - | pointer to narrow character array where the multibyte character will be stored |
| src | - | pointer to the first element of a null-terminated wide string to convert |
| len | - | number of byte available in the array pointed to by dst |
On success, returns the number of bytes (including any shift sequences, but excluding the terminating'\0') written to the character array whose first element is pointed to bydst.
On conversion error (if invalid wide character was encountered), returnsstatic_cast<std::size_t>(-1).
#include <clocale>#include <cstdlib>#include <iostream> int main(){std::setlocale(LC_ALL,"en_US.utf8");// UTF-8 narrow multibyte encodingconstwchar_t* wstr= L"z\u00df\u6c34\U0001d10b";// or L"zß水𝄋"char mbstr[11]; std::wcstombs(mbstr, wstr,11);std::cout<<"multibyte string: "<< mbstr<<'\n';}
Output:
multibyte string: zß水𝄋
| converts a wide string to narrow multibyte character string, given state (function)[edit] | |
| converts a narrow multibyte character string to wide string (function)[edit] | |
[virtual] | converts a string fromInternT toExternT, such as when writing to file(virtual protected member function of std::codecvt<InternT,ExternT,StateT>)[edit] |
C documentation forwcstombs | |
