RULEXDB_CLASSIFY(3)

📦 version 3.8.6, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 RULEXDB_CLASSIFY(3) 💖

okay so bestie, welcome to the rulexdb_classify page from the Library Functions Manual 🎀 this is a C library situation, and we're gonna vibe through it together, i promise it's not scary 💅

✨ NAME ✨

rulexdb_classify — test specified word whether it represents a lexical base

🌸 SYNOPSIS 🌸

#include <rulexdb.h>

int rulexdb_classify(RULEXDB *rulexdb, const char *s);

🦋 DESCRIPTION 🦋

okay so here's the tea 🍓 — rulexdb_classify() takes the word that s points at and tests it, trying to figure out whether it can be treated as a lexical base according to the rulexdb database that the rulexdb argument references.

that's it. that's the whole function. it's giving "is this word a lexical base or not" energy, no cap ✨

💜 RETURN VALUE 💜

this part is lowkey iconic because the logic is a lil backwards but we love her:

  • RULEXDB_SUCCESS — which is zero — comes back when the word represents no lexical base 🙈 yes bestie, zero means nope, we don't make the rules (well, this library does, and this is what it chose)
  • a positive value — RULEXDB_SPECIAL — comes back when the word can be treated as a lexical base 👑 slay
  • a negative error code — when something is wrong 😭

💀 ERRORS 💀

the negative codes you might catch, and what they mean:

  • RULEXDB_FAILURE — the referenced database has not been opened, the internal data structures are corrupted, or some other general failure has occurred. it's giving "everything is on fire" 🔥
  • RULEXDB_EMALLOC — internal memory allocation error. the malloc said no 💀
  • RULEXDB_EPARM — invalid parameters are specified. bestie check your args 🫶

🌈 SEE ALSO 🌈

the whole friend group, go say hi:

👑 AUTHOR 👑

Igor B. Poretsky <poretsky@mlbox.ru> — the main character who wrote all of this 🫶

and that's the whole page bestie, you ate it 💅 this manual page was served up on February 21, 2012 and lives under the RULEXDB_CLASSIFY(3) name, so go classify some words, periodt ✨🎀🦋

📦 where this page comes from