std::getline

Определено в заголовке `<string>`
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>& getline( std::basic_istream<CharT, Traits>& input, std::basic_string<CharT, Traits, Allocator>& str, CharT delim );	(1)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>& getline( std::basic_istream<CharT, Traits>&& input, std::basic_string<CharT, Traits, Allocator>& str, CharT delim );	(2)	(с C++11)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>& getline( std::basic_istream<CharT, Traits>& input, std::basic_string<CharT, Traits, Allocator>& str );	(3)
template< class CharT, class Traits, class Allocator > std::basic_istream<CharT, Traits>& getline( std::basic_istream<CharT, Traits>&& input, std::basic_string<CharT, Traits, Allocator>& str );	(4)	(с C++11)

getline считывает символы из потока ввода и помещает их в строку:

1,2) Ведёт себя как UnformattedInputFunction, за исключением того, что input.gcount() не затронуто. После создания и проверки объекта sentry выполняется следующее:

1) Вызывает str.erase().

2) Извлекает символы из input и добавляет их к str до тех пор, пока не произойдёт одно из следующих событий (проверяется в указанном порядке):

a) состояние конца файла в input, в этом случае getline устанавливает eofbit.

b) следующий доступный символ ввода — delim, как проверено Traits::eq(c, delim), в этом случае символ-разделитель извлекается из input, но не добавляется в str.

c) было сохранено str.max_size() символов, в этом случае getline устанавливает failbit и возвращает значение.

3) Если по какой-либо причине не было извлечено ни одного символа (даже не сброшенный разделитель), getline устанавливает failbit и возвращает значение.

3,4) Аналогично getline(input, str, input.widen('\n')), то есть, по умолчанию разделитель — символ конца строки.

Параметры

input	-	поток для получения данных
str	-	строка для размещения данных
delim	-	символ разделителя

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

input

Примечания

При обработке ввода, ограниченного пробелами (например, int n; std::cin >> n;) любые пробелы, включая символ новой строки, остаются в потоке ввода. Затем, при переключении на строчный ввод, первая полученная строка с помощью getline будет содержать только эти пробелы. В вероятном случае, если это нежелательное поведение, возможные решения включают:

Явное дополнительное начальное вызов getline.
Удаление последовательных пробелов с помощью std::cin >> std::ws.
Игнорирование всех оставшихся символов в строке ввода с помощью cin.ignore(std::numeric_limits<std::streamsize>::max(), '\n');.

Пример

Следующий пример демонстрирует использование функции getline для чтения пользовательского ввода и обработки потока построчно или по частям строки с использованием параметра delim.

#include <iostream>
#include <sstream>
#include <string>
 
int main()
{
    // greet the user
    std::string name;
    std::cout << "What is your name? ";
    std::getline(std::cin, name);
    std::cout << "Hello " << name << ", nice to meet you.\n";
 
    // read file line by line
    std::istringstream input;
    input.str("1\n2\n3\n4\n5\n6\n7\n");
    int sum = 0;
    for (std::string line; std::getline(input, line);)
        sum += std::stoi(line);
    std::cout << "\nThe sum is " << sum << ".\n\n";
 
    // use separator to read parts of the line
    std::istringstream input2;
    input2.str("a;b;c;d");
    for (std::string line; std::getline(input2, line, ';');)
        std::cout << line << '\n';
}

Возможный вывод:

What is your name? John Q. Public
Hello John Q. Public, nice to meet you.
 
The sum is 28.
 
a
b
c
d

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR	Применено к	Поведение, опубликованное	Правильное поведение
LWG 91	C++98	`getline` не вела себя как функция неформатированного ввода	ведет себя как функция неформатированного ввода

См. также

getline

извлекает символы до тех пор, пока не будет найден указанный символ
(публичный член-функция std::basic_istream<CharT,Traits>)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/string/basic_string/getline