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

Devuelve el número de caracteres extraídos por la última operación de entrada sin formato , o el valor máximo representable de std::streamsize si el número no es representable.

Las siguientes funciones miembro de basic_istream modifican el valor de las llamadas posteriores a gcount() :

• constructor de movimiento
• swap()
• get()
• getline()
• ignore()
• read()
• readsome()
• operator>>(basic_streambuf*)

Las siguientes funciones establecen gcount() a cero:

• constructor
• putback()
• unget()
• peek()

Parámetros

(ninguno)

Valor de retorno

El número de caracteres extraídos por la última operación de entrada sin formato, o el valor máximo representable de std::streamsize si el número no es representable.

Ejemplo

#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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.