NAME

       morphinit, re_morphinit, morphstr, morphword - WordNet morphological processor functions

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:

       morphinit()  is  used  to  open the exception list files.  It returns 0 if successful, -1 otherwise.  The
       exception list files must be opened before morphstr() or morphword( are called.

       re_morphinit() is used to close the exception list files and reopen them, and  is  used  exclusively  for
       WordNet development.  Return codes are as described above.

       morphstr()  is the basic user interface to Morphy.  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.   Note
       that  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.  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.

       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.  Note that 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.

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.

       origstr may be either a word or  a  collocation  formed  by  joining  individual  words  with  underscore
       characters (_).

       Usually only morphstr() is called from applications, as it works on both words and collocations.

       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.

SEE ALSO

       wnintro(3WN), wnsearch(3WN), wndb(5WN), morphy(7WN).

WARNINGS

       Passing an invalid part of speech will result in a core dump.

       The WordNet database files must be open to use morphstr() or morphword().

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.