Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::basic_streambuf<CharT,Traits>::sgetc

Reads one character from the input sequence.

NotebookLM
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

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

See also

(removed in C++17)
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)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.