basic_istream::gcount

[metoda] Zwraca liczbę znaków odczytanych przez ostatnią niesformatowaną operację wejścia.

Składnia

#include <iostream>

namespace std
{
template < class CharT, class Traits = std::char_traits < CharT >>
class basic_istream
: virtual public std::basic_ios < CharT, Traits >
{
public:
std::streamsize gcount() const;
};
}

Zwracana wartość

Liczba znaków odczytanych przez ostatnią niesformatowaną operację wejścia.

Opis szczegółowy

Zwraca liczbę znaków odczytanych przez ostatnią niesformatowaną operację wejścia.
Poniższe metody składowe klasy basic_istream zmieniają wartość kolejnych wywołań

gcount()

konstruktor przeniesienia
swap()
get()
getline()
ignore()
read()
readsome()
operator>>(basic_streambuf*)

Poniższe metody ustawiają

gcount()

na zero:

konstruktor
putback()
unget()
peek()

Dodatkowe informacje

Dostęp do obiektu strumienia.
Jednoczesny dostęp do tego samego obiektu strumienia może powodować data races.
Używa

basic_istream::get()

do odczytywania niesformatowanych znaków.

Rzucane wyjątki

Jeśli wyjątek jest rzucany, w strumieniu nie zaszły zmiany.

Przykłady

#include <iostream>
#include <sstream>

int main()
{
char x[ 20 ];
std::istringstream stream( "Hello World" );

stream.read( x, sizeof x );
std::cout << "Wydobyte znaki: " << stream.gcount();
}

Standardowe wyjście programu:

Wydobyte znaki: 11

#include <iostream>

int main() {
char str[ 20 ];

std::cout << "Prosze, wprowadz slowo: ";
std::cin.getline( str, 20 );
std::cout << std::cin.gcount() << " odczytanych znaków: " << str << '\n';

return 0;
}

Przykładowe wyjście programu:

Prosze, wprowadz slowo: simplify
9 odczytanych znaków: simplify

Zagadnienia powiązane

peek	Odczytuje następny znak bez pobierania go. (metoda)

Linki zewnętrzne

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.