ctype::do_toupper

  • Article

A virtual function called to convert a character or a range of characters to upper case.

virtual CharType do_toupper(
    CharType ch
) const;
virtual const CharType *do_toupper(
    CharType* first, 
    const CharType* last
) const;

Parameters

  • ch
    The character to be converted to upper case.

  • first
    A pointer to the first character in the range of characters whose cases are to be converted.

  • last
    A pointer to character immediately following the last character in the range of characters whose cases are to be converted.

Return Value

The first protected member function returns the uppercase form of the parameter ch. If no uppercase form exists, it returns ch. The second protected member function returns last.

Remarks

The second protected member template function replaces each element first [I], for I in the interval [0, last – first), with do_toupper(first [I]).

Example

See the example for toupper, which calls do_toupper.

Requirements

Header: <locale>

Namespace: std

See Also

Reference

ctype Class

Other Resources

ctype Members

Change History

Date

History

Reason

March 2009

Corrected.

Customer feedback.