Поделиться через


basic_istream::getline

Получает линии из входного потока.

basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count
);
basic_istream<Elem, Tr>& getline(
    char_type *_Str, 
    streamsize _Count, 
    char_type _Delim
);

Параметры

  • _Count
    Число символов для чтения из strbuf.

  • _Delim
    Символ, который должен выполнить чтение, если он встречается перед _Count.

  • _Str
    Строка, в которой, которые требуется записать.

Возвращаемое значение

Поток (*this).

Заметки

Первая из этих unformatted входных функций возвращает getline(_Str, _Count, widen("\n").

Вторая функция извлекает до _Count — элементы 1 и сохраняет их в начале массива с _Str. Он всегда хранит символ завершения строки после того, как все извлеченные элементы он хранит. В порядке тестирования, извлечение останавливается.

  • В конце файла.

  • После того как функция извлекает элемент, который сравнивает равно _Delim, в случае которого он не помещается обратно не добавляется в контролируемой последовательности.

  • После функции извлекает элементы _Count — 1.

Если функция не извлекает элементов или _Count — 1 элементов, она вызывает функцию setstate(failbit). В любом случае, она возвращает *this.

Пример

// basic_istream_getline.cpp
// compile with: /EHsc
#include <iostream>
using namespace std;

int main( ) 
{
   char c[10];

   cin.getline( &c[0], 5, '2' );
   cout << c << endl;
}
  

Требования

Заголовок:<istream>

Пространство имен: std

См. также

Ссылки

Класс basic_istream

Программирование iostream

Соглашения iostreams