find(3itcl)

💖 NAME 💖

itcl::find — bestie's lil search party for classes and objects 🔍✨

---

🦋 SYNOPSIS 🦋

itcl::find option ?arg arg ...?

---

✨ DESCRIPTION ✨

Okay so, the find command is literally your group-chat search bar but for classes and objects that are chilling in the current interpreter. Classes and objects get reported first in the active namespace, and then in all the other namespaces in the interpreter. So it's giving "locals first, then everyone else" energy. 👑

The option argument is what decides which action actually goes down. The legal options are below, and yes bestie, they may be abbreviated — shorthand is valid, we love efficiency. 💅

🌸 find classes ?pattern?

Returns a list of [incr Tcl] classes. Classes in the current namespace get listed first, followed by classes in all other namespaces in the interpreter. 🎀

If you pass the optional pattern, then the reported names get compared using the rules of the "string match" command, and only the matching names get reported. No stragglers. Periodt.

Now here's the tea on naming, because it's lowkey important: if a class resides in the current namespace context, this command reports its simple name — no qualifiers, just the bare name, fresh-faced and unbothered. ✨ BUT if the pattern contains :: qualifiers, or if the class lives in another context, then this command reports its fully-qualified name. So basically, to get yourself a list where every single name is fully-qualified, you run:

itcl::find classes ::*

Iconic. Saved you the guesswork. 🫶

🌈 find objects ?pattern? ?-class className? ?-isa className?

Returns a list of [incr Tcl] objects. Objects in the current namespace get listed first, followed by objects in all other namespaces in the interpreter. Same vibe as above, but for objects this time. 🦋

• If the optional pattern is specified, the reported names get compared using the rules of the "string match" command, and only matching names get reported. ✅
• If the optional -class parameter is specified, this list gets restricted to objects whose most-specific class is className. 🎯
• If the optional -isa parameter is specified, this list gets further restricted to objects having the given className anywhere in their heritage. Like, anywhere in the family tree, we don't gatekeep ancestry. 🌳

And the same name rules apply, fr fr: if an object resides in the current namespace context, this command reports its simple name — without any qualifiers. However, if the pattern contains :: qualifiers, or if the object resides in another context, this command reports its fully-qualified name. So for a list where all the names are fully-qualified, hit it with:

itcl::find objects ::*

Main character command behavior, honestly. 👑

---

💜 KEYWORDS 💜

class, object, search, import

---

Bestie reminder: this is the itcl::find page from itcl 3.0, dated back in the day — so if you're citing it, that's the source and version, mwah. 💋

okay that's the whole page, you're fully caught up, go find some classes and slay 💅✨🎀🦋