delete(n)

✨ NAME ✨

itcl::delete — bestie, this is the command that deletes things in the interpreter 💅

🦋 SYNOPSIS 🦋

itcl::delete option ?arg arg ...?

🌸 DESCRIPTION 🌸

Okay so delete is the command you use to delete things in the interpreter, no cap. The way that it works is it's implemented as an ensemble, which means extensions can add their own options and extend the behavior of this command. By default though, delete handles the destruction of namespaces. That's its whole main character job.

The option argument is what decides which action the command actually carries out. The legal options — and yes, they may be abbreviated, so you can be lazy, we support that — are:

• delete class name ?name...? — deletes one or more [incr Tcl] classes called name. This nukes all objects in the class, and all derived classes as well. Like, the whole family tree, gone 🙈

If an error is encountered while destructing an object, it will prevent the destruction of the class and any remaining objects. So if you want to destroy the entire class without regard for errors, use the delete namespace command instead. Periodt.

• delete object name ?name...? — deletes one or more [incr Tcl] objects called name. An object gets deleted by invoking all destructors in its class hierarchy, in order from most- to least-specific. If all the destructors are successful, the data associated with the object is deleted and the name is removed as a command from the interpreter. Clean exit, slay ✨

If the access command for an object resides in another namespace, then its qualified name can be used:

itcl::delete object foo::bar::x

If an error is encountered while destructing an object, the delete command is aborted and the object remains alive 😭. To destroy an object without regard for errors, use the rename command to destroy the object access command. Different tool, different vibe.

• delete namespace name ?name...? — deletes one or more namespaces called name. This deletes all commands and variables in the namespace, and deletes all child namespaces as well — yes, the children too, it's giving generational. When a namespace is deleted, it is automatically removed from the import lists of all other namespaces. So tidy, so iconic 👑

💜 KEYWORDS 💜

namespace, proc, variable, ensemble

okay bestie that's the whole page 🫶 go forth and delete responsibly (or recklessly, i'm not your mom). this was itcl version 3.0, the delete(n) page, brought to you with love and also a lil bit of chaos 🎀💖✨