istream File Reference

#include <ostream>

Classes
class	basic_istream< _Elem, _Traits >
class	basic_istream< _Elem, _Traits >::_Sentry_base
class	basic_istream< _Elem, _Traits >::sentry
class	basic_iostream< _Elem, _Traits >

Macros
#define	_ISTREAM_

Functions
template<class _Elem , class _Traits >
basic_istream< _Elem, _Traits > &	operator>> (basic_istream< _Elem, _Traits > &_Istr, _Elem &_Ch)
template<class _Elem , class _Traits >
basic_istream< _Elem, _Traits > &	operator>> (basic_istream< _Elem, _Traits > &_Istr, _Elem *_Str)
template<class _Traits >
basic_istream< char, _Traits > &	operator>> (basic_istream< char, _Traits > &_Istr, signed char *_Str)
template<class _Traits >
basic_istream< char, _Traits > &	operator>> (basic_istream< char, _Traits > &_Istr, signed char &_Ch)
template<class _Traits >
basic_istream< char, _Traits > &	operator>> (basic_istream< char, _Traits > &_Istr, unsigned char *_Str)
template<class _Traits >
basic_istream< char, _Traits > &	operator>> (basic_istream< char, _Traits > &_Istr, unsigned char &_Ch)
template<class _Elem , class _Traits , class _Ty >
basic_istream< _Elem, _Traits > &	operator>> (basic_istream< _Elem, _Traits > &&_Istr, _Ty &_Val)
template<class _Elem , class _Traits >
basic_istream< _Elem, _Traits > &__CLRCALL_OR_CDECL	ws (basic_istream< _Elem, _Traits > &_Istr)
_CRTIMP2_PURE basic_istream< char, char_traits< char > > &__CLRCALL_OR_CDECL	ws (basic_istream< char, char_traits< char > > &_Istr)
_CRTIMP2_PURE basic_istream< wchar_t, char_traits< wchar_t > > &__CLRCALL_OR_CDECL	ws (basic_istream< wchar_t, char_traits< wchar_t > > &_Istr)

Macro Definition Documentation

#define _ISTREAM_

Function Documentation

template<class _Elem , class _Traits >

basic_istream< _Elem, _Traits > & operator>> ( basic_istream< _Elem, _Traits > &  _Istr, _Elem &  _Ch  )

inline

    {   // extract a character
    typedef basic_istream<_Elem, _Traits> _Myis;

    typename _Myis::int_type _Meta;
    ios_base::iostate _State = ios_base::goodbit;
    const typename _Myis::sentry _Ok(_Istr);

    if (_Ok)
        {   // state okay, extract characters
        _TRY_IO_BEGIN
        _Meta = _Istr.rdbuf()->sbumpc();
        if (_Traits::eq_int_type(_Traits::eof(), _Meta))
            _State |= ios_base::eofbit | ios_base::failbit; // end of file
        else
            _Ch = _Traits::to_char_type(_Meta); // got a character
        _CATCH_IO_(_Istr)
        }

    _Istr.setstate(_State);
    return (_Istr);
    }

template<class _Elem , class _Traits >

basic_istream<_Elem, _Traits>& operator>> ( basic_istream< _Elem, _Traits > &  _Istr, _Elem *  _Str  )

inline

    {   // extract NTBS
    _DEBUG_POINTER(_Str);
    typedef basic_istream<_Elem, _Traits> _Myis;
    typedef ctype<_Elem> _Ctype;
    ios_base::iostate _State = ios_base::goodbit;
    _Elem *_Str0 = _Str;
    const typename _Myis::sentry _Ok(_Istr);

    if (_Ok)
        {   // state okay, extract characters
        const _Ctype& _Ctype_fac = _USE(_Istr.getloc(), _Ctype);

        _TRY_IO_BEGIN
        streamsize _Count = 0 < _Istr.width() ? _Istr.width() : INT_MAX;
        typename _Myis::int_type _Meta = _Istr.rdbuf()->sgetc();
        _Elem _Ch;
        for (; 0 < --_Count; _Meta = _Istr.rdbuf()->snextc())
            if (_Traits::eq_int_type(_Traits::eof(), _Meta))
                {   // end of file, quit
                _State |= ios_base::eofbit;
                break;
                }
            else if (_Ctype_fac.is(_Ctype::space,
                _Ch = _Traits::to_char_type(_Meta))
                    || _Ch == _Elem())
                break;  // whitespace or nul, quit
            else
                *_Str++ = _Traits::to_char_type(_Meta); // add it to string
        _CATCH_IO_(_Istr)
        }

    *_Str = _Elem();    // add terminating null character
    _Istr.width(0);
    _Istr.setstate(_Str == _Str0 ? _State | ios_base::failbit : _State);
    return (_Istr);
    }

template<class _Traits >

basic_istream<char, _Traits>& operator>> ( basic_istream< char, _Traits > &  _Istr, signed char *  _Str  )

inline

    {   // extract a signed char NTBS
    return (_Istr >> (char *)_Str);
    }

template<class _Traits >

basic_istream<char, _Traits>& operator>> ( basic_istream< char, _Traits > &  _Istr, signed char &  _Ch  )

inline

    {   // extract a signed char
    return (_Istr >> (char&)_Ch);
    }

template<class _Traits >

basic_istream<char, _Traits>& operator>> ( basic_istream< char, _Traits > &  _Istr, unsigned char *  _Str  )

inline

    {   // extract an unsigned char NTBS
    return (_Istr >> (char *)_Str);
    }

template<class _Traits >

basic_istream<char, _Traits>& operator>> ( basic_istream< char, _Traits > &  _Istr, unsigned char &  _Ch  )

inline

    {   // extract an unsigned char
    return (_Istr >> (char&)_Ch);
    }

template<class _Elem , class _Traits , class _Ty >

basic_istream<_Elem, _Traits>& operator>> ( basic_istream< _Elem, _Traits > &&  _Istr, _Ty &  _Val  )

inline

    {   // extract from rvalue stream
    return (_Istr >> _Val);
    }

template<class _Elem , class _Traits >

basic_istream<_Elem, _Traits>& __CLRCALL_OR_CDECL ws ( basic_istream< _Elem, _Traits > &  _Istr )

inline

    {   // consume whitespace
    typedef basic_istream<_Elem, _Traits> _Myis;
    typedef ctype<_Elem> _Ctype;

    if (!_Istr.eof())
        {   // not at eof, okay to construct sentry and skip
        ios_base::iostate _State = ios_base::goodbit;
        const typename _Myis::sentry _Ok(_Istr, true);

        if (_Ok)
            {   // state okay, extract characters
            const _Ctype& _Ctype_fac = _USE(_Istr.getloc(), _Ctype);

            _TRY_IO_BEGIN
            for (typename _Traits::int_type _Meta = _Istr.rdbuf()->sgetc(); ;
                _Meta = _Istr.rdbuf()->snextc())
                if (_Traits::eq_int_type(_Traits::eof(), _Meta))
                    {   // end of file, quit
                    _State |= ios_base::eofbit;
                    break;
                    }
                else if (!_Ctype_fac.is(_Ctype::space,
                    _Traits::to_char_type(_Meta)))
                    break;  // not whitespace, quit
            _CATCH_IO_(_Istr)
            }

        _Istr.setstate(_State);
        }
    return (_Istr);
    }

_CRTIMP2_PURE basic_istream<char, char_traits<char> >& __CLRCALL_OR_CDECL ws ( basic_istream< char, char_traits< char > > &  _Istr )

inline

    {   // consume whitespace
    typedef char _Elem;
    typedef char_traits<_Elem> _Traits;

    if (!_Istr.eof())
        {   // not at eof, okay to construct sentry and skip
        ios_base::iostate _State = ios_base::goodbit;
        const basic_istream<_Elem, _Traits>::sentry _Ok(_Istr, true);

        if (_Ok)
            {   // state okay, use facet to extract
            const ctype<_Elem>& _Ctype_fac =
                _USE(_Istr.getloc(), ctype<_Elem>);

            _TRY_IO_BEGIN
            for (_Traits::int_type _Meta = _Istr.rdbuf()->sgetc(); ;
                _Meta = _Istr.rdbuf()->snextc())
                if (_Traits::eq_int_type(_Traits::eof(), _Meta))
                    {   // end of file, quit
                    _State |= ios_base::eofbit;
                    break;
                    }
                else if (!_Ctype_fac.is(ctype<_Elem>::space,
                    _Traits::to_char_type(_Meta)))
                    break;  // not whitespace, quit
            _CATCH_IO_(_Istr)
            }

        _Istr.setstate(_State);
        }
    return (_Istr);
    }

_CRTIMP2_PURE basic_istream<wchar_t, char_traits<wchar_t> >& __CLRCALL_OR_CDECL ws ( basic_istream< wchar_t, char_traits< wchar_t > > &  _Istr )

inline

    {   // consume whitespace
    typedef wchar_t _Elem;
    typedef char_traits<_Elem> _Traits;

    if (!_Istr.eof())
        {   // not at eof, okay to construct sentry and skip
        ios_base::iostate _State = ios_base::goodbit;
        const basic_istream<_Elem, _Traits>::sentry _Ok(_Istr, true);

        if (_Ok)
            {   // state okay, use facet to extract
            const ctype<_Elem>& _Ctype_fac =
                _USE(_Istr.getloc(), ctype<_Elem>);

            _TRY_IO_BEGIN
            for (_Traits::int_type _Meta = _Istr.rdbuf()->sgetc(); ;
                _Meta = _Istr.rdbuf()->snextc())
                if (_Traits::eq_int_type(_Traits::eof(), _Meta))
                    {   // end of file, quit
                    _State |= ios_base::eofbit;
                    break;
                    }
                else if (!_Ctype_fac.is(ctype<_Elem>::space,
                    _Traits::to_char_type(_Meta)))
                    break;  // not whitespace, quit
            _CATCH_IO_(_Istr)
            }

        _Istr.setstate(_State);
        }
    return (_Istr);
    }