SAFE_ADD_ID_TO_LIST(3)

💖 safe_add_id_to_list(3) / SAFE_ADD_ID_TO_LIST(3) — the safe_id_range_list bestie page 💖

okay so bestie, welcome to the SAFE_ADD_ID_TO_LIST(3) manual page. This is the one about adding an id or a whole range of ids to the list. It’s giving “tiny utility, big main character energy.” ✨

---

🌸 NAME 🌸

safe_add_id_to_list, safe_add_id_range_to_list — add an id or range of ids to the list. 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_add_id_to_list(safe_id_range_list list, id_t id);
int safe_add_id_range_to_list(safe_id_range_list list, id_t min_id, id_t max_id);

---

🎀 DESCRIPTION 🎀

safe_add_id_to_list adds a single id to list. One id. One little icon. Slay. 💖

safe_add_id_range_to_list adds a range of ids to list. The min_id must be less than or equal to max_id, no cap. 🫶

🧚 Parameters 🧚

• list — the safe_id_range_list to add values to. The value must be non-NULL. Like, literally must not be NULL, bestie. 🫠
• id — the id to add. That’s it. That’s the whole job. ✨
• min_id, max_id — the range of ids to add. The min_id must be less than or equal to the max_id. 🔥

---

🌈 RETURN VALUE 🌈

returns 0 on success and -1 on failure with errno set appropriately. That’s the vibe check: 0 = we ate, -1 = check errno. 💀

---

🍓 ERRORS 🍓

• EINVAL — the list parameter was NULL, or, in safe_add_id_range_to_list, min_id was greater than max_id. 🚩
• ENOMEM — failed to allocate memory. The memory allocation said “not today,” and honestly? relatable. 😭

---

👑 AUTHOR 👑

James A. Kupsch. Icon behavior. 💜

---

⭐ SEE ALSO ⭐

• safe_init_id_range_list(3)
• safe_destroy_id_range_list(3)
• http://research.cs.wisc.edu/mist/safefile

---

🧚‍♀️💖 cute little sign-off: this page’s footer is serving 2011-07-26 and SAFE_ADD_ID_TO_LIST(3) energy — source/version and date noted, bestie, periodt. 💅🎀