StrKey Class Reference

#include <strkey.h>

Inheritance diagram for StrKey:

Collaboration diagram for StrKey:

Public Member Functions
virtual void	clearBounds () const
virtual SWKey *	clone () const
virtual int	compare (const SWKey &ikey)
virtual void	copyFrom (const SWKey &ikey)
virtual void	decrement (int steps=1)
virtual bool	equals (const SWKey &ikey)
SWDEPRECATED char	Error ()
const SWClass *	getClass () const
virtual char	getError () const
virtual long	getIndex () const
char *	getLocale () const
virtual const char *	getOSISRefRangeText () const
virtual const char *	getRangeText () const
virtual const char *	getShortRangeText () const
virtual const char *	getShortText () const
virtual const char *	getText () const
virtual void	increment (int steps=1)
virtual bool	isBoundSet () const
bool	isPersist () const
virtual bool	isTraversable () const
SWDEPRECATED char	Persist () const
SWDEPRECATED char	Persist (signed char ipersist)
virtual char	popError ()
virtual void	positionFrom (const SWKey &ikey)
virtual void	setError (char err)
virtual void	setIndex (long iindex)
void	setLocale (const char *name)
void	setPersist (bool ipersist)
virtual void	setPosition (SW_POSITION)
virtual void	setText (const char *ikey)
	StrKey (const char *ikey=0)
virtual	~StrKey ()

Public Attributes
SW_u64	userData

Protected Member Functions
SWLocale *	getPrivateLocale () const

Protected Attributes
bool	boundSet
char	error
char *	keytext
char *	localeName
const SWClass *	myClass
bool	persist
char *	rangeText

Private Member Functions
void	init ()

Detailed Description

a standard string key class (used for modules that index on single strings e.g., for lexicons and dictionaries

Definition at line 37 of file strkey.h.

Constructor & Destructor Documentation

StrKey::StrKey

(

const char *

ikey = 0

)

c-tor which initialized a StrKey object with a simple string

Parameters

ikey

text key

Definition at line 41 of file strkey.cpp.

                               : SWKey(ikey)
{
    init();
}

StrKey::~StrKey ( )

virtual

Definition at line 58 of file strkey.cpp.

                {
}

Member Function Documentation

virtual void SWKey::clearBounds ( ) const

inlinevirtualinherited

Reimplemented in VerseKey.

Definition at line 190 of file swkey.h.

{ boundSet = false; }

SWKey * SWKey::clone ( ) const

virtualinherited

Returns a new exact clone of this SWKey object. This allocates a new SWKey which must be deleted by the caller

Returns

new clone of this key

Reimplemented in VerseKey, VerseTreeKey, TreeKeyIdx, and ListKey.

Definition at line 75 of file swkey.cpp.

{
    return new SWKey(*this);
}

int SWKey::compare ( const SWKey &  ikey )

virtualinherited

Compares this key object to another SWKey object

Parameters

ikey	key to compare with this one

Returns

>0 if this key is greater than compare key; <0 if this key is smaller than compare key; 0 if the keys are the same

Reimplemented in VerseKey, TreeKey, and TreeKeyIdx.

Definition at line 218 of file swkey.cpp.

{
    return strcmp((const char *)*this, (const char *)ikey);
}

void SWKey::copyFrom ( const SWKey &  ikey )

virtualinherited

Copies as much info (position, range, etc.) as possible from another SWKey object

Parameters

ikey	other SWKey object from which to copy

Reimplemented in VerseKey, ListKey, and TreeKeyIdx.

Definition at line 173 of file swkey.cpp.

                                      {
// not desirable    Persist(ikey.Persist());
    setLocale(ikey.getLocale());
    setText((const char *)ikey);
}

void SWKey::decrement ( int  steps = 1 )

virtualinherited

Decrements key a number of entry positions This is only valid if isTraversable is true

Parameters

steps

Number of entries to jump backward

Reimplemented in VerseKey, ListKey, TreeKey, TreeKeyIdx, and VerseTreeKey.

Definition at line 261 of file swkey.cpp.

                         {
    error = KEYERR_OUTOFBOUNDS;
}

virtual bool SWKey::equals ( const SWKey &  ikey )

inlinevirtualinherited

test equality of this SWKey object's position with another SWKey

Parameters

ikey	key to compare with this one

Returns

true if the key positions are equal

Definition at line 204 of file swkey.h.

{ return !compare(ikey); }

SWDEPRECATED char SWKey::Error ( )

inlineinherited

Deprecated:

Use popError and getError instead

Definition at line 169 of file swkey.h.

{ return popError(); }

const SWClass* SWObject::getClass ( ) const

inlineinherited

Use this to get the class definition and inheritance order.

Returns

The class definition of this object

Definition at line 63 of file swobject.h.

                                    {
        return myClass;
    }

virtual char SWKey::getError ( ) const

inlinevirtualinherited

Definition at line 164 of file swkey.h.

{ return error; }

virtual long SWKey::getIndex ( ) const

inlinevirtualinherited

Use this function to get an index position within a module.

Reimplemented in VerseKey, ListKey, and TreeKey.

Definition at line 229 of file swkey.h.

{ return index; }

char* SWKey::getLocale ( ) const

inlineinherited

Definition at line 224 of file swkey.h.

{ return localeName; }

const char * SWKey::getOSISRefRangeText ( ) const

virtualinherited

Reimplemented in VerseKey, and ListKey.

Definition at line 203 of file swkey.cpp.

                                             {
    return getRangeText();
}

SWLocale * SWKey::getPrivateLocale ( ) const

protectedinherited

Definition at line 111 of file swkey.cpp.

                                        {
    if (!locale) {
        if ((!localeCache.name) || (strcmp(localeCache.name, localeName))) {
            stdstr(&(localeCache.name), localeName);
            // this line is the entire bit of work we're trying to avoid with the cache
            // worth it?  compare time examples/cmdline/search KJV "God love world" to
            // same with this method reduced to:
            // if (!local) local = ... (call below); return locale;
            localeCache.locale = LocaleMgr::getSystemLocaleMgr()->getLocale(localeName);
        }
        locale = localeCache.locale;
    }
    return locale;
}

const char * SWKey::getRangeText ( ) const

virtualinherited

Reimplemented in VerseKey, and ListKey.

Definition at line 193 of file swkey.cpp.

                                      {
    stdstr(&rangeText, keytext);
    return rangeText;
}

virtual const char* SWKey::getShortRangeText ( ) const

inlinevirtualinherited

Reimplemented in VerseKey, and ListKey.

Definition at line 187 of file swkey.h.

{ return getRangeText(); }

virtual const char* SWKey::getShortText ( ) const

inlinevirtualinherited

Reimplemented in VerseKey, and ListKey.

Definition at line 185 of file swkey.h.

{ return getText(); }

const char * SWKey::getText ( ) const

virtualinherited

returns string representation of this key

Reimplemented in VerseKey, ListKey, TreeKey, and TreeKeyIdx.

Definition at line 184 of file swkey.cpp.

                                 {
    return keytext;
}

void SWKey::increment ( int  steps = 1 )

virtualinherited

Increments key a number of entry positions This is only valid if isTraversable is true

Parameters

steps

Number of entries to jump forward

Reimplemented in VerseKey, ListKey, TreeKey, TreeKeyIdx, and VerseTreeKey.

Definition at line 248 of file swkey.cpp.

                         {
    error = KEYERR_OUTOFBOUNDS;
}

void StrKey::init ( )

private

Definition at line 47 of file strkey.cpp.

                  {
    myClass = &classdef;
}

virtual bool SWKey::isBoundSet ( ) const

inlinevirtualinherited

Definition at line 189 of file swkey.h.

{ return boundSet; }

bool SWKey::isPersist ( ) const

inherited

Gets whether this key should persist in any module to which it is set otherwise just a copy will be used in the module.

Returns

1 - persists in module; 0 - a copy is attempted

Definition at line 99 of file swkey.cpp.

{
    return persist;
}

virtual bool SWKey::isTraversable ( ) const

inlinevirtualinherited

Whether or not this key can be ++ – incremented

Reimplemented in VerseKey, ListKey, TreeKey, TreeKeyIdx, and VerseTreeKey.

Definition at line 222 of file swkey.h.

{ return false; }

SWDEPRECATED char SWKey::Persist ( ) const

inlineinherited

Deprecated:

Use isPersist

Definition at line 148 of file swkey.h.

{ return isPersist(); }

SWDEPRECATED char SWKey::Persist ( signed char  ipersist )

inlineinherited

Deprecated:

Use setPersist and isPersist instead.

Definition at line 158 of file swkey.h.

{ setPersist(ipersist!=0); return isPersist(); }

char SWKey::popError ( )

virtualinherited

Gets and clears error status

Returns

error status

Definition at line 147 of file swkey.cpp.

{
    char retval = error;

    error = 0;
    return retval;
}

virtual void SWKey::positionFrom ( const SWKey &  ikey )

inlinevirtualinherited

Reimplemented in VerseKey.

Definition at line 180 of file swkey.h.

{ copyFrom(ikey); }

virtual void SWKey::setError ( char  err )

inlinevirtualinherited

Definition at line 165 of file swkey.h.

{ error = err; }

virtual void SWKey::setIndex ( long  iindex )

inlinevirtualinherited

See documentation for Index()

Reimplemented in VerseKey, ListKey, and TreeKey.

Definition at line 233 of file swkey.h.

{ index = iindex; }

void SWKey::setLocale ( const char *  name )

inlineinherited

Definition at line 225 of file swkey.h.

{ stdstr(&localeName, name); locale = 0;    } // this will force an on demand lookup of our locale

void SWKey::setPersist ( bool  ipersist )

inherited

Sets whether this key should persist in any module to which it is set otherwise just a copy will be used in the module.

Parameters

ipersist

value which to set persist;

Definition at line 135 of file swkey.cpp.

{
    persist = ipersist;
}

void SWKey::setPosition ( SW_POSITION  p )

virtualinherited

Reimplemented in VerseKey, ListKey, TreeKey, VerseTreeKey, and TreeKeyIdx.

Definition at line 228 of file swkey.cpp.

                                     {
    switch (p) {
    case POS_TOP:
//      *this = "";
        break;
    case POS_BOTTOM:
//      *this = "zzzzzzzzz";
        break;
    } 
}

void SWKey::setText ( const char *  ikey )

virtualinherited

Sets this SWKey with a character string

Parameters

ikey	string used to set this key

Reimplemented in VerseKey, ListKey, TreeKey, and TreeKeyIdx.

Definition at line 162 of file swkey.cpp.

                                    {
    stdstr(&keytext, ikey);
}

Member Data Documentation

bool SWKey::boundSet

mutableprotectedinherited

Definition at line 104 of file swkey.h.

char SWKey::error

mutableprotectedinherited

Definition at line 106 of file swkey.h.

char* SWKey::keytext

protectedinherited

Definition at line 102 of file swkey.h.

char* SWKey::localeName

protectedinherited

Definition at line 108 of file swkey.h.

const SWClass* SWObject::myClass

protectedinherited

Definition at line 55 of file swobject.h.

bool SWKey::persist

protectedinherited

Definition at line 105 of file swkey.h.

char* SWKey::rangeText

mutableprotectedinherited

Definition at line 103 of file swkey.h.

SW_u64 SWKey::userData

inherited

Definition at line 115 of file swkey.h.

---

The documentation for this class was generated from the following files:

• include/strkey.h
• src/keys/strkey.cpp