MORPH(3WN)

💖 MORPH(3WN) — the WordNet™ morphological processor girlies 💖

okay bestie so this is the WordNet™ Library Functions page for the morphology squad: morphinit, re_morphinit, morphstr, morphword. Morphy is the little engine that finds base forms, and she's serving. 🧚✨

---

🦋 NAME

morphinit, re_morphinit, morphstr, morphword — the WordNet morphological processor functions. that's the whole friend group. no cap. 💅

---

🌸 SYNOPSIS

#include "wn.h"

int morphinit(void);

int re_morphinit(void);

char *morphstr(char *origstr, int pos);

char *morphword(char *word, int pos);

---

✨ DESCRIPTION

The WordNet morphological processor, Morphy, is accessed through these functions, and she is literally the moment:

• morphinit() — used to open the exception list files. returns 0 if successful, -1 otherwise. bestie, the exception list files must be opened before morphstr() or morphword() are called. do not skip this step, i am begging. 🫶
• re_morphinit() — used to close the exception list files and reopen them, and it is used exclusively for WordNet development. return codes are as described above (so 0 good, -1 not good). this one is for the devs only, iykyk. 🔥
• morphstr() — the basic user interface to Morphy, the main character fr. it tries to find the base form (lemma) of the word or collocation origstr in the specified pos. the first call (with origstr specified) returns a pointer to the first base form found. subsequent calls requesting base forms of the same string must be made with the first argument of NULL. when no more base forms for origstr can be found, NULL is returned. ✨

🚨 okay so listen: morphstr() returns a pointer to a static character buffer. a subsequent call to morphstr() with a new string (instead of NULL) will overwrite the string pointed to by a previous call. so users should copy the returned string into a local buffer, or use the C library function strdup to duplicate the returned string into a malloc'd buffer. do NOT get caught holding that pointer, she's not yours. 💀

• morphword() — tries to find the base form of word in the specified pos. this function is called by morphstr() for each individual word in a collocation. and yeah, same warning energy: morphword() returns a pointer to a static character buffer. a subsequent call to morphword() will overwrite the string pointed to by a previous call. users should copy the returned string into a local buffer, or use the C library function strdup to duplicate the returned string into a malloc'd buffer. copy her or lose her. 😭

---

💜 NOTES

• morphinit() is called by wninit() and is not intended to be called directly by an application. applications wishing to use WordNet and/or the morphological functions must call wninit() at the start of the program. see wnutil(3WN) for more information. let wninit() do her thing, she's got it. 👑
• origstr may be either a word or a collocation formed by joining individual words with underscore characters (_). underscores are the glue, periodt. 🎀
• usually only morphstr() is called from applications, as it works on both words and collocations. she's the versatile one. 🌈
• pos must be one of the following:

       1    NOUN
       2    VERB
       3    ADJECTIVE
       4    ADVERB
       5    ADJECTIVE_SATELLITE

• if ADJECTIVE_SATELLITE is passed, it is treated by morphstr() as ADJECTIVE. same vibe, different label. ⭐

---

🌟 SEE ALSO

wnintro(3WN), wnsearch(3WN), wndb(5WN), morphy(7WN). go read the whole friend group, they're all iconic. 📚

---

⚠️ WARNINGS

💀 passing an invalid part of speech will result in a core dump. not the cute kind of crash. pick a real pos bestie, i'm serious.

🔥 the WordNet database files must be open to use morphstr() or morphword(). no database, no service.

---

🙈 BUGS

Morphy will allow non-words to be converted to words, if they follow one of the rules described above. for example, it will happily convert plantes to plants. she's unbothered, she's thriving, she does not fact-check. 💅

---

that's the whole page, bestie! mwah! 💖✨🎀

this has been WordNet 3.0, dated Dec 2006, from your girl MORPH(3WN) — stay morphological, stay iconic, and always copy that static buffer. 🦋👑🌈