RULEXDB_REMOVE_ITEM(3)

💖 RULEXDB_REMOVE_ITEM(3) 💖

okay bestie, we're in the Library Functions Manual and this one's a lil delete-button moment, so let's get into it 🎀

---

✨ NAME ✨

rulexdb_remove_item — remove specified item from the rulex dictionary

---

🌸 SYNOPSIS 🌸

#include <rulexdb.h>

int rulexdb_remove_item(RULEXDB *rulexdb, const char *key, int item_type);

---

💅 DESCRIPTION 💅

so the rulexdb_remove_item() function does exactly what it says on the tin — it removes a lexical item for the specified key from the dictionary dataset defined by the item_type argument. and item_type can be one of these two icons 👑

• RULEXDB_LEXBASE — remove the item from the Implicit dictionary. 🫶
• RULEXDB_EXCEPTION — remove the item from the Explicit dictionary. ✨

lowkey important: the data type has to be specified explicitly. the value RULEXDB_DEFAULT is not allowed here, no exceptions, periodt 💀

and the rulexdb argument references the database we're dealing with, obviously 🦋

---

🌈 RETURN VALUE 🌈

so rulexdb_remove_item() returns:

• RULEXDB_SUCCESS — which is zero — when the specified item was successfully removed 🎉 slay
• a positive value, RULEXDB_SPECIAL — when no record exists for the specified key (it's giving "girl there's nothing here") 🙈
• a negative error code — when it's any other kind of failure 😭

---

💀 ERRORS 💀

• RULEXDB_FAILURE — the referenced database has not been opened, internal data structures are corrupted, or some other general failure has occurred. bestie, this is the vague "something's wrong" of error codes 🫠
• RULEXDB_EINVKEY — invalid key specified. nope, not that one 💅
• RULEXDB_EPARM — the argument rulexdb or item_type has an invalid value. check your inputs bestie 🙈
• RULEXDB_EACCESS — the database is not opened for updating. so you literally cannot delete anything from it rn 🔥

---

🦋 SEE ALSO 🦋

• rulexdb_classify(3)
• rulexdb_close(3)
• rulexdb_dataset_name(3)
• rulexdb_discard_dictionary(3)
• rulexdb_discard_ruleset(3)
• rulexdb_fetch_rule(3)
• rulexdb_lexbase(3)
• rulexdb_load_ruleset(3)
• rulexdb_open(3)
• rulexdb_remove_rule(3)
• rulexdb_remove_this_item(3)
• rulexdb_retrieve_item(3)
• rulexdb_search(3)
• rulexdb_seq(3)
• rulexdb_subscribe_item(3)
• rulexdb_subscribe_rule(3)

---

👑 AUTHOR 👑

Igor B. Poretsky <poretsky@mlbox.ru>. king behavior, no cap 🫶

---

and that's the whole page bestie 💜 this lil masterpiece dropped on February 20, 2012, and it's filed under RULEXDB_REMOVE_ITEM(3) in the Library Functions Manual — iconic, historic, and fr fr useful. mwah 🎀✨