W3cubDocs

/C++

std::basic_streambuf::sgetc

int_type sgetc();

Reads one character from the input sequence.

If the input sequence read position is not available, returns underflow(). Otherwise returns Traits::to_int_type(*gptr()).

Parameters

(none).

Return value

The value of the character pointed to by the get pointer.

Example

#include <iostream>
#include <sstream>
 
int main()
{
    std::stringstream stream("Hello, world");
    std::cout << "sgetc() returned '" << (char)stream.rdbuf()->sgetc() << "'\n"
              << "peek() returned '" << (char)stream.peek() << "'\n"
              << "get() returned '" << (char)stream.get() << "'\n";
}

Output:

sgetc() returned 'H'
peek() returned 'H'
get() returned 'H'

See also

 reads one character from the input sequence and advances the sequence
(public member function)
advances the input sequence, then reads one character without advancing again
(public member function)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
http://en.cppreference.com/w/cpp/io/basic_streambuf/sgetc