diff options
Diffstat (limited to 'doc/api-documentation/man/man3/versekey.3')
-rw-r--r-- | doc/api-documentation/man/man3/versekey.3 | 650 |
1 files changed, 0 insertions, 650 deletions
diff --git a/doc/api-documentation/man/man3/versekey.3 b/doc/api-documentation/man/man3/versekey.3 deleted file mode 100644 index bc77131..0000000 --- a/doc/api-documentation/man/man3/versekey.3 +++ /dev/null @@ -1,650 +0,0 @@ -.TH "VerseKey" 3 "5 Oct 2001" "The Sword Project" \" -*- nroff -*- -.ad l -.nh -.SH NAME -VerseKey \- Class VerseKey The \fBSWKey\fR implementation used for verse based modules like Bibles or commentaries. -.SH SYNOPSIS -.br -.PP -\fC#include <versekey.h>\fR -.PP -Inherits \fBSWKey\fR. -.PP -.SS Public Methods - -.in +1c -.ti -1c -.RI "\fBVerseKey\fR (const char *ikey=0)" -.br -.RI "\fIVerseKey Constructor - initializes Instance of VerseKey.\fR" -.ti -1c -.RI "\fBVerseKey\fR (const \fBSWKey\fR *ikey)" -.br -.RI "\fIVerseKey Constructor - initializes instance of VerseKey.\fR" -.ti -1c -.RI "\fBVerseKey\fR (const char *min, const char *max)" -.br -.RI "\fIVerseKey Constructor - initializes instance of VerseKey with boundariess - see also \fBLowerBound\fR and \fBUpperBound\fR.\fR" -.ti -1c -.RI "\fBVerseKey\fR (VerseKey const &k)" -.br -.RI "\fIVerseKey Copy Constructor - will create a new VerseKey based on an existing one.\fR" -.ti -1c -.RI "virtual \fB~VerseKey\fR ()" -.br -.RI "\fIVerseKey Destructor Cleans up an instance of VerseKey.\fR" -.ti -1c -.RI "VerseKey& \fBLowerBound\fR (const char *lb)" -.br -.RI "\fIsets the lower boundary for this VerseKey and returns the new boundary.\fR" -.ti -1c -.RI "VerseKey& \fBUpperBound\fR (const char *ub)" -.br -.RI "\fIsets the upper boundary for this VerseKey and returns the new boundary.\fR" -.ti -1c -.RI "VerseKey& \fBLowerBound\fR () const" -.br -.RI "\fIgets the lower boundary of this VerseKey.\fR" -.ti -1c -.RI "VerseKey& \fBUpperBound\fR () const" -.br -.RI "\fIgets the upper boundary of this VerseKey.\fR" -.ti -1c -.RI "void \fBClearBounds\fR ()" -.br -.RI "\fIclears the boundaries of this VerseKey.\fR" -.ti -1c -.RI "virtual \fBSWKey\fR* \fBclone\fR () const" -.br -.RI "\fICreates a new \fBSWKey\fR based on the current VerseKey see also the Copy Constructor.\fR" -.ti -1c -.RI "virtual const char* \fBgetText\fR () const" -.br -.RI "\fIrefreshes keytext before returning if cast to a (char *) is requested.\fR" -.ti -1c -.RI "virtual void \fBsetText\fR (const char *ikey)" -.br -.RI "\fIEquates this \fBSWKey\fR to a character string.\fR" -.ti -1c -.RI "virtual void \fBcopyFrom\fR (const \fBSWKey\fR &ikey)" -.br -.RI "\fIEquates this \fBSWKey\fR to another \fBSWKey\fR object.\fR" -.ti -1c -.RI "virtual void \fBcopyFrom\fR (const VerseKey &ikey)" -.br -.RI "\fIEquates this VerseKey to another VerseKey.\fR" -.ti -1c -.RI "virtual void \fBsetPosition\fR (SW_POSITION)" -.br -.RI "\fIPositions this key.\fR" -.ti -1c -.RI "virtual void \fBdecrement\fR (int step)" -.br -.RI "\fIDecrements key a number of verses.\fR" -.ti -1c -.RI "virtual void \fBincrement\fR (int step)" -.br -.RI "\fIIncrements key a number of verses.\fR" -.ti -1c -.RI "virtual char \fBTraversable\fR ()" -.br -.ti -1c -.RI "virtual char \fBTestament\fR () const" -.br -.RI "\fIGets testament.\fR" -.ti -1c -.RI "virtual char \fBBook\fR () const" -.br -.RI "\fIGets book.\fR" -.ti -1c -.RI "virtual int \fBChapter\fR () const" -.br -.RI "\fIGets chapter.\fR" -.ti -1c -.RI "virtual int \fBVerse\fR () const" -.br -.RI "\fIGets verse.\fR" -.ti -1c -.RI "virtual char \fBTestament\fR (char itestament)" -.br -.RI "\fISets/gets testament.\fR" -.ti -1c -.RI "virtual char \fBBook\fR (char ibook)" -.br -.RI "\fISets/gets book.\fR" -.ti -1c -.RI "virtual int \fBChapter\fR (int ichapter)" -.br -.RI "\fISets/gets chapter.\fR" -.ti -1c -.RI "virtual int \fBVerse\fR (int iverse)" -.br -.RI "\fISets/gets verse.\fR" -.ti -1c -.RI "virtual void \fBNormalize\fR (char autocheck=0)" -.br -.RI "\fIchecks limits and normalizes if necessary (e.g.\fR" -.ti -1c -.RI "virtual char \fBAutoNormalize\fR (char iautonorm=MAXPOS(char))" -.br -.RI "\fISets/gets flag that tells VerseKey to automatically normalize itself when modified.\fR" -.ti -1c -.RI "virtual char \fBHeadings\fR (char iheadings=MAXPOS(char))" -.br -.RI "\fISets/gets flag that tells VerseKey to include chapter/book/testament/module headings.\fR" -.ti -1c -.RI "virtual long \fBNewIndex\fR () const" -.br -.ti -1c -.RI "virtual long \fBIndex\fR () const" -.br -.RI "\fIGets index based upon current verse.\fR" -.ti -1c -.RI "virtual long \fBIndex\fR (long iindex)" -.br -.RI "\fISets index based upon current verse.\fR" -.ti -1c -.RI "virtual \fBListKey\fR \fBParseVerseList\fR (const char *buf, const char *defaultKey="Genesis 1:1", bool expandRange=false)" -.br -.ti -1c -.RI "virtual int \fBcompare\fR (const \fBSWKey\fR &ikey)" -.br -.RI "\fICompares another \fBSWKey\fR object.\fR" -.ti -1c -.RI "virtual int \fB_compare\fR (const VerseKey &ikey)" -.br -.RI "\fICompares another VerseKey object.\fR" -.ti -1c -.RI "virtual void \fBsetBookAbbrevs\fR (const struct abbrev *bookAbbrevs, unsigned int size=0)" -.br -.ti -1c -.RI "virtual void \fBsetBooks\fR (const char *iBMAX, struct sbook **ibooks)" -.br -.ti -1c -.RI "virtual void \fBsetLocale\fR (const char *name)" -.br -.ti -1c -.RI "virtual SWKEY_OPERATORS \fBSWKey\fR& \fBoperator=\fR (const VerseKey &ikey)" -.br -.in -1c -.SS Public Attributes - -.in +1c -.ti -1c -.RI "const char* \fBBMAX\fR" -.br -.ti -1c -.RI "struct sbook** \fBbooks\fR" -.br -.in -1c -.SS Static Public Attributes - -.in +1c -.ti -1c -.RI "const char \fBbuiltin_BMAX\fR [2]" -.br -.ti -1c -.RI "struct sbook* \fBbuiltin_books\fR [2]" -.br -.ti -1c -.RI "const struct abbrev \fBbuiltin_abbrevs\fR []" -.br -.in -1c -.SS Private Methods - -.in +1c -.ti -1c -.RI "int \fBgetBookAbbrev\fR (char *abbr)" -.br -.ti -1c -.RI "void \fBinitBounds\fR () const" -.br -.ti -1c -.RI "void \fBinitstatics\fR ()" -.br -.RI "\fIinitialize and allocate books array.\fR" -.ti -1c -.RI "void \fBinit\fR ()" -.br -.RI "\fIinitializes this \fBVerseKey\fR().\fR" -.ti -1c -.RI "void \fBfreshtext\fR () const" -.br -.RI "\fIRefresh keytext based on testament|book|chapter|verse default auto normalization to true default display headings option is false.\fR" -.ti -1c -.RI "virtual char \fBparse\fR ()" -.br -.RI "\fIParse a character array into testament|book|chapter|verse.\fR" -.ti -1c -.RI "int \fBfindindex\fR (long *array, int size, long value)" -.br -.RI "\fIBinary search to find the index closest, but less than the given value.\fR" -.in -1c -.SS Private Attributes - -.in +1c -.ti -1c -.RI "\fBListKey\fR \fBinternalListKey\fR" -.br -.ti -1c -.RI "const struct abbrev* \fBabbrevs\fR" -.br -.ti -1c -.RI "int \fBabbrevsCnt\fR" -.br -.ti -1c -.RI "char \fBtestament\fR" -.br -.RI "\fIThe Testament: 0 - Old; 1 - New.\fR" -.ti -1c -.RI "char \fBbook\fR" -.br -.ti -1c -.RI "int \fBchapter\fR" -.br -.ti -1c -.RI "int \fBverse\fR" -.br -.ti -1c -.RI "char \fBautonorm\fR" -.br -.RI "\fIflag for auto normalization.\fR" -.ti -1c -.RI "char \fBheadings\fR" -.br -.RI "\fIflag for headings on/off.\fR" -.ti -1c -.RI "VerseKey* \fBlowerBound\fR" -.br -.ti -1c -.RI "VerseKey * \fBupperBound\fR" -.br -.in -1c -.SS Static Private Attributes - -.in +1c -.ti -1c -.RI "\fBSWClass\fR \fBclassdef\fR" -.br -.ti -1c -.RI "long* \fBoffsets\fR [2][2]" -.br -.ti -1c -.RI "int \fBoffsize\fR [2][2]" -.br -.ti -1c -.RI "int \fBinstance\fR" -.br -.RI "\fInumber of instantiated VerseKey objects or derivitives.\fR" -.ti -1c -.RI "struct sbook \fBotbooks\fR []" -.br -.ti -1c -.RI "struct sbook \fBntbooks\fR []" -.br -.ti -1c -.RI "long \fBotbks\fR []" -.br -.ti -1c -.RI "long \fBotcps\fR []" -.br -.ti -1c -.RI "long \fBntbks\fR []" -.br -.ti -1c -.RI "long \fBntcps\fR []" -.br -.ti -1c -.RI "int \fBvm\fR []" -.br -.ti -1c -.RI "LocaleCache \fBlocaleCache\fR" -.br -.in -1c -.SH DETAILED DESCRIPTION -.PP -Class VerseKey The \fBSWKey\fR implementation used for verse based modules like Bibles or commentaries. -.PP -Definition at line 66 of file versekey.h. -.SH CONSTRUCTOR & DESTRUCTOR DOCUMENTATION -.PP -.SS VerseKey::VerseKey (const char * ikey = 0) -.PP -VerseKey Constructor - initializes Instance of VerseKey. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIikey\fR\fR -text key (will take various forms of 'BOOK CH:VS'. See \fBparse\fR for more detailed information) -.SS VerseKey::VerseKey (const \fBSWKey\fR * ikey) -.PP -VerseKey Constructor - initializes instance of VerseKey. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIikey\fR\fR -base key (will take various forms of 'BOOK CH:VS'. See \fBparse\fR for more detailed information) -.SS VerseKey::VerseKey (const char * min, const char * max) -.PP -VerseKey Constructor - initializes instance of VerseKey with boundariess - see also \fBLowerBound\fR and \fBUpperBound\fR. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fImin\fR\fR -the lower boundary of the new VerseKey -.TP -\fB\fImax\fR\fR -the upper boundary of the new VerseKey -.SS VerseKey::VerseKey (VerseKey const & k) -.PP -VerseKey Copy Constructor - will create a new VerseKey based on an existing one. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIk\fR\fR -the VerseKey to copy from -.SH MEMBER FUNCTION DOCUMENTATION -.PP -.SS char VerseKey::AutoNormalize (char iautonorm = MAXPOS (char))\fC [virtual]\fR -.PP -Sets/gets flag that tells VerseKey to automatically normalize itself when modified. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIiautonorm\fR\fR -value which to set autonorm [MAXPOS(char)] - only get -.PP -\fBReturns: \fR -.in +1c -if unchanged -> value of autonorm, if changed -> previous value of autonorm -.SS char VerseKey::Book (char ibook)\fC [virtual]\fR -.PP -Sets/gets book. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIibook\fR\fR -value which to set book [MAXPOS(char)] - only get -.PP -\fBReturns: \fR -.in +1c -if unchanged -> value of book, if changed -> previous value of book -.SS char VerseKey::Book () const\fC [virtual]\fR -.PP -Gets book. -.PP -\fBReturns: \fR -.in +1c -value of book -.SS int VerseKey::Chapter (int ichapter)\fC [virtual]\fR -.PP -Sets/gets chapter. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIichapter\fR\fR -value which to set chapter [MAXPOS(int)] - only get -.PP -\fBReturns: \fR -.in +1c -if unchanged -> value of chapter, if changed -> previous value of chapter -.SS int VerseKey::Chapter () const\fC [virtual]\fR -.PP -Gets chapter. -.PP -\fBReturns: \fR -.in +1c -value of chapter -.SS char VerseKey::Headings (char iheadings = MAXPOS (char))\fC [virtual]\fR -.PP -Sets/gets flag that tells VerseKey to include chapter/book/testament/module headings. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIiheadings\fR\fR -value which to set headings [MAXPOS(char)] - only get -.PP -\fBReturns: \fR -.in +1c -if unchanged -> value of headings, if changed -> previous value of headings -.SS long VerseKey::Index (long index)\fC [virtual]\fR -.PP -Sets index based upon current verse. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIiindex\fR\fR -value to set index to -.PP -\fBReturns: \fR -.in +1c -offset -.PP -Reimplemented from \fBSWKey\fR. -.SS long VerseKey::Index () const\fC [virtual]\fR -.PP -Gets index based upon current verse. -.PP -\fBReturns: \fR -.in +1c -offset -.PP -Reimplemented from \fBSWKey\fR. -.SS VerseKey & VerseKey::LowerBound () const -.PP -gets the lower boundary of this VerseKey. -.PP -\fBReturns: \fR -.in +1c -the lower boundary of this VerseKey -.SS VerseKey & VerseKey::LowerBound (const char * lb) -.PP -sets the lower boundary for this VerseKey and returns the new boundary. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIlb\fR\fR -the new lower boundary for this VerseKey -.PP -\fBReturns: \fR -.in +1c -the lower boundary the key was set to -.SS void VerseKey::Normalize (char autocheck = 0)\fC [virtual]\fR -.PP -checks limits and normalizes if necessary (e.g. -.PP -Matthew 29:47 = Mark 2:2). If last verse is exceeded, key is set to last Book CH:VS -.PP -\fBReturns: \fR -.in +1c -*this -.SS char VerseKey::Testament (char itestament)\fC [virtual]\fR -.PP -Sets/gets testament. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIitestament\fR\fR -value which to set testament [MAXPOS(char)] - only get -.PP -\fBReturns: \fR -.in +1c -if unchanged -> value of testament, if changed -> previous value of testament -.SS char VerseKey::Testament () const\fC [virtual]\fR -.PP -Gets testament. -.PP -\fBReturns: \fR -.in +1c -value of testament -.SS VerseKey & VerseKey::UpperBound () const -.PP -gets the upper boundary of this VerseKey. -.PP -\fBReturns: \fR -.in +1c -the upper boundary of this VerseKey -.SS VerseKey & VerseKey::UpperBound (const char * ub) -.PP -sets the upper boundary for this VerseKey and returns the new boundary. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIlb\fR\fR -the new upper boundary for this VerseKey -.PP -\fBReturns: \fR -.in +1c -the upper boundary the key was set to -.SS int VerseKey::Verse (int iverse)\fC [virtual]\fR -.PP -Sets/gets verse. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIiverse\fR\fR -value which to set verse [MAXPOS(int)] - only get -.PP -\fBReturns: \fR -.in +1c -if unchanged -> value of verse, if changed -> previous value of verse -.SS int VerseKey::Verse () const\fC [virtual]\fR -.PP -Gets verse. -.PP -\fBReturns: \fR -.in +1c -value of verse -.SS int VerseKey::_compare (const VerseKey & ikey)\fC [virtual]\fR -.PP -Compares another VerseKey object. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIikey\fR\fR -key to compare with this one -.PP -\fBReturns: \fR -.in +1c ->0 if this VerseKey is greater than compare VerseKey, <0 if this VerseKey is smaller than compare VerseKey, 0 if the keys are the same -.SS int VerseKey::compare (const \fBSWKey\fR & ikey)\fC [virtual]\fR -.PP -Compares another \fBSWKey\fR object. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIikey\fR\fR -key to compare with this one -.PP -\fBReturns: \fR -.in +1c ->0 if this VerseKey is greater than compare \fBSWKey\fR, <0 if this VerseKey is smaller than compare \fBSWKey\fR, 0 if the keys are the same -.PP -Reimplemented from \fBSWKey\fR. -.SS virtual void VerseKey::copyFrom (const \fBSWKey\fR & ikey)\fC [virtual]\fR -.PP -Equates this \fBSWKey\fR to another \fBSWKey\fR object. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIikey\fR\fR -other swkey object -.PP -Reimplemented from \fBSWKey\fR. -.SS void VerseKey::decrement (int step)\fC [virtual]\fR -.PP -Decrements key a number of verses. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIdecrement\fR\fR -Number of verses to jump backward -.PP -\fBReturns: \fR -.in +1c -*this -.PP -Reimplemented from \fBSWKey\fR. -.SS int VerseKey::findindex (long * array, int size, long value)\fC [private]\fR -.PP -Binary search to find the index closest, but less than the given value. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIarray\fR\fR -long * to array to search -.TP -\fB\fIsize\fR\fR -number of elements in the array -.TP -\fB\fIvalue\fR\fR -value to find -.PP -\fBReturns: \fR -.in +1c -the index into the array that is less than but closest to value -.SS void VerseKey::increment (int step)\fC [virtual]\fR -.PP -Increments key a number of verses. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIincrement\fR\fR -Number of verses to jump forward -.PP -\fBReturns: \fR -.in +1c -*this -.PP -Reimplemented from \fBSWKey\fR. -.SS void VerseKey::setPosition (SW_POSITION)\fC [virtual]\fR -.PP -Positions this key. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIp\fR\fR -position -.PP -\fBReturns: \fR -.in +1c -*this -.PP -Reimplemented from \fBSWKey\fR. -.SS void VerseKey::setText (const char * ikey)\fC [inline, virtual]\fR -.PP -Equates this \fBSWKey\fR to a character string. -.PP -\fBParameters: \fR -.in +1c -.TP -\fB\fIikey\fR\fR -string to set this key to -.PP -Reimplemented from \fBSWKey\fR. -.PP -Definition at line 228 of file versekey.h. - -.SH AUTHOR -.PP -Generated automatically by Doxygen for The Sword Project from the source code.
\ No newline at end of file |