Xapian::MSet Class Reference

A match set (MSet). More...

#include <enquire.h>

Collaboration diagram for Xapian::MSet:

Collaboration graph
[legend]
List of all members.

Public Types

typedef MSetIterator value_type
 Allow use as an STL container.
typedef MSetIterator iterator
typedef MSetIterator const_iterator
typedef MSetIteratorreference
typedef MSetIteratorconst_reference
typedef MSetIteratorpointer
typedef Xapian::doccount_diff difference_type
typedef Xapian::doccount size_type

Public Member Functions

 MSet (MSet::Internal *internal_)
 

For internal use only.

Constructor for internal use.


 MSet ()
 Create an empty Xapian::MSet.
 ~MSet ()
 Destroy a Xapian::MSet.
 MSet (const MSet &other)
 Copying is allowed (and is cheap).
void operator= (const MSet &other)
 Assignment is allowed (and is cheap).
void fetch (const MSetIterator &begin, const MSetIterator &end) const
 Fetch the document info for a set of items in the MSet.
void fetch (const MSetIterator &item) const
 Fetch the single item specified.
void fetch () const
 Fetch all the items in the MSet.
Xapian::percent convert_to_percent (Xapian::weight wt) const
 This converts the weight supplied to a percentage score.
Xapian::percent convert_to_percent (const MSetIterator &it) const
 Return the percentage score for a particular item.
Xapian::doccount get_termfreq (const std::string &tname) const
 Return the term frequency of the given query term.
Xapian::weight get_termweight (const std::string &tname) const
 Return the term weight of the given query term.
Xapian::doccount get_firstitem () const
 The index of the first item in the result which was put into the MSet.
Xapian::doccount get_matches_lower_bound () const
 A lower bound on the number of documents in the database which match the query.
Xapian::doccount get_matches_estimated () const
 An estimate for the number of documents in the database which match the query.
Xapian::doccount get_matches_upper_bound () const
 An upper bound on the number of documents in the database which match the query.
Xapian::weight get_max_possible () const
 The maximum possible weight in the MSet.
Xapian::weight get_max_attained () const
 The greatest weight which is attained by any document in the database.
Xapian::doccount size () const
 The number of items in this MSet.
Xapian::doccount max_size () const
 Required to allow use as an STL container.
bool empty () const
 Test if this MSet is empty.
void swap (MSet &other)
 Swap the MSet we point to with another.
MSetIterator begin () const
 Iterator for the terms in this MSet.
MSetIterator end () const
 End iterator corresponding to begin().
MSetIterator back () const
 Iterator pointing to the last element of this MSet.
MSetIterator operator[] (Xapian::doccount i) const
 This returns the document at position i in this MSet object.
std::string get_description () const
 Return a string describing this object.

Public Attributes

Xapian::Internal::RefCntPtr<
Internal
internal
 

For internal use only.

Reference counted internals.



Classes

class  Internal

Detailed Description

A match set (MSet).

This class represents (a portion of) the results of a query.

Definition at line 49 of file enquire.h.


Member Typedef Documentation

typedef MSetIterator Xapian::MSet::value_type

Allow use as an STL container.

Definition at line 223 of file enquire.h.

typedef MSetIterator Xapian::MSet::iterator

Definition at line 224 of file enquire.h.

typedef MSetIterator Xapian::MSet::const_iterator

Definition at line 225 of file enquire.h.

typedef MSetIterator& Xapian::MSet::reference

Definition at line 226 of file enquire.h.

typedef MSetIterator& Xapian::MSet::const_reference

Definition at line 227 of file enquire.h.

typedef MSetIterator* Xapian::MSet::pointer

Definition at line 228 of file enquire.h.

typedef Xapian::doccount_diff Xapian::MSet::difference_type

Definition at line 229 of file enquire.h.

typedef Xapian::doccount Xapian::MSet::size_type

Definition at line 230 of file enquire.h.


Constructor & Destructor Documentation

Xapian::MSet::MSet ( MSet::Internal internal_  )  [explicit]

For internal use only.

Constructor for internal use.

Definition at line 153 of file omenquire.cc.

Xapian::MSet::MSet (  ) 

Create an empty Xapian::MSet.

Definition at line 149 of file omenquire.cc.

Xapian::MSet::~MSet (  ) 

Destroy a Xapian::MSet.

Definition at line 157 of file omenquire.cc.

Xapian::MSet::MSet ( const MSet other  ) 

Copying is allowed (and is cheap).

Definition at line 161 of file omenquire.cc.


Member Function Documentation

void Xapian::MSet::operator= ( const MSet other  ) 

Assignment is allowed (and is cheap).

Definition at line 166 of file omenquire.cc.

References internal.

void Xapian::MSet::fetch ( const MSetIterator begin,
const MSetIterator end 
) const

Fetch the document info for a set of items in the MSet.

This method causes the documents in the range specified by the iterators to be fetched from the database, and cached in the Xapian::MSet object. This has little effect when performing a search across a local database, but will greatly speed up subsequent access to the document contents when the documents are stored in a remote database.

The iterators must be over this Xapian::MSet - undefined behaviour will result otherwise.

Parameters:
begin MSetIterator for first item to fetch.
end MSetIterator for item after last item to fetch.

Definition at line 172 of file omenquire.cc.

References Assert, DEBUGAPICALL, and Xapian::MSetIterator::index.

Referenced by DEFINE_TESTCASE().

void Xapian::MSet::fetch ( const MSetIterator item  )  const

Fetch the single item specified.

Definition at line 181 of file omenquire.cc.

References Assert, DEBUGAPICALL, and Xapian::MSetIterator::index.

void Xapian::MSet::fetch (  )  const

Fetch all the items in the MSet.

Definition at line 189 of file omenquire.cc.

References Assert, DEBUGAPICALL, and internal.

percent Xapian::MSet::convert_to_percent ( Xapian::weight  wt  )  const

This converts the weight supplied to a percentage score.

The return value will be in the range 0 to 100, and will be 0 if and only if the item did not match the query at all.

Definition at line 198 of file omenquire.cc.

References Assert, DEBUGAPICALL, internal, and RETURN.

Referenced by DEFINE_TESTCASE(), and print_mset_percentages().

percent Xapian::MSet::convert_to_percent ( const MSetIterator it  )  const

Return the percentage score for a particular item.

Definition at line 206 of file omenquire.cc.

References Assert, DEBUGAPICALL, Xapian::MSetIterator::get_weight(), internal, and RETURN.

Xapian::doccount Xapian::MSet::get_termfreq ( const std::string &  tname  )  const

Return the term frequency of the given query term.

Parameters:
tname The term to look for.
Exceptions:
Xapian::InvalidArgumentError is thrown if the term was not in the query.

Referenced by DEFINE_TESTCASE().

Xapian::weight Xapian::MSet::get_termweight ( const std::string &  tname  )  const

Return the term weight of the given query term.

Parameters:
tname The term to look for.
Exceptions:
Xapian::InvalidArgumentError is thrown if the term was not in the query.

Referenced by DEFINE_TESTCASE().

Xapian::doccount Xapian::MSet::get_firstitem (  )  const

The index of the first item in the result which was put into the MSet.

This corresponds to the parameter "first" specified in Xapian::Enquire::get_mset(). A value of 0 corresponds to the highest result being the first item in the MSet.

Definition at line 242 of file omenquire.cc.

References Assert.

Referenced by serialise_mset(), and serialise_mset_pre_30_5().

Xapian::doccount Xapian::MSet::get_matches_lower_bound (  )  const

A lower bound on the number of documents in the database which match the query.

This figure takes into account collapsing of duplicates, and weighting cutoff values.

This number is usually considerably less than the actual number of documents which match the query.

Definition at line 249 of file omenquire.cc.

References Assert.

Referenced by DEFINE_TESTCASE(), operator==(), serialise_mset(), and serialise_mset_pre_30_5().

Xapian::doccount Xapian::MSet::get_matches_estimated (  )  const

An estimate for the number of documents in the database which match the query.

This figure takes into account collapsing of duplicates, and weighting cutoff values.

This value is returned because there is sometimes a request to display such information. However, our experience is that presenting this value to users causes them to worry about the large number of results, rather than how useful those at the top of the result set are, and is thus undesirable.

Definition at line 256 of file omenquire.cc.

References Assert.

Referenced by DEFINE_TESTCASE(), main(), operator==(), serialise_mset(), and serialise_mset_pre_30_5().

Xapian::doccount Xapian::MSet::get_matches_upper_bound (  )  const

An upper bound on the number of documents in the database which match the query.

This figure takes into account collapsing of duplicates, and weighting cutoff values.

This number is usually considerably greater than the actual number of documents which match the query.

Definition at line 263 of file omenquire.cc.

References Assert.

Referenced by DEFINE_TESTCASE(), operator==(), serialise_mset(), and serialise_mset_pre_30_5().

Xapian::weight Xapian::MSet::get_max_possible (  )  const

The maximum possible weight in the MSet.

This weight is likely not to be attained in the set of results, but represents an upper bound on the weight which a document could attain for the given query.

Definition at line 270 of file omenquire.cc.

References Assert.

Referenced by DEFINE_TESTCASE(), operator==(), serialise_mset(), and serialise_mset_pre_30_5().

Xapian::weight Xapian::MSet::get_max_attained (  )  const

The greatest weight which is attained by any document in the database.

If firstitem == 0, this is the weight of the first entry in items.

If no documents are found by the query, this will be 0.

Note that calculation of max_attained requires calculation of at least one result item - therefore, if no items were requested when the query was performed (by specifying maxitems = 0 in Xapian::Enquire::get_mset()), this value will be 0.

Definition at line 277 of file omenquire.cc.

References Assert.

Referenced by DEFINE_TESTCASE(), serialise_mset(), and serialise_mset_pre_30_5().

Xapian::doccount Xapian::MSet::size (  )  const

The number of items in this MSet.

Definition at line 284 of file omenquire.cc.

References Assert.

Referenced by DEFINE_TESTCASE(), main(), mset_expect_order_(), mset_range_is_same(), mset_range_is_same_percents(), mset_range_is_same_weights(), operator==(), operator[](), serialise_mset(), serialise_mset_pre_30_5(), test_consistency2(), test_mset_order_equal(), test_qp_value_range3(), and unserialise_mset().

Xapian::doccount Xapian::MSet::max_size (  )  const [inline]

Required to allow use as an STL container.

Definition at line 193 of file enquire.h.

References size.

bool Xapian::MSet::empty (  )  const

Test if this MSet is empty.

Definition at line 291 of file omenquire.cc.

References Assert.

Referenced by back(), DEFINE_TESTCASE(), and operator==().

void Xapian::MSet::swap ( MSet other  ) 

Swap the MSet we point to with another.

Definition at line 298 of file omenquire.cc.

References internal.

MSetIterator Xapian::MSet::begin (  )  const

Iterator for the terms in this MSet.

Definition at line 304 of file omenquire.cc.

Referenced by DEFINE_TESTCASE(), main(), mset_expect_order_(), print_mset_percentages(), print_mset_weights(), serialise_mset(), serialise_mset_pre_30_5(), and test_mset_order_equal().

MSetIterator Xapian::MSet::end (  )  const

End iterator corresponding to begin().

Definition at line 310 of file omenquire.cc.

References Assert, and internal.

Referenced by DEFINE_TESTCASE(), main(), print_mset_percentages(), print_mset_weights(), serialise_mset(), serialise_mset_pre_30_5(), and test_mset_order_equal().

MSetIterator Xapian::MSet::back (  )  const

Iterator pointing to the last element of this MSet.

Definition at line 325 of file omenquire.cc.

References Assert, empty(), and internal.

Referenced by DEFINE_TESTCASE().

MSetIterator Xapian::MSet::operator[] ( Xapian::doccount  i  )  const

This returns the document at position i in this MSet object.

Note that this is not the same as the document at rank i in the query, unless the "first" parameter to Xapian::Enquire::get_mset was 0. Rather, it is the document at rank i + first.

In other words, the offset is into the documents represented by this object, not into the set of documents matching the query.

Definition at line 317 of file omenquire.cc.

References Assert, and size().

string Xapian::MSet::get_description (  )  const

Return a string describing this object.

Definition at line 333 of file omenquire.cc.

References Assert.


Member Data Documentation

Xapian::Internal::RefCntPtr<Internal> Xapian::MSet::internal

For internal use only.

Reference counted internals.

Definition at line 51 of file enquire.h.

Referenced by back(), convert_to_percent(), end(), fetch(), Xapian::MSetIterator::get_collapse_count(), Xapian::MSetIterator::get_collapse_key(), Xapian::MSetIterator::get_document(), Xapian::MSetIterator::get_percent(), RemoteSubMatch::get_postlist_and_term_info(), Xapian::MSetIterator::get_weight(), Xapian::MSetIterator::operator *(), operator=(), serialise_mset(), serialise_mset_pre_30_5(), and swap().


The documentation for this class was generated from the following files:
Documentation for Xapian (version 1.0.10).
Generated on 24 Dec 2008 by Doxygen 1.5.2.