Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MORPH(3WN)		  WordNettm Library Functions		    MORPH(3WN)

NAME
       morphinit, re_morphinit,	morphstr, morphword

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 be-
       fore 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	subse-
       quent call to morphstr()	with a new string (instead of NULL) will over-
       write  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 char-
       acter  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 du-
       plicate the returned string into	a malloc'd buffer.

NOTES
       morphinit()  is called by wninit() and is not intended to be called di-
       rectly by an application.  Applications wishing to use  WordNet	and/or
       the morphological functions must	call wninit() at the start of the pro-
       gram.  See wnutil(3WN) for more information.

       origstr	may  be	either a word or a collocation formed by joining indi-
       vidual 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	ADJEC-
       TIVE.

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 mor-
       phword().

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.

WordNet	3.0			   Dec 2006			    MORPH(3WN)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=morph&sektion=3&manpath=FreeBSD+Ports+15.0>

home | help