ost::Strin...::iterator(3)

📦 version 1.8.1, in ubuntu jammy

💖 ost::Strin...::iterator(3) — Library Functions Manual 💖

okay bestie, buckle up, we're reading the ost::StringTokenizer::iterator manpage from the Library Functions Manual and honestly? she's a lil icon. let's get into it ✨

🌸 NAME 🌸

ost::StringTokenizer::iterator — the input forward iterator for tokens. that's her. that's the whole job. 💅

🦋 SYNOPSIS 🦋

#include <tokenizer.h>

✨ Public Member Functions ✨

  • iterator () — the plain default constructor, no drama 💖
  • virtual ~iterator () — the destructor, virtual as always, doing her lil cleanup 🎀
  • iterator (const iterator &i) — copy constructor. yes queen, duplicate thyself 💅
  • iterator & operator= (const iterator &i) — assignment operator. one iterator becomes another's whole personality 🫶
  • iterator & operator++ () THROWS(NoSuchElementException) — shifts this iterator to the next token in the string. the way she just moves on to the next one 😌
  • const char * operator* () THROWS(NoSuchElementException) — returns the immutable string this iterator points to or '0' if no token is available (i.e. …) ⭐
  • char nextDelimiter () const — returns the next delimiter after the current token or ' ', if there are no following delimiters. peeking ahead, nosy but make it useful 🙈
  • bool operator== (const iterator &other) const — compares to other iterator. are we the same? 👯
  • bool operator!= (const iterator &other) const — compares to other iterator. are we not the same? 💀

👑 Friends 👑

  • class StringTokenizer — friendship bracelet acquired 🫶

🧚 Detailed Description 🧚

The input forward iterator for tokens. that's the vibe. forward-only, token-by-token, no going back bestie, we live in the now ✨

💜 Author 💜

  • Henner Zeller — thank you for your service, king 👑

🎀 Constructor & Destructor Documentation 🎀

ost::StringTokenizer::iterator::iterator () [inline]

the default one. no args, no notes, just vibes 🌸

virtual ost::StringTokenizer::iterator::~iterator () [inline], [virtual]

the destructor, and she's virtual, as she should be 💅

ost::StringTokenizer::iterator::iterator (const iterator & i) [inline]

copy constructor. literally clone her, no cap 💖

⭐ Member Function Documentation ⭐

char ost::StringTokenizer::iterator::nextDelimiter () const [inline]

returns the next delimiter after the current token or '\0', if there are no following delimiters. It returns the very next delimiter (even if skipAllDelim=true).

heads up bestie, the SYNOPSIS up top says ' ' for the no-following-delimiters case and this detailed bit says '\0' — that's just what the page says, both versions, no edits from me, iykyk 😭 keep it in mind fr fr

bool ost::StringTokenizer::iterator::operator!= (const iterator & other) const [inline]

compares to other iterator. Usually used to compare against the end() iterator. the classic "are we done yet" check, main character energy 👑

const char* ost::StringTokenizer::iterator::operator* ()

returns the immutable string this iterator points to or '0' if no token is available (i.e. i == end()). Do not store pointers to this token, since it is invalidated for each iteration. If you need the token, copy it (e.g. with strdup());

⚠️ for real, do NOT hoard that pointer. she gets invalidated every single iteration. if you want to keep the token, copy it — like with strdup(). storing the raw pointer is giving chaos 💀

iterator& ost::StringTokenizer::iterator::operator++ ()

shifts this iterator to the next token in the string. moving forward, always forward 🦋

iterator& ost::StringTokenizer::iterator::operator= (const iterator & i) [inline]

assignment operator. she is now her. slay 💅

bool ost::StringTokenizer::iterator::operator== (const iterator & other) const [inline]

compares to other iterator. Usually used to compare against the end() iterator. same energy check ✨

friend class StringTokenizer [friend]

bestie privileges: fully granted. StringTokenizer is in the group chat 🫶

💖 Author 💖

Generated automatically by Doxygen for GNU CommonC++ from the source code. not a human hand in sight, and yet she ate 🔥

and that's the whole page bestie, no cap, every flag and every function accounted for 🌸💅✨

okay so this page comes from GNU CommonC++, dated Sun Dec 27 2020, and it lives at ost::Strin...::iterator(3) in the manual — mwah, go forth and tokenize responsibly 👑💖🎀

📦 where this page comes from