std::basic_...mbuf::stossc(3)

🎀 NAME 🎀

okay so this is the std::basic_...mbuf::stossc(3) page, and it lives in the C++ Standard Libary manual (yes, that's the spelling on the page — no cap). The NAME line lists std::basic_streambuf::sbumpc,std::basic_streambuf::stossc and then repeats the same pair after the dash. Both functions are the main characters here. 💅

✨ Synopsis ✨

int_type sbumpc(); (1)
void stossc();     (2) (deprecated in C++98)
                       (removed in C++17)

The core vibe: reads one character and advances the input sequence by one character. 🦋

1. If the input sequence read position is not available, it returns uflow(). Otherwise it returns Traits::to_int_type(*gptr()).
2. Same as (1), but the result gets discarded. Also — important — this one is deprecated in C++98 and removed in C++17, so it's giving legacy energy. 💀

🌸 Parameters 🌸

None. Zero. Zilch. The page literally says (none). 🫶

💖 Return value 💖

1. The value of the character pointed to by the get pointer, or Traits::eof() if the read position is not available.

That's the return for sbumpc; stossc does the same thing but discards the result. ✨

🎀 Example 🎀

This section is incomplete Reason: no example

No example bestie, that's just what the page says. 😭

🦋 See also 🦋

• sgetc — reads one character from the input sequence without advancing the sequence (public member function)
• snextc — advances the input sequence, then reads one character without advancing again (public member function)

🌈 Category 🌈

Category: * Todo no example — that's the tag, fr fr. 👑

Source/version and date check: http://cppreference.com, 2024.06.10. That's the whole footer folded into this cute little bye. Mwah 💋🦋