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

See Also

Concepts

ctype Class

ctype Members

Safe Libraries: Standard C++ Library