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

Retourne le nombre de caractères extraits par la dernière opération de saisie non formatée , ou la valeur maximale représentable de std::streamsize si le nombre n'est pas représentable.

Les fonctions membres suivantes de basic_istream modifient la valeur des appels ultérieurs à gcount() :

• constructeur de déplacement
• swap()
• get()
• getline()
• ignore()
• read()
• readsome()
• operator>>(basic_streambuf*)

Les fonctions suivantes définissent gcount() à zéro :

• constructeur
• putback()
• unget()
• peek()

Paramètres

(aucun)

Valeur de retour

Le nombre de caractères extraits par la dernière opération d'entrée non formatée, ou la valeur maximale représentable de std::streamsize si le nombre n'est pas représentable.

Exemple

#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

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.