getline
Извлечение строк из входного потока построчного.
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>& _Istr,
basic_string<CharType, Traits, Allocator>& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream< CharType, Traits >& getline(
basic_istream< CharType, Traits >& _Istr,
basic_string< CharType, Traits, Allocator >& _Str,
CharType _Delim
);
template<class Allocator, class Traits, class Allocator>
basic_istream< Allocator, Traits >& getline(
basic_istream< Allocator, Traits >&& _Istr,
basic_string< Allocator, Traits, Allocator >& _Str
);
template<class CharType, class Traits, class Allocator>
basic_istream<CharType, Traits>& getline(
basic_istream<CharType, Traits>&& _Istr,
basic_string<CharType, Traits, Allocator>& _Str,
const CharType _Delim
);
Параметры
_Istr
Входной поток, из которого строка быть, извлеченным._Str
Строка, в которой считываются знаки из входного потока._Delim
разделитель линии.
Возвращаемое значение
Первая функция возвращает GetLine( _Istr" _Str" _Istr.widen('\n')).
Вторая функция заменяет управляемую последовательность by _Str с последовательностью элементов, извлеченных из потока _Istr.
Остальные функции аналоговые к ранее, но с одним Lvalues и Rvalues.
Заметки
В порядке тестирования извлечение останавливает:
В конце файла.
После того как функция извлекает элемент, который сравнивает равно delimв этом случае элемент не помещается обратно не добавляется в управляемой последовательности.
После функции извлекает str.max_size элементы, в котором вызовы функций setstate(ios_base::failbit).
Если функция не извлекает элементы, она вызывает setstate(failbit).В любом случае возвращается _Istr.
Пример
См. string::getline пример использования getline.
Требования
заголовок:<Строка>
пространство имен: STD