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

std::streamsize gcount() const;

Возвращает количество символов, извлечённых последней неформатированной операцией ввода, или максимальное представимое значение std::streamsize, если это количество не может быть представлено.

Следующие функции-члены basic_istream изменяют значение, возвращаемое последующими вызовами gcount():

• конструктор перемещения
• swap()
• get()
• getline()
• ignore()
• read()
• readsome()
• operator>>(basic_streambuf*)

Следующие функции устанавливают gcount() в ноль:

• конструктор
• putback()
• unget()
• peek()

Параметры

(нет)

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

Количество символов, извлечённых последней неформатированной операцией ввода, или максимальное представимое значение std::streamsize, если это количество не может быть представлено.

Пример

#include <iostream>
#include <sstream>
 
int main()
{
    char x[20];
    std::istringstream stream("Hello World");
    
    stream.read(x, sizeof x);
    std::cout << "Characters extracted: " << stream.gcount();
}

Characters extracted: 11

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

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