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

std::streamsize readsome( char_type* s, std::streamsize count );

Извлекает до count немедленно доступных символов из потока ввода. Извлеченные символы сохраняются в массив символов, на который указывает s.

Ведёт себя как UnformattedInputFunction. После построения и проверки объекта sentry,

• Если rdbuf()->in_avail() == -1, вызывает setstate(eofbit) и не извлекает ни одного символа.
• Если rdbuf()->in_avail() == 0, не извлекает ни одного символа.
• Если rdbuf()->in_avail() > 0, извлекает std::min(rdbuf()->in_avail(), count) символов и сохраняет их в последовательные ячейки массива символов, первый элемент которого указан s.

Параметры

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

Количество фактически извлеченных символов.

Исключения

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

Примечания

Поведение этой функции сильно зависит от реализации. Например, при использовании с std::ifstream, некоторые реализации библиотек заполняют базовую filebuf данными сразу после открытия файла (и readsome() в таких реализациях считывает данные, потенциально, но необязательно, весь файл), в то время как другие реализации считывают данные из файла только при запросе фактической операции ввода (и readsome() , выпущенная после открытия файла, никогда не извлекает символы). Точно так же вызов std::cin.readsome() может вернуть все ожидающие необработанные данные ввода с консоли или всегда вернуть ноль и не извлечь никаких символов.

Пример

#include <iostream>
#include <sstream>
 
int main()
{
    char c[10] = {};
    std::istringstream input("This is sample text."); // std::stringbuf makes its entire
                                                      // buffer available for
                                                      // unblocking read
    input.readsome(c, 5); // reads 'This ' and stores in c[0] .. c[4]
    input.readsome(c, 9); // reads 'is sample' and stores in c[0] .. c[8]
    std::cout << c << '\n';
}

is sample

См. также