Xapian::TermIterator Class Reference

An iterator pointing to items in a list of terms. More...

#include <termiterator.h>

Collaboration diagram for Xapian::TermIterator:

Collaboration graph
[legend]

List of all members.

Classes

class  Internal
 Abstract base class for termlists. More...

Public Types

typedef std::input_iterator_tag iterator_category
 Allow use as an STL iterator.
typedef std::string value_type
 Allow use as an STL iterator.
typedef Xapian::termcount_diff difference_type
 Allow use as an STL iterator.
typedef std::string * pointer
 Allow use as an STL iterator.
typedef std::string & reference
 Allow use as an STL iterator.

Public Member Functions

 TermIterator (Internal *internal_)
 TermIterator ()
 Default constructor - for declaring an uninitialised iterator.
 ~TermIterator ()
 Destructor.
 TermIterator (const TermIterator &other)
 Copying is allowed.
void operator= (const TermIterator &other)
 Assignment is allowed.
std::string operator* () const
 Return the current term.
TermIteratoroperator++ ()
DerefWrapper_< std::string > operator++ (int)
void skip_to (const std::string &tname)
 Advance the iterator to the specified term.
Xapian::termcount get_wdf () const
 Return the wdf of the current term (if meaningful).
Xapian::doccount get_termfreq () const
 Return the term frequency of the current term (if meaningful).
Xapian::termcount positionlist_count () const
 Return length of positionlist for current term.
PositionIterator positionlist_begin () const
 Return PositionIterator pointing to start of positionlist for current term.
PositionIterator positionlist_end () const
 Return PositionIterator pointing to end of positionlist for current term.
std::string get_description () const
 Return a string describing this object.

Public Attributes

Xapian::Internal::RefCntPtr
< Internal
internal


Detailed Description

An iterator pointing to items in a list of terms.

Definition at line 42 of file termiterator.h.


Member Typedef Documentation

Allow use as an STL iterator.

Definition at line 121 of file termiterator.h.

typedef std::input_iterator_tag Xapian::TermIterator::iterator_category

Allow use as an STL iterator.

Definition at line 119 of file termiterator.h.

typedef std::string* Xapian::TermIterator::pointer

Allow use as an STL iterator.

Definition at line 122 of file termiterator.h.

typedef std::string& Xapian::TermIterator::reference

Allow use as an STL iterator.

Definition at line 123 of file termiterator.h.

typedef std::string Xapian::TermIterator::value_type

Allow use as an STL iterator.

Definition at line 120 of file termiterator.h.


Constructor & Destructor Documentation

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

For internal use only.

Reference counted internals.

Definition at line 40 of file omtermlistiterator.cc.

References handle_prune(), and internal.

Xapian::TermIterator::TermIterator (  ) 

Default constructor - for declaring an uninitialised iterator.

Definition at line 50 of file omtermlistiterator.cc.

References LOGCALL_VOID.

Xapian::TermIterator::~TermIterator (  ) 

Destructor.

Definition at line 55 of file omtermlistiterator.cc.

References LOGCALL_VOID.

Xapian::TermIterator::TermIterator ( const TermIterator other  ) 

Copying is allowed.

The internals are reference counted, so copying is also cheap.

Definition at line 59 of file omtermlistiterator.cc.

References LOGCALL_VOID.


Member Function Documentation

std::string Xapian::TermIterator::get_description (  )  const

Return a string describing this object.

Todo:
display contents of the object

Definition at line 141 of file omtermlistiterator.cc.

Referenced by DEFINE_TESTCASE().

Xapian::doccount Xapian::TermIterator::get_termfreq (  )  const

Return the term frequency of the current term (if meaningful).

The term frequency is the number of documents which a term indexes.

Definition at line 91 of file omtermlistiterator.cc.

References Assert, internal, LOGCALL, and RETURN.

Referenced by dbcheck(), DEFINE_TESTCASE(), and main().

Xapian::termcount Xapian::TermIterator::get_wdf (  )  const

string Xapian::TermIterator::operator* (  )  const

Return the current term.

Definition at line 73 of file omtermlistiterator.cc.

References Assert, internal, LOGCALL, and RETURN.

DerefWrapper_<std::string> Xapian::TermIterator::operator++ ( int   )  [inline]

Definition at line 72 of file termiterator.h.

Xapian::TermIterator & Xapian::TermIterator::operator++ (  ) 

Definition at line 100 of file omtermlistiterator.cc.

References Assert, handle_prune(), internal, and LOGCALL_VOID.

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

Assignment is allowed.

The internals are reference counted, so assignment is also cheap.

Definition at line 66 of file omtermlistiterator.cc.

References internal, and LOGCALL_VOID.

Xapian::PositionIterator Xapian::TermIterator::positionlist_begin (  )  const

Xapian::termcount Xapian::TermIterator::positionlist_count (  )  const

Return length of positionlist for current term.

Definition at line 123 of file omtermlistiterator.cc.

References Assert, internal, LOGCALL, and RETURN.

Referenced by dbcheck(), format_doc_termlist(), and serialise_document().

PositionIterator Xapian::TermIterator::positionlist_end (  )  const [inline]

void Xapian::TermIterator::skip_to ( const std::string &  tname  ) 

Advance the iterator to the specified term.

If the specified term isn't in the list, position ourselves on the first term after it (or at_end() if no greater terms are present).

Definition at line 112 of file omtermlistiterator.cc.

References Assert, handle_prune(), internal, and LOGCALL_VOID.

Referenced by DEFINE_TESTCASE().


Member Data Documentation

For internal use only.

Reference counted internals.

Definition at line 44 of file termiterator.h.

Referenced by get_termfreq(), get_wdf(), operator*(), operator++(), operator=(), Xapian::operator==(), positionlist_begin(), positionlist_count(), skip_to(), and TermIterator().


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.