| |
| |
|
|
| <HTML> |
| <HEAD> |
| <TITLE>MORPH(3WN) manual page</TITLE> |
| </HEAD> |
| <BODY> |
| <A HREF="#toc">Table of Contents</A><P> |
| |
| <H2><A NAME="sect0" HREF="#toc0">NAME </A></H2> |
| morphinit, re_morphinit, morphstr, morphword |
| <H2><A NAME="sect1" HREF="#toc1">SYNOPSIS </A></H2> |
| <P> |
| <B>#include |
| "wn.h" </B> <P> |
| <B>int morphinit(void); </B> <P> |
| <B>int re_morphinit(void); </B> <P> |
| <B>char *morphstr(char |
| *origstr, int pos); </B> <P> |
| <B>char *morphword(char *word, int pos); </B> |
| <H2><A NAME="sect2" HREF="#toc2">DESCRIPTION |
| </A></H2> |
| <P> |
| The WordNet morphological processor, Morphy, is accessed through these |
| functions: <P> |
| <B>morphinit()</B> is used to open the exception list files. It returns |
| <B>0 </B> if successful, <B>-1 </B> otherwise. The exception list files must be opened |
| before <B>morphstr() </B> or <B>morphword()</B> are called. <P> |
| <B>re_morphinit()</B> is used to |
| close the exception list files and reopen them, and is used exclusively |
| for WordNet development. Return codes are as described above. <P> |
| <B>morphstr()</B> |
| is the basic user interface to Morphy. It tries to find the base form |
| (lemma) of the word or collocation <I>origstr </I> in the specified <I>pos </I>. The |
| first call (with <I>origstr </I> 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 <FONT SIZE=-1><B>NULL. </B></FONT> |
| When no more base forms |
| for <I>origstr </I> can be found, <FONT SIZE=-1><B>NULL </B></FONT> |
| is returned. Note that <B>morphstr() </B> returns |
| a pointer to a static character buffer. A subsequent call to <B>morphstr() |
| </B> with a new string (instead of <B>NULL </B>) 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 <B>strdup </B> to duplicate the returned |
| string into a <I>malloc'd </I> buffer. <P> |
| <B>morphword()</B> tries to find the base form |
| of <I>word </I> in the specified <I>pos </I>. This function is called by <B>morphstr()</B> for |
| each individual word in a collocation. Note that <B>morphword() </B> returns a |
| pointer to a static character buffer. A subsequent call to <B>morphword() |
| </B> 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 |
| <B>strdup </B> to duplicate the returned string into a <I>malloc'd </I> buffer. |
| <H2><A NAME="sect3" HREF="#toc3">NOTES |
| </A></H2> |
| <B>morphinit()</B> is called by <B>wninit() </B> and is not intended to be called directly |
| by an application. Applications wishing to use WordNet and/or the morphological |
| functions must call <B>wninit() </B> at the start of the program. See <B><A HREF="wnutil.3WN.html">wnutil</B>(3WN)</A> |
| |
| for more information. <P> |
| <I>origstr </I> may be either a word or a collocation formed |
| by joining individual words with underscore characters (<B>_ </B>). <P> |
| Usually only |
| <B>morphstr() </B> is called from applications, as it works on both words and |
| collocations. <P> |
| <I>pos </I> must be one of the following: <P> |
| <blockquote><B>1 </B><tt> </tt> <tt> </tt> NOUN <BR> |
| <B>2 </B><tt> </tt> <tt> </tt> VERB <BR> |
| <B>3 </B><tt> </tt> <tt> </tt> ADJECTIVE |
| <BR> |
| <B>4 </B><tt> </tt> <tt> </tt> ADVERB <BR> |
| <B>5 </B><tt> </tt> <tt> </tt> ADJECTIVE_SATELLITE <BR> |
| </blockquote> |
| <P> |
| If <FONT SIZE=-1><B>ADJECTIVE_SATELLITE </B></FONT> |
| is passed, |
| it is treated by <B>morphstr() </B> as <FONT SIZE=-1><B>ADJECTIVE. </B></FONT> |
| |
| <H2><A NAME="sect4" HREF="#toc4">SEE ALSO </A></H2> |
| <B><A HREF="wnintro.3WN.html">wnintro</B>(3WN)</A> |
| , <B><A HREF="wnsearch.3WN.html">wnsearch</B>(3WN)</A> |
| , |
| <B><A HREF="wndb.5WN.html">wndb</B>(5WN)</A> |
| , <B><A HREF="morphy.7WN.html">morphy</B>(7WN)</A> |
| . <P> |
| |
| <H2><A NAME="sect5" HREF="#toc5">WARNINGS </A></H2> |
| Passing an invalid part of speech will |
| result in a core dump. <P> |
| The WordNet database files must be open to use |
| <B>morphstr() </B> or <B>morphword(). <P> |
| </B> |
| <H2><A NAME="sect6" HREF="#toc6">BUGS </A></H2> |
| 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 <B>plantes </B> to <B>plants </B>. <P> |
|
|
| <HR><P> |
| <A NAME="toc"><B>Table of Contents</B></A><P> |
| <UL> |
| <LI><A NAME="toc0" HREF="#sect0">NAME</A></LI> |
| <LI><A NAME="toc1" HREF="#sect1">SYNOPSIS</A></LI> |
| <LI><A NAME="toc2" HREF="#sect2">DESCRIPTION</A></LI> |
| <LI><A NAME="toc3" HREF="#sect3">NOTES</A></LI> |
| <LI><A NAME="toc4" HREF="#sect4">SEE ALSO</A></LI> |
| <LI><A NAME="toc5" HREF="#sect5">WARNINGS</A></LI> |
| <LI><A NAME="toc6" HREF="#sect6">BUGS</A></LI> |
| </UL> |
| </BODY></HTML> |
|
|
