IXP_API(3)

📦 version 0-unstable-2022-04, in nixos 26.05, nixpkgs unstable

✨ IXP_API(3) ✨

okay bestie, welcome to IXP_API(3) from the libixp Library Functions Manual — we're here to talk API version macros and honestly they ate. 💅

🎀 NAME 🎀

The whole squad:

  • IXP_API
  • IXP_NEEDAPI
  • IXP_MAXAPI
  • IXP_ASSERT_VERSION

🦋 SYNOPSIS 🦋

#include <ixp.h>

#define IXP_API ...

#define IXP_NEEDAPI ...

#define IXP_MAXAPI ...

#define IXP_ASSERT_VERSION ...

🌸 DESCRIPTION 🌸

IXP_API contains the current libixp API revision number. That's it, that's the queen. 👑

  • IXP_NEEDAPI — if you define this before ixp.h is included, it directs the header to present an older version of the libixp API. This lets code written for older versions of libixp compile against newer versions without modification. It does not, however, ensure that it will link against a different version of libixp than the ixp.h header belongs to. 🫠
⚠️ bestie, read that caveat again: IXP_NEEDAPI does not ensure it will link against a different version of libixp than the ixp.h header belongs to. No cap.
  • IXP_MAXAPI — if you define this before ixp.h is included, it prevents code from compiling with a newer version of libixp than specified. It's giving "respect my limit" energy. 🛑
  • IXP_ASSERT_VERSION — when inserted into any function, it ensures that the resulting object will fail to link link against any version of libixp with a different API version than it was compiled against. Yes, the page really says "link link" — iconic. 💀

xoxo 💋 — libixp Manual, 2012 Dec 🫶

📦 where this page comes from