Export (0) Print
Expand All

ctype::do_widen

Updated: March 2009

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.

This method is potentially unsafe, as it relies on the caller to check that the passed values are correct. Consider using ctype::_Do_widen_s instead.

virtual CharType do_widen(
    char byte
) const;
virtual const char *do_widen(
    const char* first, 
    const char* last, 
    CharType* dest
) const;

byte

The character of type char in the native character set to be converted.

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.

The first protected member function returns the character of type CharType that corresponds to the parameter character of native type char.

The second 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.

The second protected member template function stores in dest[I] the value do_widen(first[I]), for I in the interval [0, last - first).

NoteNote:

Any specialization of ctype that overrides this method must also override the ctype::_Do_widen_s method.

See the example for widen, which calls do_widen.

Header: <locale>

Namespace: std

Reference

Other Resources

Date

History

Reason

March 2009

Corrected.

Customer feedback.

Community Additions

ADD
Show:
© 2015 Microsoft