SAFE_INIT_ID_RANGE_LIST(3)

📦 version 1.0.5, in nixos 26.05, nixpkgs unstable

🌸 NAME 🌸

safe_init_id_range_list, safe_destroy_id_range_list — create and destroy id range lists. This is the SAFE_INIT_ID_RANGE_LIST(3) manual page, section 3, and it's literally the setup-and-cleanup bestie duo. Periodt.

✨ SYNOPSIS ✨

#include "safe_id_range_list.h"

struct safe_id_range_list;
typedef struct safe_id_range_list safe_id_range_list;

int  safe_init_id_range_list(safe_id_range_list list);
void safe_destroy_id_range_list(safe_id_range_list list);

🦋 DESCRIPTION 🦋

Okay so safe_init_id_range_list initializes a safe_id_range_list structure. This function must be called before the function can be used — don't skip the setup era, bestie. Slay the initialization.

safe_destroy_id_range_list frees the memory used by a safe_id_range_list data structure, and it should be called after all uses of the safe_id_range_list structure are complete. Cleanup queen behavior only. 💅

🎀 Parameters 🎀

  • list — the safe_id_range_list to operate on. The value must be non-NULL. No NULL shenanigans, okay? 🙈

🔥 RETURN VALUE 🔥

safe_init_id_range_list returns 0 on success and -1 on failure.

safe_destroy_id_range_list returns nothing. In the case of an error, errno is set appropriately. Noted, bestie.

💀 ERRORS 💀

  • EINVAL — the list parameter was NULL.
  • ENOMEM — safe_init_id_range_list failed to allocate memory.

If you see these, it's giving "read the error and fix the setup." 🫶

👑 AUTHOR 👑

James A. Kupsch — author, icon, legend.

🌈 SEE ALSO 🌈

http://research.cs.wisc.edu/mist/safefile

mwah 💋 this page is dated 2011-07-26 and lives under SAFE_INIT_ID_RANGE_LIST(3) — go forth and init/destroy responsibly, bestie 🫶✨

📦 where this page comes from