YAJLTCL(3tcl)

💖 yajltcl — bestie's guide to the Tcl binding for YAJL 💖

okay so this is the manual page for yajltcl, from section 3tcl of the manual — it's the Tcl binding to YAJL, which is a JSON messages parser and generator. literally JSON in, JSON out, all from your fave scripting language. no cap. 🦋

---

✨ NAME ✨

yajltcl</purgle> — Tcl binding to YAJL, a JSON messages parser and generator. that's the whole vibe. 🎀

---

🌸 SYNOPSIS 🌸

package require yajltcl
set yajl [yajltcl <cmdname>] or
set yail [yajltcl #auto]

yes bestie, #auto is the auto-generated-name move, and yes, the second variable is spelled yail in the original and we are keeping it exactly like that. periodt.

---

👑 DESCRIPTION 👑

so the plan is: create your yajltcl object like the synopsis above, then invoke that object with one or more methods. the methods are generated left to right. some of them take no arguments and some take exactly one. here's the whole squad:

• array_open — start an array 🫶
• array_close — end an array 🫶
• clear — clears the buffer but does not reset the parser's state (ngl the original is not sure how useful this one is either, and we're just passing that along fr fr) 💀
• bool — add a boolean, value follows ✨
• double — add a double precision floating point value, value follows ✨
• integer — add an integer value, value follows ✨
• number — add a numeric value, value follows ✨

🚨 important precision tea: with respect to double, yajl internally formats that only with "%g", which gives you six digits of precision, and this is not currently configurable via YAJL. if you need higher precision, use format or equivalent, coupled with yajltcl's number method. that's the workaround, bestie, that's the move. 💅

• map_open — open a map 🗺️
• map_close — close a map 🗺️
• null — insert a null value 🕳️
• free — nothing yet (iconic honestly, it's just vibing) 🙈
• get — get the JSON generated so far. it clears the generator buffer, but maintains state so you can keep going, i.e. stream it. 🌊
• reset — free, reallocate and configure the yajl generator object 🔄

and the full method roster, in the original order, is: array_open, array_close, bool, clear, double, integer, map_close, map_open, null, number, string, free, get, and reset. 🎀

---

🔍 PARSING 🔍

as of version 1.2, yajltcl can also parse... 🦋

set list [$object parse $json]

and List will be as above. that's it, that's the parse. ⭐

---

🌈 YAJLTCL LIBRARY ROUTINES 🌈

add_array_to_json jsonObject arrayName

append a Tcl array into the specified json object by doing a JSON map open and then storing the array as key-value pairs and then doing a map close. example usage:

set json [yajl create #auto]
add_array_to_json $json array
puts [$json get]
rename $json ""

array_to_json arrayName

return the contents of the array as JSON text. 💖

add_pgresult_tuples_to_json jsonObject res

append a JSON array of JSON objects of a Postgres result, one array entry per tuple in the result, with the non-null values set in each row object. 🐘✨

pg_select_to_json conn sql

given a postgres connection handle and a sql select statement, perform the select and return the results of the select as JSON text. 🐘🔥

---

and that's the whole page, bestie!! 🫶 this was written by the yajltcl crew and it's dated December 3, 2019, and the manual section is YAJLTCL(3tcl). go forth and generate some JSON, you absolute main character. 💅🎀🌈