FBB::IOStream(3bobcat)

📦
version 6.15.01 · 7 versions
, in ubuntu stonking

💖 FBB::IOStream — bestie edition 💖

okay so this is FBB::IOStream(3bobcat), and the whole ~vibe~ is "std::istream and std::ostream, but make it one girl." She's a combo class, she's the moment, and she comes to you straight from the bobcat manual. Let's get into it 🫶

✨ NAME ✨

FBB::IOStream — the class that literally just combines std::istream and std::ostream features into one iconic being. That's it. That's the name. Slay. 👑

🌈 SYNOPSIS 🌈

#include <bobcat/iostream>

Linking option: -lbobcat

🦋 DESCRIPTION 🦋

So this class combines the features of the std::istream and std::ostream classes, and the plot twist is that the std::istream and std::ostream may be physically different streams. Not a typo, not a glitch — that's the whole point, bestie. ✨

FBB:IOStream objects may, like, be associated with streams wrapped around pipes (think FBB::IfdStream and FBB::OFdStream), which is literally how you construct bi-directional pipes. Main character behavior only 💅

🎀 NAMESPACE 🎀

FBB

All constructors, members, operators and manipulators mentioned in this man-page are defined in the namespace FBB. No strays, no exceptions, all accounted for 🧚

👑 INHERITS FROM 👑

  • FBB::IOBuf (private inheritance)
  • std::istream
  • std::ostream

🌸 CONSTRUCTORS 🌸

  • IOStream() — the default constructor. It constructs an empty FBB::IOStream object. ⚠️ Do not use it before its open member (see below) has been called, fr fr. It's giving "empty until activated."
  • IOStream(std::istream &in, std::ostream &out) — this constructor associates the IOStream object with a std::istream and a std::ostream. Every output operation gets passed on to the std::ostream, every input operation goes to the std::istream. The streams passed to IOStream should outlive the IOStream object. 😭 This constructor performs the actions of the default constructor and then calls the IOStream::open member.
Copy and move constructors (and assignment operators) are not available. Not on the menu. Do not ask. 🚫

💅 MEMBER FUNCTIONS 💅

All members of std::istream and std::ostream are available, because FBB::IOStream inherits from these classes. Periodt.

And here's the cute part: when switching between std::istream and std::ostream operations, no intermediate seekg() or seekp() operation will normally be required, since the base classes will normally be associated with physically different streams. No extra steps, no drama, we love a seamless transition 🔥

  • void open(std::istream &in, std::ostream &out) — this member (re)associates the IOStream object with a std::istream and a std::ostream. All output operations will be passed on to the std::ostream, all input operations to the std::istream. The streams passed to IOStream() should outlive the IOStream object. 🫶 And heads up: if this member is called for an IOStream object that's already associated with an std::ostream object, the already associated std::ostream object is flushed before setting up the new association. Clean exit, no leftovers ✨
  • void clear() — this member clears the error states of the associated std::istream and std::ostream objects. Emotional reset button, honestly 🌸

⭐ EXAMPLE ⭐

See the example provided with process(3bobcat). (Yes, it's a whole cross-reference moment, go look 👀)

🍓 FILES 🍓

  • bobcat/iostream — defines the class interface

🌈 SEE ALSO 🌈

bobcat(7), ifdstream(3bobcat), iobuf(3bobcat), ofdstream(3bobcat), process(3bobcat)

💀 BUGS 💀

None Reported. (Not me being shocked — she's literally perfect, no notes 🙈)

🎀 BOBCAT PROJECT FILES 🎀

Debian Bobcat project files:

  • libbobcat6 — debian package containing the shared library, changelog and copyright note;
  • libbobcat-dev — debian package containing the static library, headers, manual pages, and developer info;

🦋 BOBCAT 🦋

Bobcat is an acronym of `Brokken’s Own Base Classes And Templates’. (iykyk 😌)

This is free software, distributed under the terms of the GNU General Public License (GPL). Free as in "go off, bestie" ✨

🌸 AUTHOR 🌸

Frank B. Brokken (f.b.brokken@rug.nl). Legend behavior, honestly 👑

okay that's the whole page, bestie!! this is the FBB::IOStream(3bobcat) page from libbobcat-dev_6.15.01, dated 2005-2026 — shoutout to the bobcat era from 2005 all the way through 2026, a true long-running queen 🎀💖✨

📦 where this page comes from