Annex D

(normative)

Compatibility features [depr]

D.25 Deprecated signed char and unsigned char extraction [depr.istream.extractors]

The header <istream> has the following additions:

template<class traits>
  basic_istream<char, traits>& operator>>(basic_istream<char, traits>& in, unsigned char& c);
template<class traits>
  basic_istream<char, traits>& operator>>(basic_istream<char, traits>& in, signed char& c);

Effects: Behaves like a formatted input member (as described in ([istream.formatted.reqmts])) of in.

A character is extracted from in, if one is available, and stored in c.

Otherwise, ios_base::failbit is set in the input function's local error state before setstate is called.

Returns: in.

🔗

template<class traits, size_t N>
  basic_istream<char, traits>& operator>>(basic_istream<char, traits>& in, unsigned char (&s)[N]);
template<class traits, size_t N>
  basic_istream<char, traits>& operator>>(basic_istream<char, traits>& in, signed char (&s)[N]);

Effects: Behaves like a formatted input member (as described in ([istream.formatted.reqmts])) of in.

After a sentry object is constructed, operator>> extracts characters and stores them into s.

If width() is greater than zero, n is min(size_t(width()), N).

Otherwise n is N.

n is the maximum number of characters stored.

Characters are extracted and stored until any of the following occurs:

(6.1)
n - 1 characters are stored;
(6.2)
end of file occurs on the input sequence;
(6.3)
letting ct be use_facet<ctype<charT>>(in.getloc()), ct.is(ct.space, s) is true.

operator>> then stores a null byte (charT()) in the next position, which may be the first position if no characters were extracted.

operator>> then calls width(0).

If the function extracted no characters, ios_bit::failbit is set in the input function's local error state before setstate is called.

Returns: in.