lname_component(3)

💖 lname_component(3) — Erlang Module Definition 💖

okay bestie, welcome to lname_component, the manual page nobody warned you about but honestly? kinda iconic. it lives in the Erlang Module Definition section of the man pages, and it's here to make your life cute and representation-independent. let's get into it 🫶

---

✨ NAME ✨

lname_component — the interface that supports the name pseudo-objects. yes, "pseudo-objects". it's giving mysterious. it's giving main character. slay.

---

🌸 DESCRIPTION 🌸

so here's the tea, bestie: this interface is part of the name library, and the whole point of that library is to hide how names are actually represented. sneaky? no, thoughtful. 💅

in Orber's Erlang mapping, the pseudo-object names and the real IDL names literally have the same representation — same vibes, same shape. but the way it should go is that clients use the names library, so they never become dependent on that representation. it's giving "don't get attached to implementation details, bestie, they will not text you back." 😭

the lname_component interface handles name components — think get and set of the struct members. very demure. very mindful. ✨

🎀 important note, no cap: the lname_component interface in Orber does not contain a destroy function. why? because the NameComponents are represented as Erlang records, and therefore they get removed by the garbage collector when they're not in use anymore. the garbage collector is the cleanup crew and honestly? she ate. 🗑️💖

the type NameComponent used below is defined as:

-record('CosNaming_NameComponent', {id, kind=""}).

id and kind are strings. 🍓

the record is defined in the file CosNaming.hrl, and you include it like this:

-include_lib("orber/COSS/CosNaming/CosNaming.hrl").

---

👑 EXPORTS 👑

💜 create() -> Return

Types:

Return = NameComponent

this function returns a new name component. fresh out the box, brand new, no notes. ✨

---

💜 get_id(NameComponent) -> Return

Types:

Return = string()

this function returns the id string of a name component. just the id, bestie, nothing extra. 🎀

---

💜 set_id(NameComponent, Id) -> Return

Types:

Id = string()
Return = NameComponent

this function sets the id string of a name component and returns the component. so it does the thing and hands it back to you. generous behavior, honestly. 🫶

---

💜 get_kind(NameComponent) -> Return

Types:

Return = string()

this function returns the id string of a name component. (yes, the manpage says id string here too — I'm not gonna lie to you, I'm reporting it exactly as written, fr fr. 💀) same energy as the line above it, the docs said what they said.

---

💜 set_kind(NameComponent, Kind) -> Return

Types:

Kind = string()
Return = NameComponent

this function sets the kind string of a name component and returns the component. set it, get it back, iconic. 🌈

---

that's the whole page, bestie. every function, every type, every string, every record — accounted for. you understood the assignment. 💅

cute lil sign-off: this masterpiece of documentation is brought to you by Ericsson AB, shipping with orber 5.2.2. go forth and handle your name components with main character energy. mwah. 💖✨🎀🦋