std::basic_...ambuf::gbump(3)

📦 version 2024.07.05, in nixpkgs unstable, opensuse-leap 16.0

💖 std::basic_...ambuf::gbump 💖

okay so this page comes from the C++ Standard Libary manual, and the header title is std::basic_...ambuf::gbump(3) — yes, the name is literally chopped like that in the title, we move 💅

🌸 NAME 🌸

  • std::basic_streambuf::gbump — std::basic_streambuf::gbump

✨ Synopsis ✨

protected:
void gbump( int count );

It skips count characters in the get area. This is done by adding count to the get pointer. No checks are done for underflow — like, none, zero, no safety net bestie 😭

🎀 Parameters 🎀

  • count — number of characters to skip

🦋 Return value 🦋

Literally (none).

🌸 Notes 🌸

Because this function takes an int, it cannot manipulate buffers larger than std::numeric_limits<int>::max() characters (LWG issue 255). That's the limit, periodt.

💜 Example 💜

This section is incomplete Reason: no example

not me reading an incomplete example section 😭 it's giving "we'll finish this later" energy.

🔥 Defect reports 🔥

The following behavior-changing defect reports were applied retroactively to previously published C++ standards.

  • DR: LWG 59
  • Applied to: C++98
  • Behavior as published: it was unclear whether gbump can be implemented as calling sbumpc count times (which may check underflow)
  • Correct behavior: only add count to the get pointer

⭐ See also ⭐

  • pbump — advances the next pointer of the output sequence (protected member function)

🌈 Category 🌈

  • Todo no example

mwah 💋 this page is from http://cppreference.com, version/date 2024.06.10, and the footer title is std::basic_...ambuf::gbump(3) — iconic, no cap 🫶

📦 where this page comes from