getline() [4/9]

template<typename _CharT, typename _Traits, typename _Alloc, template< typename, typename, typename > class _Base>

basic_istream< _CharT, _Traits > & std::getline	(	basic_istream< _CharT, _Traits > &	__is,
		__gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base > &	__str,
		_CharT	__delim )

Read a line from stream into a string.

Parameters

__is	Input stream.
__str	Buffer to store into.
__delim	Character marking end of line.

Returns

Reference to the input stream.

Stores characters from __is into __str until __delim is found, the end of the stream is encountered, or str.max_size() is reached. If is.width() is non-zero, that is the limit on the number of characters stored into __str. Any previous contents of __str are erased. If delim was encountered, it is extracted but not stored into __str.

Definition at line 631 of file vstring.tcc.

    {
      typedef basic_istream<_CharT, _Traits>            __istream_type;
      typedef typename __istream_type::ios_base         __ios_base;
      typedef __gnu_cxx::__versa_string<_CharT, _Traits, _Alloc, _Base>
                                                      __string_type;
      typedef typename __istream_type::int_type       __int_type;
      typedef typename __string_type::size_type       __size_type;
 
      __size_type __extracted = 0;
      const __size_type __n = __str.max_size();
      typename __ios_base::iostate __err = __ios_base::goodbit;
      typename __istream_type::sentry __cerb(__in, true);
      if (__cerb)
      {
        __try
          {
            // Avoid reallocation for common case.
            __str.erase();
            _CharT __buf[128];
            __size_type __len = 0;
            const __int_type __idelim = _Traits::to_int_type(__delim);
            const __int_type __eof = _Traits::eof();
            __int_type __c = __in.rdbuf()->sgetc();
 
            while (__extracted < __n
                 && !_Traits::eq_int_type(__c, __eof)
                 && !_Traits::eq_int_type(__c, __idelim))
            {
              if (__len == sizeof(__buf) / sizeof(_CharT))
                {
                  __str.append(__buf, sizeof(__buf) / sizeof(_CharT));
                  __len = 0;
                }
              __buf[__len++] = _Traits::to_char_type(__c);
              ++__extracted;
              __c = __in.rdbuf()->snextc();
            }
            __str.append(__buf, __len);
 
            if (_Traits::eq_int_type(__c, __eof))
            __err |= __ios_base::eofbit;
            else if (_Traits::eq_int_type(__c, __idelim))
            {
              ++__extracted;          
              __in.rdbuf()->sbumpc();
            }
            else
            __err |= __ios_base::failbit;
          }
        __catch(__cxxabiv1::__forced_unwind&)
          {
            __in._M_setstate(__ios_base::badbit);
            __throw_exception_again;
          }
        __catch(...)
          {
            // _GLIBCXX_RESOLVE_LIB_DEFECTS
            // 91. Description of operator>> and getline() for string<>
            // might cause endless loop
            __in._M_setstate(__ios_base::badbit);
          }
      }
      if (!__extracted)
      __err |= __ios_base::failbit;
      if (__err)
      __in.setstate(__err);
      return __in;
    }      

References __catch, __throw_exception_again, __try, std::basic_ios< _CharT, _Traits >::_M_setstate(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::append(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::erase(), getline(), __gnu_cxx::__versa_string< _CharT, _Traits, _Alloc, _Base >::max_size(), std::basic_ios< _CharT, _Traits >::rdbuf(), and std::basic_ios< _CharT, _Traits >::setstate().

Here is the call graph for this function: