ctype::_Do_narrow_s

A virtual function called to convert a character of type CharType used by a locale to the corresponding character of type char in the native character set.

virtual const CharType *_Do_narrow_s(
    const CharType *first,
    const CharType *last,
    char default,
    char *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.

• default
  The default value to be assigned by the member function to characters of type CharType that do not have counterpart characters of type char.

• dest
  A const pointer to the first character of type char in the destination range that stores the converted range of characters.

• dest_size
  The size of dest in bytes.

Return Value

This protected member function returns a pointer to the destination range of native characters converted from characters of type CharType.

Remarks

This protected member template function stores in dest[I] the value _Do_narrow_s(first [I], default), for I in the interval [0, last – first).

Example

See the example for ctype::_Narrow_s, which calls _Do_narrow_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.