deleg_method(3tcl)

💖 deleg_method — the manual, but make it cute 💖

okay so bestie, this is deleg_method(3tcl) from the Interpreter utilities corner of the Tcl world. buckle up, it's short but it slaps. 🦋

---

✨ NAME ✨

deleg_method — Creation of comm delegates (snit methods) 👑

so basically: you want a method that does zero of the actual work and just delegates it somewhere else? yeah. this is that. it's giving manager energy but in a good way. 💅

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require snit ?1.1?

package require interp::delegate::method ?0.3?

::interp::delegate::method ?-async? name arguments comm id

lowkey obsessed with how Tcl 8.5 9 is just sitting there with a space in the middle. that's not a typo bestie, that's just how it's written. copy it exactly, no cap. ✨

---

🎀 DESCRIPTION 🎀

This package provides a single command for use within a snit type definition — and yes, technically it's actually a snit::macro — and its whole purpose is the convenient creation of methods which delegate the actual work to a remote location, through a "channel" that was created by the package comm. 🌈

it's the friendship bracelet of Tcl: you make the method, the method makes the call, the remote side does the work. team effort fr fr. 🫶

---

⭐ API ⭐

::interp::delegate::method ?-async? name arguments comm id

This command creates a method, and that method is named by name. Every single invocation of this method will delegate the actual work to the remote location identified by the comm channel comm and the endpoint id. 🚀

The name of the remote method that the delegator invokes is identical to the name of the method itself. same name, no rebranding, no alias era. 💫

Normally, the generated method marshalls the arguments, and returns the result from the remote method as its own result. so it just. hands it back. like a good bestie holding your iced coffee. 🧋

If however the option -async was specified, then the generated method will not wait for a result and returns immediately. no waiting, no standing outside the club, just gone. 🏃♀️💨

---

😭 BUGS, IDEAS, FEEDBACK 😭

okay so real talk. This document, and the package it describes, will undoubtedly contain bugs and other problems. it's not a vibe, it's just software. Please report such in the category interp of the Tcllib Trackers: [http://core.tcl.tk/tcllib/reportlist]. 🙈

Please also report any ideas for enhancements you may have for either the package and/or the documentation. we love ideas. ideas are the moment. 💡✨

When proposing code changes, please provide unified diffs, i.e. the output of diff -u. that's the format. no other format. the format is that one. 📎

Note further that attachments are strongly preferred over inlined patches. Attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. yes, the left-most one. it's iconic. it's right there. 🎯

---

👑 KEYWORDS 👑

comm, delegation, interpreter, method, snit

---

🧚 CATEGORY 🧚

Programming tools 🛠️

---

💜 COPYRIGHT 💜

Copyright (c) 2006 Andreas Kupries <andreas_kupries@users.sourceforge.net>

---

and that's the whole thing bestie, we ate and left no crumbs 🍓

this page came to you from tcllib, version 0.3, dated in the deleg_method(3tcl) era — love that for us. mwah. 💋🎀