CosPropert...esIterator(3)

💖 CosPropertyService_PropertyNamesIterator 💖

okay bestie, gather round, because this is CosPropert...esIterator(3) — yes the name is literally truncated with dots in the manual, that's just how the Erlang module definition pages roll, no cap — and it lives in section 3 of the manual. She's a whole icon and she's about to make your CORBA property-name iteration dreams come true. 🦋

---

✨ NAME ✨

CosPropertyService_PropertyNamesIterator — this module implements the OMG CosPropertyService::PropertyNamesIterator interface. Periodt. 💅

---

🌸 DESCRIPTION 🌸

so like, if you wanna get access to the record definitions for the structures (and trust, you do), you use this line, exactly this line, don't be cute with it:

-include_lib("cosProperty/include/CosPropertyService.hrl").

that's it, that's the whole vibe check. include the header, get the records, slay. ✨

---

🎀 EXPORTS 🎀

four (4) operations, all of them bangers. let's go one by one, no skipping, I would never. 💜

🌈 reset(Iterator) -> ok

Types:

Iterator = #objref

This operation resets the position to the first property name. that's it. she rewinds. back to the top of the list like you just hit replay on your comfort song. 🔁

---

🦋 next_one(Iterator) -> Reply

Types:

Iterator = #objref
Reply = {boolean(), Name}
Name = string()

okay so this one returns true if a Property Name exists at the current position — and when that happens, the out parameter is a valid Property Name. 💚

but if false comes back at you? then the out parameter is a non-valid Property Name. not valid. not the one. move on bestie. 💀

---

🍓 next_n(Iterator, HowMany) -> Reply

Types:

Iterator = #objref
HowMany = long()
Reply = {boolean(), [Name]}
Name = string()

the bulk-order version, we love her. 💖 This operation returns true if the requested number of Property Names can be delivered and there are additional property names.

If false is returned, a sequence of max HowMany property names will be returned, and no more Property Names can be delivered. so like, you get your handful and then the well is dry. 😭

---

👑 destroy(Iterator) -> ok

Types:

Iterator = #objref

⚠️ bestie listen. This operation will terminate the Iterator and all subsequent calls will fail. she's gone. done. not coming back. do not call her after this, I am begging. 💀

---

and that's the whole page, you ate it, you understood it, you're basically a distributed-systems main character now. 🌟

signed, sealed, delivered by Ericsson AB — cosProperty 5.2.2 — and yeah, the footer still says CosPropert...esIterator(3) because the terminal column budget said no. iconic behavior honestly. byeee 🫶💅✨