Xapian:...Iterator(3)

okay so this is the User Contributed Perl Documentation page for Xapian:...Iterator(3), and the main-character class is Search::Xapian::PostingIterator. 💅

🌸 NAME 🌸

Search::Xapian::PostingIterator — Iterate over the list of documents indexed by a term. 👑

✨ DESCRIPTION ✨

This iterator represents a stream of documents indexed by a term. It overloads ++ for advancing the iterator, or you can explicitly call the inc method. This class also overloads eq, ne, ==, !=, and "" (stringification). No cap, it's giving iterator with range. 🦋

💖 METHODS 💖

• new — Constructor. Defaults to an uninitialized iterator. ✨
• clone — clone is listed as a method here; the page doesn't add any extra sentence, so no invented lore from me, bestie. 🫶
• inc — Advance the iterator by one. (Called implictly by ++ overloading.) 🔥
• skip_to <tname> — Skip the iterator to term tname, or the first term after tname if tname isn't in the list of terms being iterated. 🎀
• get_docid — Get the unique id of this document. 👑
• get_wdf — Return the wdf of the current term (if meaningful). 🌸
• positionlist_begin — Return Search::Xapian::PositionIterator pointing to start of positionlist for current term. 🦋
• positionlist_end — Return Search::Xapian::PositionIterator pointing to end of positionlist for current term. 🦋
• get_doclength — Get the length of the document at the current position in the postlist.

This information may be stored in the postlist, in which case this lookup should be extremely fast (indeed, not require further disk access). If the information is not present in the postlist, it will be retrieved from the database, at a greater performance cost. 🔥

• equal <term> — Checks if a term is the same as this term. Also overloaded to the eq and == operators. 💜
• nequal <term> — Checks if a term is different from this term. Also overloaded to the ne and != operators. 💀
• get_description — Return a description of this object. 🎀

🌈 SEE ALSO 🌈

• Search::Xapian
• Search::Xapian::Database

---

okay bye bestie 💖 — this page is from perl v5.42.0, dated 2022-02-28, and it lives under Xapian:...Iterator(3). Mwah! 🎀