Пространства имён
Варианты
Действия

std::basic_istream::getline

Материал из cppreference.com
< cpp‎ | io‎ | basic istream

 
 
Библиотеки ввода / вывода
I / O манипуляторов
C-стиль I / O
Буферы
Оригинал:
Buffers
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_streambuf
basic_filebuf
basic_stringbuf
strstreambuf(устарело)
Потоки
Оригинал:
Streams
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
Абстракций
Оригинал:
Abstractions
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
ios_base
basic_ios
basic_istream
basic_ostream
basic_iostream
Файл I / O
Оригинал:
File I/O
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_ifstream
basic_ofstream
basic_fstream
Струнный I / O
Оригинал:
String I/O
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_istringstream
basic_ostringstream
basic_stringstream
Массив I / O
Оригинал:
Array I/O
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
istrstream(устарело)
ostrstream(устарело)
strstream(устарело)
Типы
Оригинал:
Types
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
streamoff
streamsize
fpos
Интерфейс Ошибка категории
Оригинал:
Error category interface
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
iostream_category(C++11)
io_errc(C++11)
 
std::basic_istream
Глобальные объекты
Оригинал:
Global objects
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
cin
wcin
Функции-члены
basic_istream::basic_istream
basic_istream::~basic_istream
basic_istream::operator=(C++11)
Форматированный ввод
Оригинал:
Formatted input
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_istream::operator>>
Неформатированная вход
Оригинал:
Unformatted input
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_istream::get
basic_istream::peek
basic_istream::unget
basic_istream::putback
basic_istream::getline
basic_istream::ignore
basic_istream::read
basic_istream::readsome
basic_istream::gcount
Позиционирование
Оригинал:
Positioning
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_istream::tellg
basic_istream::seekg
Разное
Оригинал:
Miscellaneous
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_istream::sync
basic_istream::swap(C++11)
Член классов
Оригинал:
Member classes
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
basic_istream::sentry
Функции, не являющиеся членами
operator>>(std::basic_istream)
 
basic_istream& getline( char_type* s, std::streamsize count );
(1)
basic_istream& getline( char_type* s, std::streamsize count, char_type delim );
(2)
1)
Выдержки из потока символов до конца строки (эквивалентно getline(s, count, widen(’\n’)))
Оригинал:
Extracts characters from stream until the end of line (equivalent to getline(s, count, widen(’\n’)))
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
2)
Экстракты символов из потока до указанного разделителя.
Оригинал:
Extracts characters from stream until the specified delimiter.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
Ведет себя как UnformattedInputFunction. После построения и проверки часовой объектов, извлекает символы из *this и хранить их в последующих местах массив, первый элемент, на который указывает s до любого из следующих событий: (проверено в указанном порядке)
Оригинал:
Behaves as UnformattedInputFunction. After constructing and checking the sentry object, extracts characters from *this and stored them in successive locations of the array whose first element is pointed to by s until any of the following occurs: (tested in the order shown)
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
  • конец файла состояние возникает во входной последовательности (в этом случае setstate(eofbit) выполняется)
    Оригинал:
    end of file condition occurs in the input sequence (in which case setstate(eofbit) is executed)
    Текст был переведён автоматически через Google Translate.
    Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
  • следующий доступный c характера является разделителем, как это определено Traits::eq(c, delim). Разделитель извлекается (в отличие от basic_istream::get()) и засчитывается gcount(), но не сохраняются.
    Оригинал:
    the next available character c is the delimiter, as determined by Traits::eq(c, delim). The delimiter is extracted (unlike basic_istream::get()) and counted towards gcount(), but is not stored.
    Текст был переведён автоматически через Google Translate.
    Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
  • count-1 символы были извлечены (в этом случае setstate(failbit) выполняется).
    Оригинал:
    count-1 characters have been extracted (in which case setstate(failbit) is executed).
    Текст был переведён автоматически через Google Translate.
    Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
Если функция извлекает никаких символов (например, если count < 1), setstate(failbit) выполняется.
Оригинал:
If the function extracts no characters (e.g. if count < 1), setstate(failbit) is executed.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
В любом случае, если count>0, он затем сохраняет пустой CharT() характера в следующей последовательно расположения массива и обновления gcount().
Оригинал:
In any case, if count>0, it then stores a null character CharT() into the next successive location of the array and updates gcount().
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

Содержание

[править] Заметки

Потому что условие № 2 проверяется перед условии № 3, строки ввода, которая точно соответствует буфер, не вызывает failbit.
Оригинал:
Because condition #2 is tested before condition #3, the input line that exactly fits the buffer, does not trigger failbit.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
Потому что символ завершения считается как извлечь характер, пустой строке ввода не вызывает failbit.
Оригинал:
Because the terminating character is counted as extracted character, empty input line does not trigger failbit.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

[править] Параметры

s -
Указатель на строку символов для хранения символов
Оригинал:
pointer to the character string to store the characters to
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
count -
Размер символьной строки, на которую указывает s
Оригинал:
size of character string pointed to by s
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.
delim -
символ-разделитель, чтобы остановить добычу на. Она добывается, но не сохраняется .
Оригинал:
delimiting character to stop the extraction at. It is extracted but not stored.
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

[править] Возвращаемое значение

*this

[править] Пример

#include <iostream>
#include <sstream>
#include <vector>
#include <array>
 
int main()
{
    std::istringstream input("abc|def|gh");
    std::vector<std::array<char, 4>> v;
 
    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

[править] См. также

читать данные из поток ввода / вывода в строку
Оригинал:
read data from an I/O stream into a string
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(функция)
Экстракты отформатированные данные
Оригинал:
extracts formatted data
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(public функция-член) [edit]
Экстракты символов
Оригинал:
extracts characters
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(public функция-член) [edit]
извлекает блоки символов
Оригинал:
extracts blocks of characters
Текст был переведён автоматически через Google Translate.
Вы можете проверить и исправить перевод. Для инструкций кликните сюда.

(public функция-член) [edit]