SWSearchable Class Reference

#include <swsearchable.h>

Inheritance diagram for SWSearchable:

[legend]

List of all members.

Public Member Functions
virtual signed char	createSearchFramework (void(*percent)(char, void *)=&nullPercent, void *percentUserData=0)
virtual void	deleteSearchFramework ()
virtual bool	hasSearchFramework ()
virtual bool	isSearchOptimallySupported (const char *istr, int searchType, int flags, SWKey *scope)
virtual ListKey &	search (const char *istr, int searchType=0, int flags=0, SWKey *scope=0, bool *justCheckIfSupported=0, void(*percent)(char, void *)=&nullPercent, void *percentUserData=0)=0
	SWSearchable ()
virtual	~SWSearchable ()
Static Public Member Functions
static void	nullPercent (char percent, void *userData)

---

Detailed Description

used to provide an interface for objects that be searched.

Definition at line 35 of file swsearchable.h.

---

Constructor & Destructor Documentation

SWSearchable::SWSearchable

(

)

Definition at line 30 of file swsearchable.cpp.

                           {
}

SWSearchable::~SWSearchable

(

)

[virtual]

Definition at line 34 of file swsearchable.cpp.

                            {
}

---

Member Function Documentation

signed char SWSearchable::createSearchFramework	(	void(*)(char, void *)	percent = &nullPercent,
		void *	percentUserData = 0
	)			[virtual]

ask the object to build any indecies it wants for optimal searching

Reimplemented in SWModule.

Definition at line 38 of file swsearchable.cpp.

                                                                                                    {
    return 0;
}

void SWSearchable::deleteSearchFramework

(

)

[virtual]

Reimplemented in SWModule.

Definition at line 43 of file swsearchable.cpp.

                                         {
}

virtual bool SWSearchable::hasSearchFramework

(

)

[inline, virtual]

was SWORD compiled with code to optimize searching for this driver?

Reimplemented in SWModule.

Definition at line 87 of file swsearchable.h.

{ return false; }

bool SWSearchable::isSearchOptimallySupported	(	const char *	istr,
		int	searchType,
		int	flags,
		SWKey *	scope
	)			[virtual]

Check if the search is optimally supported (e.g. if index files are presnt and working) This function checks whether the search framework may work in the best way.

Returns:

true if the the search is optimally supported, false if it's not working in the best way.

Definition at line 47 of file swsearchable.cpp.

                                                                                                       {
    bool retVal = false;
    search(istr, searchType, flags, scope, &retVal);
    return retVal;
}

SWORD_NAMESPACE_START void SWSearchable::nullPercent	(	char	percent,
		void *	userData
	)			[static]

This is the default callback function for searching. This function is a placeholder and does nothing. You can define your own function for search progress evaluation, and pass it over to Search().

Definition at line 28 of file swsearchable.cpp.

{}

virtual ListKey& SWSearchable::search	(	const char *	istr,
		int	searchType = 0,
		int	flags = 0,
		SWKey *	scope = 0,
		bool *	justCheckIfSupported = 0,
		void(*)(char, void *)	percent = &nullPercent,
		void *	percentUserData = 0
	)			[pure virtual]

Searches a module for a string

Parameters:

	istr	string for which to search
	searchType	type of search to perform >=0 - regex -1 - phrase -2 - multiword -3 - entryAttrib (eg. Word//Strongs/G1234/) -4 - Lucene
	flags	options flags for search
	scope	Key containing the scope. VerseKey or ListKey are useful here.
	justCheckIfSupported	if set, don't search, only tell if this function supports requested search.
	percent	Callback function to get the current search status in %.
	percentUserData	User data that is given to the callback function as parameter.

Returns:

ListKey set to verses that contain istr

Implemented in SWModule.

---

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

• include/swsearchable.h
• src/mgr/swsearchable.cpp