std::basic_istream<CharT,Traits>:: getline

Извлекает символы из потока до конца строки или указанного разделителя delim .

Первая перегрузка эквивалентна getline ( s, count, widen ( ' \n ' ) ) .

Ведёт себя как UnformattedInputFunction . После создания и проверки сторожевого объекта извлекает символы из * this и сохраняет их в последовательных ячейках массива, первый элемент которого указывается s , до тех пор пока не произойдёт любое из следующих условий (проверяемых в указанном порядке):

1. в потоке ввода возникает условие конца файла.
2. следующий доступный символ c является разделителем, как определено Traits :: eq ( c, delim ) . Разделитель извлекается (в отличие от basic_istream::get() ) и учитывается в gcount() , но не сохраняется.
3. count неположителен, или count - 1 символов было извлечено ( setstate ( failbit ) вызывается в этом случае).

Если функция не извлекает символы, ​ failbit устанавливается в локальном состоянии ошибки до вызова setstate() .

В любом случае, если count > 0 , тогда он сохраняет нулевой символ CharT ( ) в следующую последовательную позицию массива и обновляет gcount() .

Примечания

Поскольку условие №2 проверяется до условия №3, входная строка, точно соответствующая размеру буфера, не вызывает установку failbit .

Поскольку завершающий символ считается извлеченным символом, пустая входная строка не вызывает установку failbit .

Параметры

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

* this

Исключения

Если внутренняя операция выбрасывает исключение, оно перехватывается и badbit устанавливается. Если exceptions() установлен для badbit , исключение выбрасывается повторно.

Пример

#include <array>
#include <iostream>
#include <sstream>
#include <vector>
int main()
{
    std::istringstream input("abc|def|gh");
    std::vector<std::array<char, 4>> v;
    // примечание: следующий цикл завершается, когда std::ios_base::operator bool()
    // для потока, возвращенного из getline(), возвращает false
    for (std::array<char, 4> a; input.getline(&a[0], 4, '|');)
        v.push_back(a);
    for (auto& a : v)
        std::cout << &a[0] << '\n';
}

abc
def
gh

Отчеты о дефектах

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

Смотрите также