<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>Xapian: API Documentation: xapian-core: Xapian::Document Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head>
<body bgcolor="#ffffff">
<!-- Generated by Doxygen 1.5.2 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="classes.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="classes.html"><span>Alphabetical List</span></a></li>
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="nav">
<a class="el" href="namespaceXapian.html">Xapian</a>::<a class="el" href="classXapian_1_1Document.html">Document</a></div>
<h1>Xapian::Document Class Reference</h1><!-- doxytag: class="Xapian::Document" -->A handle representing a document in a <a class="el" href="namespaceXapian.html" title="The Xapian namespace contains public interfaces for the Xapian library.">Xapian</a> database.
<a href="#_details">More...</a>
<p>
<a href="classXapian_1_1Document-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#68c5a7dcf0736fa9e5eb339516133471">Document</a> (const <a class="el" href="classXapian_1_1Document.html">Document</a> &other)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copying is allowed. <a href="#68c5a7dcf0736fa9e5eb339516133471"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#39172a57e378b04bc0f4ec578da998f3">operator=</a> (const <a class="el" href="classXapian_1_1Document.html">Document</a> &other)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Assignment is allowed. <a href="#39172a57e378b04bc0f4ec578da998f3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#c2883bf83057f6c50ad0547fd4b9e01e">Document</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Make a new empty <a class="el" href="classXapian_1_1Document.html" title="A handle representing a document in a Xapian database.">Document</a>. <a href="#c2883bf83057f6c50ad0547fd4b9e01e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#38eba1ef86f1081ee13f07172fdc8e8e">~Document</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Destructor. <a href="#38eba1ef86f1081ee13f07172fdc8e8e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#2013eec715a0ee96eb2f0e721d44c84b">get_value</a> (<a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">Xapian::valueno</a> <a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">valueno</a>) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get value by number. <a href="#2013eec715a0ee96eb2f0e721d44c84b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#f7babb1a6368b95dd327f60b433016ac">add_value</a> (<a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">Xapian::valueno</a> <a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">valueno</a>, const std::string &value)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Add a new value. <a href="#f7babb1a6368b95dd327f60b433016ac"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#f67d865bf1d3950a38f6ae013f14827a">remove_value</a> (<a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">Xapian::valueno</a> <a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">valueno</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Remove any value with the given number. <a href="#f67d865bf1d3950a38f6ae013f14827a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#4d7ab6fd58c313a26b57295c9fe9a093">clear_values</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Remove all values associated with the document. <a href="#4d7ab6fd58c313a26b57295c9fe9a093"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#7be72f245722dbd1e26865ff19f6f476">get_data</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get data stored in the document. <a href="#7be72f245722dbd1e26865ff19f6f476"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#1a1903fab71d9f51bbd0958118b95d93">set_data</a> (const std::string &data)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set data stored in the document. <a href="#1a1903fab71d9f51bbd0958118b95d93"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#3cadc734caf3d1abdbc17290d515b546">add_posting</a> (const std::string &tname, <a class="el" href="namespaceXapian.html#2de139bd007f8cbe058d526cb311ebe4">Xapian::termpos</a> tpos, <a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> wdfinc=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Add an occurrence of a term at a particular position. <a href="#3cadc734caf3d1abdbc17290d515b546"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#28eb5f092a2efc25969f5c64b019c79c">add_term</a> (const std::string &tname, <a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> wdfinc=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Add a term to the document, without positional information. <a href="#28eb5f092a2efc25969f5c64b019c79c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#0ed9bb16cc80f83d57c18ef81df67b70">add_boolean_term</a> (const std::string &term)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Add a boolean filter term to the document. <a href="#0ed9bb16cc80f83d57c18ef81df67b70"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#b8df0010f2ef4d1a8027d69ace4fc464">remove_posting</a> (const std::string &tname, <a class="el" href="namespaceXapian.html#2de139bd007f8cbe058d526cb311ebe4">Xapian::termpos</a> tpos, <a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> wdfdec=1)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Remove a posting of a term from the document. <a href="#b8df0010f2ef4d1a8027d69ace4fc464"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#2d24a42cbdd6d021dc17cd6fbaf8d84a">remove_term</a> (const std::string &tname)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Remove a term and all postings associated with it. <a href="#2d24a42cbdd6d021dc17cd6fbaf8d84a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#2d8c6a0bb7f8bc744236c622f8ba3d84">clear_terms</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Remove all terms (and postings) from the document. <a href="#2d8c6a0bb7f8bc744236c622f8ba3d84"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#ded00d3fb4026b70f7c3c54aeb01de66">termlist_count</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The length of the termlist - i.e. <a href="#ded00d3fb4026b70f7c3c54aeb01de66"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classXapian_1_1TermIterator.html">TermIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#2b9aa32e61f9c832139e2fe12f00bcfc">termlist_begin</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Iterator for the terms in this document. <a href="#2b9aa32e61f9c832139e2fe12f00bcfc"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classXapian_1_1TermIterator.html">TermIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#3565b60c5b6c53708dbc8f73bf0588ad">termlist_end</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Equivalent end iterator for <a class="el" href="classXapian_1_1Document.html#2b9aa32e61f9c832139e2fe12f00bcfc" title="Iterator for the terms in this document.">termlist_begin()</a>. <a href="#3565b60c5b6c53708dbc8f73bf0588ad"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#7880e9c7ce1f08f2bf2b12c7f419d613">values_count</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Count the values in this document. <a href="#7880e9c7ce1f08f2bf2b12c7f419d613"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classXapian_1_1ValueIterator.html">ValueIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#fd5f1b7e0d43ecfb322fedf8435d1dda">values_begin</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Iterator for the values in this document. <a href="#fd5f1b7e0d43ecfb322fedf8435d1dda"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classXapian_1_1ValueIterator.html">ValueIterator</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#d02e2477df64beed0aff00682d0b9801">values_end</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Equivalent end iterator for <a class="el" href="classXapian_1_1Document.html#fd5f1b7e0d43ecfb322fedf8435d1dda" title="Iterator for the values in this document.">values_begin()</a>. <a href="#d02e2477df64beed0aff00682d0b9801"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="namespaceXapian.html#d8d873ad5830cff0b4bbd89d7da45d15">docid</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#5d1dacd8949ab86ea308efe79449997d">get_docid</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the document id which is associated with this document (if any). <a href="#5d1dacd8949ab86ea308efe79449997d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="classXapian_1_1Document.html#485b16fd13d0d36bc0f3a12af0a46167">get_description</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return a string describing this object. <a href="#485b16fd13d0d36bc0f3a12af0a46167"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
A handle representing a document in a <a class="el" href="namespaceXapian.html" title="The Xapian namespace contains public interfaces for the Xapian library.">Xapian</a> database.
<p>
The <a class="el" href="classXapian_1_1Document.html" title="A handle representing a document in a Xapian database.">Document</a> class fetches information from the database lazily. Usually this behaviour isn't visible to users (except for the speed benefits), but if the document in the database is modified or deleted, then preexisting <a class="el" href="classXapian_1_1Document.html" title="A handle representing a document in a Xapian database.">Document</a> objects may return the old or new versions of data (or throw <a class="el" href="classXapian_1_1DocNotFoundError.html" title="Indicates an attempt to access a document not present in the database.">Xapian::DocNotFoundError</a> in the case of deletion).<p>
Since <a class="el" href="classXapian_1_1Database.html" title="This class is used to access a database, or a group of databases.">Database</a> objects work on a snapshot of the database's state, the situation above can only happen with a <a class="el" href="classXapian_1_1WritableDatabase.html" title="This class provides read/write access to a database.">WritableDatabase</a> object, or if you call <a class="el" href="classXapian_1_1Database.html#d2c082b3246f8610405caab9d5ea615a" title="Re-open the database.">Database::reopen()</a> on a <a class="el" href="classXapian_1_1Database.html" title="This class is used to access a database, or a group of databases.">Database</a> object.<p>
We recommend you avoid designs where this behaviour is an issue.
<p>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="68c5a7dcf0736fa9e5eb339516133471"></a><!-- doxytag: member="Xapian::Document::Document" ref="68c5a7dcf0736fa9e5eb339516133471" args="(const Document &other)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Xapian::Document::Document </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classXapian_1_1Document.html">Document</a> & </td>
<td class="paramname"> <em>other</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Copying is allowed.
<p>
The internals are reference counted, so copying is cheap.
</div>
</div><p>
<a class="anchor" name="c2883bf83057f6c50ad0547fd4b9e01e"></a><!-- doxytag: member="Xapian::Document::Document" ref="c2883bf83057f6c50ad0547fd4b9e01e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Xapian::Document::Document </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Make a new empty <a class="el" href="classXapian_1_1Document.html" title="A handle representing a document in a Xapian database.">Document</a>.
<p>
</div>
</div><p>
<a class="anchor" name="38eba1ef86f1081ee13f07172fdc8e8e"></a><!-- doxytag: member="Xapian::Document::~Document" ref="38eba1ef86f1081ee13f07172fdc8e8e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Xapian::Document::~Document </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Destructor.
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="39172a57e378b04bc0f4ec578da998f3"></a><!-- doxytag: member="Xapian::Document::operator=" ref="39172a57e378b04bc0f4ec578da998f3" args="(const Document &other)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::operator= </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classXapian_1_1Document.html">Document</a> & </td>
<td class="paramname"> <em>other</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Assignment is allowed.
<p>
The internals are reference counted, so assignment is cheap.
</div>
</div><p>
<a class="anchor" name="2013eec715a0ee96eb2f0e721d44c84b"></a><!-- doxytag: member="Xapian::Document::get_value" ref="2013eec715a0ee96eb2f0e721d44c84b" args="(Xapian::valueno valueno) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Xapian::Document::get_value </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">Xapian::valueno</a> </td>
<td class="paramname"> <em>valueno</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get value by number.
<p>
Returns an empty string if no value with the given number is present in the document.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>valueno</em> </td><td>The number of the value. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="f7babb1a6368b95dd327f60b433016ac"></a><!-- doxytag: member="Xapian::Document::add_value" ref="f7babb1a6368b95dd327f60b433016ac" args="(Xapian::valueno valueno, const std::string &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::add_value </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">Xapian::valueno</a> </td>
<td class="paramname"> <em>valueno</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>value</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add a new value.
<p>
The new value will replace any existing value with the same number (or if the new value is empty, it will remove any existing value with the same number).
</div>
</div><p>
<a class="anchor" name="f67d865bf1d3950a38f6ae013f14827a"></a><!-- doxytag: member="Xapian::Document::remove_value" ref="f67d865bf1d3950a38f6ae013f14827a" args="(Xapian::valueno valueno)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::remove_value </td>
<td>(</td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#e163c06958fa73cfac44a38c3eea5c10">Xapian::valueno</a> </td>
<td class="paramname"> <em>valueno</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove any value with the given number.
<p>
</div>
</div><p>
<a class="anchor" name="4d7ab6fd58c313a26b57295c9fe9a093"></a><!-- doxytag: member="Xapian::Document::clear_values" ref="4d7ab6fd58c313a26b57295c9fe9a093" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::clear_values </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove all values associated with the document.
<p>
</div>
</div><p>
<a class="anchor" name="7be72f245722dbd1e26865ff19f6f476"></a><!-- doxytag: member="Xapian::Document::get_data" ref="7be72f245722dbd1e26865ff19f6f476" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Xapian::Document::get_data </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get data stored in the document.
<p>
This is a potentially expensive operation, and shouldn't normally be used in a match decider functor. Put data for use by match deciders in a value instead.
</div>
</div><p>
<a class="anchor" name="1a1903fab71d9f51bbd0958118b95d93"></a><!-- doxytag: member="Xapian::Document::set_data" ref="1a1903fab71d9f51bbd0958118b95d93" args="(const std::string &data)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::set_data </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>data</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set data stored in the document.
<p>
</div>
</div><p>
<a class="anchor" name="3cadc734caf3d1abdbc17290d515b546"></a><!-- doxytag: member="Xapian::Document::add_posting" ref="3cadc734caf3d1abdbc17290d515b546" args="(const std::string &tname, Xapian::termpos tpos, Xapian::termcount wdfinc=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::add_posting </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>tname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#2de139bd007f8cbe058d526cb311ebe4">Xapian::termpos</a> </td>
<td class="paramname"> <em>tpos</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> </td>
<td class="paramname"> <em>wdfinc</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add an occurrence of a term at a particular position.
<p>
Multiple occurrences of the term at the same position are represented only once in the positional information, but do increase the wdf.<p>
If the term is not already in the document, it will be added to it.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>tname</em> </td><td>The name of the term. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>tpos</em> </td><td>The position of the term. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wdfinc</em> </td><td>The increment that will be applied to the wdf for this term. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="28eb5f092a2efc25969f5c64b019c79c"></a><!-- doxytag: member="Xapian::Document::add_term" ref="28eb5f092a2efc25969f5c64b019c79c" args="(const std::string &tname, Xapian::termcount wdfinc=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::add_term </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>tname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> </td>
<td class="paramname"> <em>wdfinc</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add a term to the document, without positional information.
<p>
Any existing positional information for the term will be left unmodified.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>tname</em> </td><td>The name of the term. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wdfinc</em> </td><td>The increment that will be applied to the wdf for this term (default: 1). </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="0ed9bb16cc80f83d57c18ef81df67b70"></a><!-- doxytag: member="Xapian::Document::add_boolean_term" ref="0ed9bb16cc80f83d57c18ef81df67b70" args="(const std::string &term)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::add_boolean_term </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>term</em> </td>
<td> ) </td>
<td width="100%"><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Add a boolean filter term to the document.
<p>
This method adds <em>term</em> to the document with wdf of 0 - this is generally what you want for a term used for boolean filtering as the wdf of such terms is ignored, and it doesn't make sense for them to contribute to the document's length.<p>
If the specified term already indexes this document, this method has no effect.<p>
It is exactly the same as add_term(term, 0).<p>
This method was added in <a class="el" href="namespaceXapian.html" title="The Xapian namespace contains public interfaces for the Xapian library.">Xapian</a> 1.0.18.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>term</em> </td><td>The term to add. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="b8df0010f2ef4d1a8027d69ace4fc464"></a><!-- doxytag: member="Xapian::Document::remove_posting" ref="b8df0010f2ef4d1a8027d69ace4fc464" args="(const std::string &tname, Xapian::termpos tpos, Xapian::termcount wdfdec=1)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::remove_posting </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>tname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#2de139bd007f8cbe058d526cb311ebe4">Xapian::termpos</a> </td>
<td class="paramname"> <em>tpos</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> </td>
<td class="paramname"> <em>wdfdec</em> = <code>1</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove a posting of a term from the document.
<p>
Note that the term will still index the document even if all occurrences are removed. To remove a term from a document completely, use <a class="el" href="classXapian_1_1Document.html#2d24a42cbdd6d021dc17cd6fbaf8d84a" title="Remove a term and all postings associated with it.">remove_term()</a>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>tname</em> </td><td>The name of the term. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>tpos</em> </td><td>The position of the term. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wdfdec</em> </td><td>The decrement that will be applied to the wdf when removing this posting. The wdf will not go below the value of 0.</td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classXapian_1_1InvalidArgumentError.html" title="InvalidArgumentError indicates an invalid parameter value was passed to the API.">Xapian::InvalidArgumentError</a></em> </td><td>will be thrown if the term is not at the position specified in the position list for this term in this document.</td></tr>
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classXapian_1_1InvalidArgumentError.html" title="InvalidArgumentError indicates an invalid parameter value was passed to the API.">Xapian::InvalidArgumentError</a></em> </td><td>will be thrown if the term is not in the document </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="2d24a42cbdd6d021dc17cd6fbaf8d84a"></a><!-- doxytag: member="Xapian::Document::remove_term" ref="2d24a42cbdd6d021dc17cd6fbaf8d84a" args="(const std::string &tname)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::remove_term </td>
<td>(</td>
<td class="paramtype">const std::string & </td>
<td class="paramname"> <em>tname</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove a term and all postings associated with it.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>tname</em> </td><td>The name of the term.</td></tr>
</table>
</dl>
<dl compact><dt><b>Exceptions:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em><a class="el" href="classXapian_1_1InvalidArgumentError.html" title="InvalidArgumentError indicates an invalid parameter value was passed to the API.">Xapian::InvalidArgumentError</a></em> </td><td>will be thrown if the term is not in the document </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="2d8c6a0bb7f8bc744236c622f8ba3d84"></a><!-- doxytag: member="Xapian::Document::clear_terms" ref="2d8c6a0bb7f8bc744236c622f8ba3d84" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Xapian::Document::clear_terms </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Remove all terms (and postings) from the document.
<p>
</div>
</div><p>
<a class="anchor" name="ded00d3fb4026b70f7c3c54aeb01de66"></a><!-- doxytag: member="Xapian::Document::termlist_count" ref="ded00d3fb4026b70f7c3c54aeb01de66" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> Xapian::Document::termlist_count </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The length of the termlist - i.e.
<p>
the number of different terms which index this document.
</div>
</div><p>
<a class="anchor" name="2b9aa32e61f9c832139e2fe12f00bcfc"></a><!-- doxytag: member="Xapian::Document::termlist_begin" ref="2b9aa32e61f9c832139e2fe12f00bcfc" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classXapian_1_1TermIterator.html">TermIterator</a> Xapian::Document::termlist_begin </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Iterator for the terms in this document.
<p>
</div>
</div><p>
<a class="anchor" name="3565b60c5b6c53708dbc8f73bf0588ad"></a><!-- doxytag: member="Xapian::Document::termlist_end" ref="3565b60c5b6c53708dbc8f73bf0588ad" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classXapian_1_1TermIterator.html">TermIterator</a> Xapian::Document::termlist_end </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Equivalent end iterator for <a class="el" href="classXapian_1_1Document.html#2b9aa32e61f9c832139e2fe12f00bcfc" title="Iterator for the terms in this document.">termlist_begin()</a>.
<p>
</div>
</div><p>
<a class="anchor" name="7880e9c7ce1f08f2bf2b12c7f419d613"></a><!-- doxytag: member="Xapian::Document::values_count" ref="7880e9c7ce1f08f2bf2b12c7f419d613" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceXapian.html#3261017447607738e49eae6a2a4f5eec">Xapian::termcount</a> Xapian::Document::values_count </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Count the values in this document.
<p>
</div>
</div><p>
<a class="anchor" name="fd5f1b7e0d43ecfb322fedf8435d1dda"></a><!-- doxytag: member="Xapian::Document::values_begin" ref="fd5f1b7e0d43ecfb322fedf8435d1dda" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classXapian_1_1ValueIterator.html">ValueIterator</a> Xapian::Document::values_begin </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Iterator for the values in this document.
<p>
</div>
</div><p>
<a class="anchor" name="d02e2477df64beed0aff00682d0b9801"></a><!-- doxytag: member="Xapian::Document::values_end" ref="d02e2477df64beed0aff00682d0b9801" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classXapian_1_1ValueIterator.html">ValueIterator</a> Xapian::Document::values_end </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Equivalent end iterator for <a class="el" href="classXapian_1_1Document.html#fd5f1b7e0d43ecfb322fedf8435d1dda" title="Iterator for the values in this document.">values_begin()</a>.
<p>
</div>
</div><p>
<a class="anchor" name="5d1dacd8949ab86ea308efe79449997d"></a><!-- doxytag: member="Xapian::Document::get_docid" ref="5d1dacd8949ab86ea308efe79449997d" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="namespaceXapian.html#d8d873ad5830cff0b4bbd89d7da45d15">docid</a> Xapian::Document::get_docid </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the document id which is associated with this document (if any).
<p>
NB If multiple databases are being searched together, then this will be the document id in the individual database, not the merged database!<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>If this document came from a database, return the document id in that database. Otherwise, return 0. </dd></dl>
</div>
</div><p>
<a class="anchor" name="485b16fd13d0d36bc0f3a12af0a46167"></a><!-- doxytag: member="Xapian::Document::get_description" ref="485b16fd13d0d36bc0f3a12af0a46167" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string Xapian::Document::get_description </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Return a string describing this object.
<p>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li>xapian/<a class="el" href="document_8h.html">document.h</a></ul>
<hr>
<address><small>
Documentation for Xapian (version 1.0.21).<br>
Generated on 18 Jun 2010 by
<a href="http://www.doxygen.org/">Doxygen 1.5.2</a>.
</small></address>
</body>
</html>
