database.h | database.h | |||
---|---|---|---|---|
skipping to change at line 307 | skipping to change at line 307 | |||
* | * | |||
* Empty keys are not valid, and specifying one will cause an | * Empty keys are not valid, and specifying one will cause an | |||
* exception. | * exception. | |||
* | * | |||
* @param key The key of the metadata item to access. | * @param key The key of the metadata item to access. | |||
* | * | |||
* @return The retrieved metadata item's value. | * @return The retrieved metadata item's value. | |||
* | * | |||
* @exception Xapian::InvalidArgumentError will be thrown if the | * @exception Xapian::InvalidArgumentError will be thrown if the | |||
* key supplied is empty. | * key supplied is empty. | |||
* | ||||
* @exception Xapian::UnimplementedError will be thrown if the | ||||
* database backend in use doesn't support user-specifie | ||||
d | ||||
* metadata. | ||||
*/ | */ | |||
std::string get_metadata(const std::string & key) const; | std::string get_metadata(const std::string & key) const; | |||
/** An iterator which returns all user-specified metadata keys. | /** An iterator which returns all user-specified metadata keys. | |||
* | * | |||
* When invoked on a Xapian::Database object representing multiple | * When invoked on a Xapian::Database object representing multiple | |||
* databases, currently only the metadata for the first is consider ed | * databases, currently only the metadata for the first is consider ed | |||
* but this behaviour may change in the future. | * but this behaviour may change in the future. | |||
* | * | |||
* If the backend doesn't support metadata, then this method return | ||||
s | ||||
* an iterator which compares equal to that returned by | ||||
* metadata_keys_end(). | ||||
* | ||||
* @param prefix If non-empty, only keys with this prefix are | * @param prefix If non-empty, only keys with this prefix are | |||
* returned. | * returned. | |||
* | ||||
* @exception Xapian::UnimplementedError will be thrown if the | ||||
* backend implements user-specified metadata, | ||||
but | ||||
* doesn't implement iterating its keys (curren | ||||
tly | ||||
* this happens for the InMemory backend). | ||||
*/ | */ | |||
Xapian::TermIterator metadata_keys_begin(const std::string &prefix = "") const; | Xapian::TermIterator metadata_keys_begin(const std::string &prefix = "") const; | |||
/// Corresponding end iterator to metadata_keys_begin(). | /// Corresponding end iterator to metadata_keys_begin(). | |||
Xapian::TermIterator metadata_keys_end(const std::string & = "") con st { | Xapian::TermIterator metadata_keys_end(const std::string & = "") con st { | |||
return Xapian::TermIterator(NULL); | return Xapian::TermIterator(NULL); | |||
} | } | |||
}; | }; | |||
/** This class provides read/write access to a database. | /** This class provides read/write access to a database. | |||
skipping to change at line 741 | skipping to change at line 746 | |||
* @param value The value of the metadata item to set. | * @param value The value of the metadata item to set. | |||
* | * | |||
* @exception Xapian::DatabaseError will be thrown if a problem occ urs | * @exception Xapian::DatabaseError will be thrown if a problem occ urs | |||
* while writing to the database. | * while writing to the database. | |||
* | * | |||
* @exception Xapian::DatabaseCorruptError will be thrown if the | * @exception Xapian::DatabaseCorruptError will be thrown if the | |||
* database is in a corrupt state. | * database is in a corrupt state. | |||
* | * | |||
* @exception Xapian::InvalidArgumentError will be thrown if the | * @exception Xapian::InvalidArgumentError will be thrown if the | |||
* key supplied is empty. | * key supplied is empty. | |||
* | ||||
* @exception Xapian::UnimplementedError will be thrown if the | ||||
* database backend in use doesn't support user-specifie | ||||
d | ||||
* metadata. | ||||
*/ | */ | |||
void set_metadata(const std::string & key, const std::string & value ); | void set_metadata(const std::string & key, const std::string & value ); | |||
/// Return a string describing this object. | /// Return a string describing this object. | |||
std::string get_description() const; | std::string get_description() const; | |||
}; | }; | |||
/** Open for read/write; create if no db exists. */ | /** Open for read/write; create if no db exists. */ | |||
const int DB_CREATE_OR_OPEN = 1; | const int DB_CREATE_OR_OPEN = 1; | |||
/** Create a new database; fail if db exists. */ | /** Create a new database; fail if db exists. */ | |||
End of changes. 4 change blocks. | ||||
5 lines changed or deleted | 17 lines changed or added | |||
document.h | document.h | |||
---|---|---|---|---|
/** \file document.h | /** \file document.h | |||
* \brief API for working with documents | * \brief API for working with documents | |||
*/ | */ | |||
/* Copyright 1999,2000,2001 BrightStation PLC | /* Copyright 1999,2000,2001 BrightStation PLC | |||
* Copyright 2002 Ananova Ltd | * Copyright 2002 Ananova Ltd | |||
* Copyright 2002,2003,2004,2006,2007 Olly Betts | * Copyright 2002,2003,2004,2006,2007,2009 Olly Betts | |||
* | * | |||
* This program is free software; you can redistribute it and/or | * This program is free software; you can redistribute it and/or | |||
* modify it under the terms of the GNU General Public License as | * modify it under the terms of the GNU General Public License as | |||
* published by the Free Software Foundation; either version 2 of the | * published by the Free Software Foundation; either version 2 of the | |||
* License, or (at your option) any later version. | * License, or (at your option) any later version. | |||
* | * | |||
* This program is distributed in the hope that it will be useful, | * This program is distributed in the hope that it will be useful, | |||
* but WITHOUT ANY WARRANTY; without even the implied warranty of | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |||
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |||
* GNU General Public License for more details. | * GNU General Public License for more details. | |||
skipping to change at line 76 | skipping to change at line 76 | |||
/** Get value by number. | /** Get value by number. | |||
* | * | |||
* Returns an empty string if no value with the given number is pre sent | * Returns an empty string if no value with the given number is pre sent | |||
* in the document. | * in the document. | |||
* | * | |||
* @param valueno The number of the value. | * @param valueno The number of the value. | |||
*/ | */ | |||
std::string get_value(Xapian::valueno valueno) const; | std::string get_value(Xapian::valueno valueno) const; | |||
/** Add a new value. It will replace any existing value with the | /** Add a new value. | |||
* same number. | * | |||
* The new value will replace any existing value with the same numb | ||||
er | ||||
* (or if the new value is empty, it will remove any existing value | ||||
* with the same number). | ||||
*/ | */ | |||
void add_value(Xapian::valueno valueno, const std::string &value); | void add_value(Xapian::valueno valueno, const std::string &value); | |||
/// Remove any value with the given number. | /// Remove any value with the given number. | |||
void remove_value(Xapian::valueno valueno); | void remove_value(Xapian::valueno valueno); | |||
/// Remove all values associated with the document. | /// Remove all values associated with the document. | |||
void clear_values(); | void clear_values(); | |||
/** Get data stored in the document. | /** Get data stored in the document. | |||
End of changes. 2 change blocks. | ||||
3 lines changed or deleted | 7 lines changed or added | |||
enquire.h | enquire.h | |||
---|---|---|---|---|
skipping to change at line 874 | skipping to change at line 874 | |||
* @param first the first item in the result set to return. | * @param first the first item in the result set to return. | |||
* A value of zero corresponds to the first item | * A value of zero corresponds to the first item | |||
* returned being that with the highest score. | * returned being that with the highest score. | |||
* A value of 10 corresponds to the first 10 items | * A value of 10 corresponds to the first 10 items | |||
* being ignored, and the returned items starting | * being ignored, and the returned items starting | |||
* at the eleventh. | * at the eleventh. | |||
* @param maxitems the maximum number of items to return. If you | * @param maxitems the maximum number of items to return. If you | |||
* want all matches, then you can pass the result | * want all matches, then you can pass the result | |||
* of calling get_doccount() on the Database objec t | * of calling get_doccount() on the Database objec t | |||
* (though if you are doing this so you can filter | * (though if you are doing this so you can filter | |||
* results, you are likely to get better performan | * results, you are likely to get much better | |||
ce | * performance by using Xapian's match-time filter | |||
* by using Xapian's match-time filtering features | ing | |||
* instead). | * 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, whi | ||||
ch | ||||
* is very quick, but means the estimates may be | ||||
* more approximate and the bounds may be much | ||||
* looser. | ||||
* @param checkatleast the minimum number of items to check. Beca use | * @param checkatleast the minimum number of items to check. Beca use | |||
* the matcher optimises, it won't consider every | * the matcher optimises, it won't consider every | |||
* document which might match, so the total number | * document which might match, so the total number | |||
* of matches is estimated. Setting checkatleast | * of matches is estimated. Setting checkatleast | |||
* forces it to consider at least this many matche s | * forces it to consider at least this many matche s | |||
* and so allows for reliable paging links. | * and so allows for reliable paging links. | |||
* @param omrset the relevance set to use when performing the qu ery. | * @param omrset the relevance set to use when performing the qu ery. | |||
* @param mdecider a decision functor to use to decide whether a | * @param mdecider a decision functor to use to decide whether a | |||
* given document should be put in the MSet. | * given document should be put in the MSet. | |||
* @param matchspy a decision functor to use to decide whether a | * @param matchspy a decision functor to use to decide whether a | |||
End of changes. 1 change blocks. | ||||
4 lines changed or deleted | 11 lines changed or added | |||
version.h | version.h | |||
---|---|---|---|---|
skipping to change at line 39 | skipping to change at line 39 | |||
#error The Xapian library was built with g++ 4.5.0 | #error The Xapian library was built with g++ 4.5.0 | |||
#endif | #endif | |||
#ifdef _GLIBCXX_DEBUG | #ifdef _GLIBCXX_DEBUG | |||
#error You are compiling with _GLIBCXX_DEBUG defined, but the library | #error You are compiling with _GLIBCXX_DEBUG defined, but the library | |||
#error was not compiled with this flag. The settings must match or your | #error was not compiled with this flag. The settings must match or your | |||
#error program will not work correctly. | #error program will not work correctly. | |||
#endif | #endif | |||
#endif | #endif | |||
#define XAPIAN_VERSION "1.0.12" | #define XAPIAN_VERSION "1.0.13" | |||
#define XAPIAN_MAJOR_VERSION 1 | #define XAPIAN_MAJOR_VERSION 1 | |||
#define XAPIAN_MINOR_VERSION 0 | #define XAPIAN_MINOR_VERSION 0 | |||
#define XAPIAN_REVISION 12 | #define XAPIAN_REVISION 13 | |||
#define XAPIAN_HAS_FLINT_BACKEND 1 | #define XAPIAN_HAS_FLINT_BACKEND 1 | |||
#define XAPIAN_HAS_QUARTZ_BACKEND 1 | #define XAPIAN_HAS_QUARTZ_BACKEND 1 | |||
#define XAPIAN_HAS_INMEMORY_BACKEND 1 | #define XAPIAN_HAS_INMEMORY_BACKEND 1 | |||
#define XAPIAN_HAS_REMOTE_BACKEND 1 | #define XAPIAN_HAS_REMOTE_BACKEND 1 | |||
#endif /* XAPIAN_INCLUDED_VERSION_H */ | #endif /* XAPIAN_INCLUDED_VERSION_H */ | |||
End of changes. 2 change blocks. | ||||
2 lines changed or deleted | 2 lines changed or added | |||