Xapian::Enquire Class Reference

This class provides an interface to the information retrieval system for the purpose of searching. More...

#include <enquire.h>

Collaboration diagram for Xapian::Enquire:

Collaboration graph
[legend]

List of all members.

Classes

class  Internal
 Internals of enquire system. More...

Public Types

enum  docid_order { ASCENDING = 1, DESCENDING = 0, DONT_CARE = 2 }

Public Member Functions

 Enquire (const Enquire &other)
 Copying is allowed (and is cheap).
void operator= (const Enquire &other)
 Assignment is allowed (and is cheap).
 Enquire (const Database &database, ErrorHandler *errorhandler_=0)
 Create a Xapian::Enquire object.
 ~Enquire ()
 Close the Xapian::Enquire object.
void set_query (const Xapian::Query &query, Xapian::termcount qlen=0)
 Set the query to run.
const Xapian::Query & get_query () const
 Get the query which has been set.
void add_matchspy (MatchSpy *spy)
 Add a matchspy.
void clear_matchspies ()
 Remove all the matchspies.
void set_weighting_scheme (const Weight &weight_)
 Set the weighting scheme to use for queries.
void set_collapse_key (Xapian::valueno collapse_key, Xapian::doccount collapse_max=1)
 Set the collapse key to use for queries.
void set_docid_order (docid_order order)
 Set the direction in which documents are ordered by document id in the returned MSet.
void set_cutoff (Xapian::percent percent_cutoff, Xapian::weight weight_cutoff=0)
 Set the percentage and/or weight cutoffs.
void set_sort_by_relevance ()
 Set the sorting to be by relevance only.
void set_sort_by_value (Xapian::valueno sort_key, bool reverse)
 Set the sorting to be by value only.
void set_sort_by_value (Xapian::valueno sort_key)
void set_sort_by_key (Xapian::KeyMaker *sorter, bool reverse)
 Set the sorting to be by key generated from values only.
void set_sort_by_key (Xapian::KeyMaker *sorter)
void set_sort_by_value_then_relevance (Xapian::valueno sort_key, bool reverse)
 Set the sorting to be by value, then by relevance for documents with the same value.
void set_sort_by_value_then_relevance (Xapian::valueno sort_key)
void set_sort_by_key_then_relevance (Xapian::KeyMaker *sorter, bool reverse)
 Set the sorting to be by keys generated from values, then by relevance for documents with identical keys.
void set_sort_by_key_then_relevance (Xapian::KeyMaker *sorter)
void set_sort_by_relevance_then_value (Xapian::valueno sort_key, bool reverse)
 Set the sorting to be by relevance then value.
void set_sort_by_relevance_then_value (Xapian::valueno sort_key)
void set_sort_by_relevance_then_key (Xapian::KeyMaker *sorter, bool reverse)
 Set the sorting to be by relevance, then by keys generated from values.
void set_sort_by_relevance_then_key (Xapian::KeyMaker *sorter)
ESet get_eset (Xapian::termcount maxitems, const RSet &omrset, int flags=0, double k=1.0, const Xapian::ExpandDecider *edecider=0) const
 Get the expand set for the given rset.
ESet get_eset (Xapian::termcount maxitems, const RSet &omrset, const Xapian::ExpandDecider *edecider) const
 Get the expand set for the given rset.
ESet get_eset (Xapian::termcount maxitems, const RSet &omrset, int flags, double k, const Xapian::ExpandDecider *edecider, Xapian::weight min_wt) const
 Get the expand set for the given rset.
TermIterator get_matching_terms_begin (Xapian::docid did) const
 Get terms which match a given document, by document id.
TermIterator get_matching_terms_end (Xapian::docid) const
 End iterator corresponding to get_matching_terms_begin().
TermIterator get_matching_terms_begin (const MSetIterator &it) const
 Get terms which match a given document, by match set item.
TermIterator get_matching_terms_end (const MSetIterator &) const
 End iterator corresponding to get_matching_terms_begin().
std::string get_description () const
 Return a string describing this object.
MSet get_mset (Xapian::doccount first, Xapian::doccount maxitems, Xapian::doccount checkatleast=0, const RSet *omrset=0, const MatchDecider *mdecider=0) const
 Get (a portion of) the match set for the current query.
MSet get_mset (Xapian::doccount first, Xapian::doccount maxitems, Xapian::doccount checkatleast, const RSet *omrset, const MatchDecider *mdecider, const MatchDecider *matchspy) const
 Get (a portion of) the match set for the current query.
MSet get_mset (Xapian::doccount first, Xapian::doccount maxitems, const RSet *omrset, const MatchDecider *mdecider=0) const
 Get (a portion of) the match set for the current query.

Public Attributes

Xapian::Internal::RefCntPtr
< Internal > 		internal

Static Public Attributes

static const int INCLUDE_QUERY_TERMS = 1
static const int USE_EXACT_TERMFREQ = 2

Detailed Description

This class provides an interface to the information retrieval system for the purpose of searching.

Databases are usually opened lazily, so exceptions may not be thrown where you would expect them to be. You should catch Xapian::Error exceptions when calling any method in Xapian::Enquire.

Exceptions:
Xapian::InvalidArgumentError will be thrown if an invalid argument is supplied, for example, an unknown database type.

Definition at line 646 of file enquire.h.

Member Enumeration Documentation

enum Xapian::Enquire::docid_order

Enumerator:
ASCENDING 
DESCENDING 
DONT_CARE 

Definition at line 772 of file enquire.h.

Constructor & Destructor Documentation

Xapian::Enquire::Enquire ( const Enquire &  other  ) 

Copying is allowed (and is cheap).

Definition at line 853 of file omenquire.cc.

References LOGCALL_VOID.

Xapian::Enquire::Enquire ( const Database &  database,
ErrorHandler *  errorhandler_ = 0 
) [explicit]

Create a Xapian::Enquire object.

This specification cannot be changed once the Xapian::Enquire is opened: you must create a new Xapian::Enquire object to access a different database, or set of databases.

The database supplied must have been initialised (ie, must not be the result of calling the Database::Database() constructor). If you need to handle a situation where you have no index gracefully, a database created with InMemory::open() can be passed here, which represents a completely empty database.

Parameters:
database Specification of the database or databases to use.
errorhandler_ A pointer to the error handler to use. Ownership of the object pointed to is not assumed by the Xapian::Enquire object - the user should delete the Xapian::ErrorHandler object after the Xapian::Enquire object is deleted. To use no error handler, this parameter should be 0.
Exceptions:
Xapian::InvalidArgumentError will be thrown if an empty Database object is supplied.

Definition at line 865 of file omenquire.cc.

References LOGCALL_VOID.

Xapian::Enquire::~Enquire (  ) 

Close the Xapian::Enquire object.

Definition at line 871 of file omenquire.cc.

References LOGCALL_VOID.

Member Function Documentation

void Xapian::Enquire::add_matchspy ( MatchSpy *  spy  ) 

Add a matchspy.

This matchspy will be called with some of the documents which match the query, during the match process. Exactly which of the matching documents are passed to it depends on exactly when certain optimisations occur during the match process, but it can be controlled to some extent by setting the checkatleast parameter to get_mset().

In particular, if there are enough matching documents, at least the number specified by checkatleast will be passed to the matchspy. This means that you can force the matchspy to be shown all matching documents by setting checkatleast to the number of documents in the database.

Parameters:
spy The MatchSpy subclass to add. The caller must ensure that this remains valid while the Enquire object remains active, or until clear_matchspies() is called.

Definition at line 896 of file omenquire.cc.

References LOGCALL_VOID.

Referenced by DEFINE_TESTCASE().

void Xapian::Enquire::clear_matchspies (  ) 

Remove all the matchspies.

Definition at line 902 of file omenquire.cc.

References LOGCALL.

string Xapian::Enquire::get_description (  )  const

Return a string describing this object.

Definition at line 1087 of file omenquire.cc.

Referenced by DEFINE_TESTCASE().

ESet Xapian::Enquire::get_eset ( Xapian::termcount  maxitems,
const RSet &  omrset,
int  flags,
double  k,
const Xapian::ExpandDecider *  edecider,
Xapian::weight  min_wt 
) const

Get the expand set for the given rset.

Parameters:
maxitems the maximum number of items to return.
omrset the relevance set to use when performing the expand operation.
flags zero or more of these values |-ed together:
k the parameter k in the query expansion algorithm (default is 1.0)
edecider a decision functor to use to decide whether a given term should be put in the ESet
min_wt the minimum weight for included terms
Returns:
An ESet object containing the results of the expand.
Exceptions:
Xapian::InvalidArgumentError See class documentation.

Definition at line 1049 of file omenquire.cc.

References internal, LOGCALL, and RETURN.

ESet Xapian::Enquire::get_eset ( Xapian::termcount  maxitems,
const RSet &  omrset,
const Xapian::ExpandDecider *  edecider 
) const [inline]

Get the expand set for the given rset.

Parameters:
maxitems the maximum number of items to return.
omrset the relevance set to use when performing the expand operation.
edecider a decision functor to use to decide whether a given term should be put in the ESet
Returns:
An ESet object containing the results of the expand.
Exceptions:
Xapian::InvalidArgumentError See class documentation.

Definition at line 1044 of file enquire.h.

ESet Xapian::Enquire::get_eset ( Xapian::termcount  maxitems,
const RSet &  omrset,
int  flags = 0,
double  k = 1.0,
const Xapian::ExpandDecider *  edecider = 0 
) const

Get the expand set for the given rset.

Parameters:
maxitems the maximum number of items to return.
omrset the relevance set to use when performing the expand operation.
flags zero or more of these values |-ed together:
k the parameter k in the query expansion algorithm (default is 1.0)
edecider a decision functor to use to decide whether a given term should be put in the ESet
Returns:
An ESet object containing the results of the expand.
Exceptions:
Xapian::InvalidArgumentError See class documentation.

Definition at line 1035 of file omenquire.cc.

References internal, LOGCALL, and RETURN.

Referenced by DEFINE_TESTCASE(), and main().

TermIterator Xapian::Enquire::get_matching_terms_begin ( const MSetIterator &  it  )  const

Get terms which match a given document, by match set item.

This method returns the terms in the current query which match the given document.

If the underlying database has suitable support, using this call (rather than passing a Xapian::docid) will enable the system to ensure that the correct data is returned, and that the document has not been deleted or changed since the query was performed.

Parameters:
it The iterator for which to retrieve the matching terms.
Returns:
An iterator returning the terms which match the document. The terms will be returned (as far as this makes any sense) in the same order as the terms in the query. Terms will not occur more than once, even if they do in the query.
Exceptions:
Xapian::InvalidArgumentError See class documentation.
Xapian::DocNotFoundError The document specified could not be found in the database.

Definition at line 1063 of file omenquire.cc.

References internal, LOGCALL, and RETURN.

TermIterator Xapian::Enquire::get_matching_terms_begin ( Xapian::docid  did  )  const

Get terms which match a given document, by document id.

This method returns the terms in the current query which match the given document.

It is possible for the document to have been removed from the database between the time it is returned in an MSet, and the time that this call is made. If possible, you should specify an MSetIterator instead of a Xapian::docid, since this will enable database backends with suitable support to prevent this occurring.

Note that a query does not need to have been run in order to make this call.

Parameters:
did The document id for which to retrieve the matching terms.
Returns:
An iterator returning the terms which match the document. The terms will be returned (as far as this makes any sense) in the same order as the terms in the query. Terms will not occur more than once, even if they do in the query.
Exceptions:
Xapian::InvalidArgumentError See class documentation.
Xapian::DocNotFoundError The document specified could not be found in the database.

Definition at line 1075 of file omenquire.cc.

References internal, LOGCALL, and RETURN.

Referenced by DEFINE_TESTCASE().

TermIterator Xapian::Enquire::get_matching_terms_end ( const MSetIterator &   )  const [inline]

End iterator corresponding to get_matching_terms_begin().

Definition at line 1140 of file enquire.h.

TermIterator Xapian::Enquire::get_matching_terms_end ( Xapian::docid   )  const [inline]

End iterator corresponding to get_matching_terms_begin().

Definition at line 1111 of file enquire.h.

Referenced by DEFINE_TESTCASE().

MSet Xapian::Enquire::get_mset ( Xapian::doccount  first,
Xapian::doccount  maxitems,
const RSet *  omrset,
const MatchDecider *  mdecider = 0 
) const [inline]

Get (a portion of) the match set for the current query.

Parameters:
first the first item in the result set to return. A value of zero corresponds to the first item returned being that with the highest score. A value of 10 corresponds to the first 10 items being ignored, and the returned items starting at the eleventh.
maxitems the maximum number of items to return. If you want all matches, then you can pass the result of calling get_doccount() on the Database object (though if you are doing this so you can filter results, you are likely to get much better performance by using Xapian's match-time filtering features instead). You can pass 0 for maxitems which will give you an empty MSet with valid statistics (such as get_matches_estimated()) calculated without looking at any postings, which is very quick, but means the estimates may be more approximate and the bounds may be much looser.
checkatleast the minimum number of items to check. Because the matcher optimises, it won't consider every document which might match, so the total number of matches is estimated. Setting checkatleast forces it to consider at least this many matches and so allows for reliable paging links.
omrset the relevance set to use when performing the query.
mdecider a decision functor to use to decide whether a given document should be put in the MSet.
matchspy a decision functor to use to decide whether a given document should be put in the MSet. The matchspy is applied to every document which is a potential candidate for the MSet, so if there are checkatleast or more such documents, the matchspy will see at least checkatleast. The mdecider is assumed to be a relatively expensive test so may be applied in a lazier fashion.
Deprecated:
this parameter is deprecated - use the newer MatchSpy class and add_matchspy() method instead.
Returns:
A Xapian::MSet object containing the results of the query.
Exceptions:
Xapian::InvalidArgumentError See class documentation.

Definition at line 993 of file enquire.h.

MSet Xapian::Enquire::get_mset ( Xapian::doccount  first,
Xapian::doccount  maxitems,
Xapian::doccount  checkatleast,
const RSet *  omrset,
const MatchDecider *  mdecider,
const MatchDecider *  matchspy 
) const

Get (a portion of) the match set for the current query.

Parameters:
first the first item in the result set to return. A value of zero corresponds to the first item returned being that with the highest score. A value of 10 corresponds to the first 10 items being ignored, and the returned items starting at the eleventh.
maxitems the maximum number of items to return. If you want all matches, then you can pass the result of calling get_doccount() on the Database object (though if you are doing this so you can filter results, you are likely to get much better performance by using Xapian's match-time filtering features instead). You can pass 0 for maxitems which will give you an empty MSet with valid statistics (such as get_matches_estimated()) calculated without looking at any postings, which is very quick, but means the estimates may be more approximate and the bounds may be much looser.
checkatleast the minimum number of items to check. Because the matcher optimises, it won't consider every document which might match, so the total number of matches is estimated. Setting checkatleast forces it to consider at least this many matches and so allows for reliable paging links.
omrset the relevance set to use when performing the query.
mdecider a decision functor to use to decide whether a given document should be put in the MSet.
matchspy a decision functor to use to decide whether a given document should be put in the MSet. The matchspy is applied to every document which is a potential candidate for the MSet, so if there are checkatleast or more such documents, the matchspy will see at least checkatleast. The mdecider is assumed to be a relatively expensive test so may be applied in a lazier fashion.
Deprecated:
this parameter is deprecated - use the newer MatchSpy class and add_matchspy() method instead.
Returns:
A Xapian::MSet object containing the results of the query.
Exceptions:
Xapian::InvalidArgumentError See class documentation.

Definition at line 1002 of file omenquire.cc.

References internal, LOGCALL, and RETURN.

MSet Xapian::Enquire::get_mset ( Xapian::doccount  first,
Xapian::doccount  maxitems,
Xapian::doccount  checkatleast = 0,
const RSet *  omrset = 0,
const MatchDecider *  mdecider = 0 
) const

Get (a portion of) the match set for the current query.

Parameters:
first the first item in the result set to return. A value of zero corresponds to the first item returned being that with the highest score. A value of 10 corresponds to the first 10 items being ignored, and the returned items starting at the eleventh.
maxitems the maximum number of items to return. If you want all matches, then you can pass the result of calling get_doccount() on the Database object (though if you are doing this so you can filter results, you are likely to get much better performance by using Xapian's match-time filtering features instead). You can pass 0 for maxitems which will give you an empty MSet with valid statistics (such as get_matches_estimated()) calculated without looking at any postings, which is very quick, but means the estimates may be more approximate and the bounds may be much looser.
checkatleast the minimum number of items to check. Because the matcher optimises, it won't consider every document which might match, so the total number of matches is estimated. Setting checkatleast forces it to consider at least this many matches and so allows for reliable paging links.
omrset the relevance set to use when performing the query.
mdecider a decision functor to use to decide whether a given document should be put in the MSet.
matchspy a decision functor to use to decide whether a given document should be put in the MSet. The matchspy is applied to every document which is a potential candidate for the MSet, so if there are checkatleast or more such documents, the matchspy will see at least checkatleast. The mdecider is assumed to be a relatively expensive test so may be applied in a lazier fashion.
Deprecated:
this parameter is deprecated - use the newer MatchSpy class and add_matchspy() method instead.
Returns:
A Xapian::MSet object containing the results of the query.
Exceptions:
Xapian::InvalidArgumentError See class documentation.

Definition at line 1019 of file omenquire.cc.

References internal, LOGCALL, and RETURN.

Referenced by DEFINE_TESTCASE(), main(), test_qp_flag_wildcard1_helper(), and test_qp_value_range3().

const Query & Xapian::Enquire::get_query (  )  const

Get the query which has been set.

This is only valid after set_query() has been called.

Exceptions:
Xapian::InvalidArgumentError will be thrown if query has not yet been set.

Definition at line 884 of file omenquire.cc.

References internal, LOGCALL, and RETURN.

void Xapian::Enquire::operator= ( const Enquire &  other  ) 

Assignment is allowed (and is cheap).

Definition at line 859 of file omenquire.cc.

References internal, and LOGCALL_VOID.

void Xapian::Enquire::set_collapse_key ( Xapian::valueno  collapse_key,
Xapian::doccount  collapse_max = 1 
)

Set the collapse key to use for queries.

Parameters:
collapse_key value number to collapse on - at most one MSet entry with each particular value will be returned (default is Xapian::BAD_VALUENO which means no collapsing).
collapse_max Max number of items with the same key to leave after collapsing (default 1).
The MSet returned by get_mset() will have only the "best" (at most) collapse_max entries with each particular value of collapse_key ("best" being highest ranked - i.e. highest weight or highest sorting key).

An example use might be to create a value for each document containing an MD5 hash of the document contents. Then duplicate documents from different sources can be eliminated at search time by collapsing with collapse_max = 1 (it's better to eliminate duplicates at index time, but this may not be always be possible - for example the search may be over more than one Xapian database).

Another use is to group matches in a particular category (e.g. you might collapse a mailing list search on the Subject: so that there's only one result per discussion thread). In this case you can use get_collapse_count() to give the user some idea how many other results there are. And if you index the Subject: as a boolean term as well as putting it in a value, you can offer a link to a non-collapsed search restricted to that thread using a boolean filter.

Definition at line 918 of file omenquire.cc.

References Xapian::BAD_VALUENO.

Referenced by DEFINE_TESTCASE().

void Xapian::Enquire::set_cutoff ( Xapian::percent  percent_cutoff,
Xapian::weight  weight_cutoff = 0 
)

Set the percentage and/or weight cutoffs.

Parameters:
percent_cutoff Minimum percentage score for returned documents. If a document has a lower percentage score than this, it will not appear in the MSet. If your intention is to return only matches which contain all the terms in the query, then it's more efficient to use Xapian::Query::OP_AND instead of Xapian::Query::OP_OR in the query than to use set_cutoff(100). (default 0 => no percentage cut-off).
weight_cutoff Minimum weight for a document to be returned. If a document has a lower score that this, it will not appear in the MSet. It is usually only possible to choose an appropriate weight for cutoff based on the results of a previous run of the same query; this is thus mainly useful for alerting operations. The other potential use is with a user specified weighting scheme. (default 0 => no weight cut-off).

Definition at line 932 of file omenquire.cc.

Referenced by DEFINE_TESTCASE().

void Xapian::Enquire::set_docid_order ( Enquire::docid_order  order  ) 

Set the direction in which documents are ordered by document id in the returned MSet.

This order only has an effect on documents which would otherwise have equal rank. For a weighted probabilistic match with no sort value, this means documents with equal weight. For a boolean match, with no sort value, this means all documents. And if a sort value is used, this means documents with equal sort value (and also equal weight if ordering on relevance after the sort).

Parameters:
order This can be:
Note: If you add documents in strict date order, then a boolean search - i.e. set_weighting_scheme(Xapian::BoolWeight()) - with set_docid_order(Xapian::Enquire::DESCENDING) is an efficient way to perform "sort by date, newest first", and with set_docid_order(Xapian::Enquire::ASCENDING) a very efficient way to perform "sort by date, oldest first".

Definition at line 926 of file omenquire.cc.

Referenced by DEFINE_TESTCASE().

void Xapian::Enquire::set_query ( const Xapian::Query &  query,
Xapian::termcount  qlen = 0 
)

Set the query to run.

Parameters:
query the new query to run.
qlen the query length to use in weight calculations - by default the sum of the wqf of all terms is used.

Definition at line 877 of file omenquire.cc.

References LOGCALL_VOID.

Referenced by DEFINE_TESTCASE(), main(), test_qp_flag_wildcard1_helper(), and test_qp_value_range3().

void Xapian::Enquire::set_sort_by_key ( Xapian::KeyMaker *  sorter  )  [inline]

Definition at line 1157 of file enquire.h.

References set_sort_by_key().

void Xapian::Enquire::set_sort_by_key ( Xapian::KeyMaker *  sorter,
bool  reverse 
)

Set the sorting to be by key generated from values only.

Parameters:
sorter The functor to use for generating keys.
reverse If true, reverses the sort order.

Definition at line 972 of file omenquire.cc.

References Xapian::Enquire::Internal::VAL.

Referenced by DEFINE_TESTCASE(), and set_sort_by_key().

void Xapian::Enquire::set_sort_by_key_then_relevance ( Xapian::KeyMaker *  sorter  )  [inline]

Definition at line 1169 of file enquire.h.

References set_sort_by_key_then_relevance().

void Xapian::Enquire::set_sort_by_key_then_relevance ( Xapian::KeyMaker *  sorter,
bool  reverse 
)

Set the sorting to be by keys generated from values, then by relevance for documents with identical keys.

Parameters:
sorter The functor to use for generating keys.
reverse If true, reverses the sort order.

Definition at line 982 of file omenquire.cc.

References Xapian::Enquire::Internal::VAL_REL.

Referenced by set_sort_by_key_then_relevance().

void Xapian::Enquire::set_sort_by_relevance (  ) 

Set the sorting to be by relevance only.

This is the default.

Definition at line 939 of file omenquire.cc.

References Xapian::Enquire::Internal::REL.

Referenced by DEFINE_TESTCASE().

void Xapian::Enquire::set_sort_by_relevance_then_key ( Xapian::KeyMaker *  sorter  )  [inline]

Definition at line 1181 of file enquire.h.

References set_sort_by_relevance_then_key().

void Xapian::Enquire::set_sort_by_relevance_then_key ( Xapian::KeyMaker *  sorter,
bool  reverse 
)

Set the sorting to be by relevance, then by keys generated from values.

Note that with the default BM25 weighting scheme parameters, non-identical documents will rarely have the same weight, so this setting will give very similar results to set_sort_by_relevance(). It becomes more useful with particular BM25 parameter settings (e.g. BM25Weight(1,0,1,0,0)) or custom weighting schemes.

Parameters:
sorter The functor to use for generating keys.
reverse If true, reverses the sort order.

Definition at line 992 of file omenquire.cc.

References Xapian::Enquire::Internal::REL_VAL.

Referenced by set_sort_by_relevance_then_key().

void Xapian::Enquire::set_sort_by_relevance_then_value ( Xapian::valueno  sort_key  )  [inline]

Definition at line 1175 of file enquire.h.

References set_sort_by_relevance_then_value().

void Xapian::Enquire::set_sort_by_relevance_then_value ( Xapian::valueno  sort_key,
bool  reverse 
)

Set the sorting to be by relevance then value.

Note that sorting by values uses a string comparison, so to use this to sort by a numeric value you'll need to store the numeric values in a manner which sorts appropriately. For example, you could use Xapian::sortable_serialise() (which works for floating point numbers as well as integers), or store numbers padded with leading zeros or spaces, or with the number of digits prepended.

Note that with the default BM25 weighting scheme parameters, non-identical documents will rarely have the same weight, so this setting will give very similar results to set_sort_by_relevance(). It becomes more useful with particular BM25 parameter settings (e.g. BM25Weight(1,0,1,0,0)) or custom weighting schemes.

Parameters:
sort_key value number to sort on.
reverse If true, reverses the sort order.

Definition at line 963 of file omenquire.cc.

References Xapian::Enquire::Internal::REL_VAL.

Referenced by DEFINE_TESTCASE(), and set_sort_by_relevance_then_value().

void Xapian::Enquire::set_sort_by_value ( Xapian::valueno  sort_key  )  [inline]

Definition at line 1151 of file enquire.h.

References set_sort_by_value().

void Xapian::Enquire::set_sort_by_value ( Xapian::valueno  sort_key,
bool  reverse 
)

Set the sorting to be by value only.

Note that sorting by values uses a string comparison, so to use this to sort by a numeric value you'll need to store the numeric values in a manner which sorts appropriately. For example, you could use Xapian::sortable_serialise() (which works for floating point numbers as well as integers), or store numbers padded with leading zeros or spaces, or with the number of digits prepended.

Parameters:
sort_key value number to sort on.
reverse If true, reverses the sort order.

Definition at line 945 of file omenquire.cc.

References Xapian::Enquire::Internal::VAL.

Referenced by DEFINE_TESTCASE(), and set_sort_by_value().

void Xapian::Enquire::set_sort_by_value_then_relevance ( Xapian::valueno  sort_key  )  [inline]

Definition at line 1163 of file enquire.h.

References set_sort_by_value_then_relevance().

void Xapian::Enquire::set_sort_by_value_then_relevance ( Xapian::valueno  sort_key,
bool  reverse 
)

Set the sorting to be by value, then by relevance for documents with the same value.

Note that sorting by values uses a string comparison, so to use this to sort by a numeric value you'll need to store the numeric values in a manner which sorts appropriately. For example, you could use Xapian::sortable_serialise() (which works for floating point numbers as well as integers), or store numbers padded with leading zeros or spaces, or with the number of digits prepended.

Parameters:
sort_key value number to sort on.
reverse If true, reverses the sort order.

Definition at line 954 of file omenquire.cc.

References Xapian::Enquire::Internal::VAL_REL.

Referenced by DEFINE_TESTCASE(), and set_sort_by_value_then_relevance().

void Xapian::Enquire::set_weighting_scheme ( const Weight &  weight_  ) 

Set the weighting scheme to use for queries.

Parameters:
weight_ the new weighting scheme. If no weighting scheme is specified, the default is BM25 with the default parameters.

Definition at line 908 of file omenquire.cc.

References Xapian::Weight::clone(), internal, and LOGCALL_VOID.

Referenced by DEFINE_TESTCASE().

Member Data Documentation

const int Xapian::Enquire::INCLUDE_QUERY_TERMS = 1 [static]

Definition at line 1000 of file enquire.h.

Referenced by DEFINE_TESTCASE(), and Xapian::Enquire::Internal::get_eset().

Xapian::Internal::RefCntPtr<Internal> Xapian::Enquire::internal

For internal use only.

Reference counted internals.

Definition at line 654 of file enquire.h.

Referenced by get_eset(), get_matching_terms_begin(), get_mset(), get_query(), operator=(), and set_weighting_scheme().

const int Xapian::Enquire::USE_EXACT_TERMFREQ = 2 [static]

Definition at line 1001 of file enquire.h.

Referenced by DEFINE_TESTCASE(), and Xapian::Enquire::Internal::get_eset().

The documentation for this class was generated from the following files:
Documentation for Xapian (version 1.2.8).
Generated on 14 Dec 2011 by Doxygen 1.5.9.