ctype::_Do_widen_s
A virtual function called to converts a character of type char in the native character set to the corresponding character of type CharType used by a locale.
virtual const char *_Do_widen_s(
const char *_First,
const char *_Last,
CharType *_Dest,
size_t _Dest_size
) const;
Parameters
_First
A pointer to the first character in the range of characters to be converted._Last
A pointer to the last character in the range of characters to be converted._Dest
A pointer to the first character of type CharType in the destination range that stores the converted range of characters._Dest_size
The size of _Dest. If CharType is char, then this is in bytes. If CharType is wchar_t, then this is in words.
Return Value
This protected member function returns a pointer to the destination range of characters of type CharType used by a locale converted from native characters of type char.
Remarks
This protected member template function stores in _Dest [I] the value _Do_widen_s(_First [I]), for I in the interval [0, _Last - _First).
Example
See the example for ctype::_Widen_s, which calls _Do_widen_s.
Requirements
Header: <locale>
Namespace: std