Share via

ctype::_Do_widen_s

  • Article

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 character immediately following 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

Reference

ctype Class

Safe Libraries: Standard C++ Library

Other Resources

ctype Members

Change History

Date

History

Reason

March 2009

Corrected.

Customer feedback.