Tcl_GetVersion(3tcl)

📦
version 9.0.4 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 Tcl_GetVersion — bestie, let's find out what version of Tcl you're actually running 💖

okay so real talk: this is the Tcl Library Procedures page for Tcl_GetVersion, and if you've ever been like "wait, which Tcl am I even talking to rn??" — this is the function for you. it's giving runtime identity crisis solved. ✨

🌸 NAME 🌸

Tcl_GetVersion — get the version of the library at runtime

like. that's it. that's the whole job. she tells you what version you got. 💅

✨ SYNOPSIS ✨

#include <tcl.h>

Tcl_GetVersion(major, minor, patchLevel, type)

🎀 ARGUMENTS 🎀

  • int *major (out) — the major version number of the Tcl library. the big number. the main character. 👑
  • int *minor (out) — the minor version number of the Tcl library. the lil' sidekick number.
  • int *patchLevel (out) — the patch level of the Tcl library. (or, if we're in pre-release era, the alpha or beta number. slay either way.) 🦋
  • int *type (out) — the type of release, which also tells you what that patch level number actually means. it can be one of TCL_ALPHA_RELEASE, TCL_BETA_RELEASE, or TCL_FINAL_RELEASE. no cap, those are the only three options bestie. 🌈

💫 DESCRIPTION 💫

so Tcl_GetVersion is what you call when you need to query the version number of the Tcl library at runtime. this is so useful when you're working with a dynamically loaded Tcl library, or when you're writing a stubs-aware extension. iykyk. 🫶

here's the scenario that'll ruin your day if you don't check: say you write an extension that's linked against the Tcl stubs library. it could get loaded into a program that's linked to an older version of Tcl than you expected. 😭 not the vibe. so you use Tcl_GetVersion to verify that fact, and possibly to change the behavior of your extension. knowing is half the battle, bestie. 💪

and here's the cute part — Tcl_GetVersion accepts NULL for any of the arguments. so for instance, if you do not care about the patchLevel of the library, just pass a NULL for the patchLevel argument. she doesn't mind. she's flexible like that. 🙈

🍓 KEYWORDS 🍓

version, patchlevel, major, minor, alpha, beta, release

and that's the whole page, bestie — short, sweet, and absolutely iconic. this was the Tcl manual, version 7.5, for Tcl_GetVersion(3tcl). go forth and check your versions before you ship. periodt. 💅✨

📦 where this page comes from