2002-10-30 13:56:46 -05:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
|
|
|
|
2004-03-04 09:41:28 -05:00
|
|
|
<!--
|
|
|
|
|
Copyright 1999-2004 The Apache Software Foundation
|
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
|
you may not use this file except in compliance with the License.
|
|
|
|
|
You may obtain a copy of the License at
|
|
|
|
|
|
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
|
|
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
|
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
|
See the License for the specific language governing permissions and
|
|
|
|
|
limitations under the License.
|
|
|
|
|
-->
|
|
|
|
|
|
|
|
|
|
|
2002-10-30 13:56:46 -05:00
|
|
|
<!-- Content Stylesheet for Site -->
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!-- start the processing -->
|
|
|
|
|
<!-- ====================================================================== -->
|
2002-12-12 01:23:48 -05:00
|
|
|
<!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<!-- Main Page Section -->
|
|
|
|
|
<!-- ====================================================================== -->
|
|
|
|
|
<html>
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2003-01-04 11:29:08 -05:00
|
|
|
|
2005-02-14 11:48:47 -05:00
|
|
|
<title>Apache Lucene - Index File Formats</title>
|
2002-10-30 13:56:46 -05:00
|
|
|
</head>
|
|
|
|
|
|
|
|
|
|
<body bgcolor="#ffffff" text="#000000" link="#525D76">
|
|
|
|
|
<table border="0" width="100%" cellspacing="0">
|
|
|
|
|
<!-- TOP IMAGE -->
|
|
|
|
|
<tr>
|
|
|
|
|
<td align="left">
|
2005-05-02 14:50:45 -04:00
|
|
|
<a href="http://www.apache.org"><img src="http://lucene.apache.org/java/docs/images/asf-logo.gif" width="387" height="100" border="0"/></a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</td>
|
|
|
|
|
<td align="right">
|
2005-02-14 11:48:47 -05:00
|
|
|
<a href="http://lucene.apache.org/"><img src="./images/lucene_green_300.gif" alt="Apache Lucene" border="0"/></a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" width="100%" cellspacing="4">
|
|
|
|
|
<tr><td colspan="2">
|
|
|
|
|
<hr noshade="" size="1"/>
|
|
|
|
|
</td></tr>
|
|
|
|
|
|
|
|
|
|
<tr>
|
|
|
|
|
<!-- LEFT SIDE NAVIGATION -->
|
|
|
|
|
<td width="20%" valign="top" nowrap="true">
|
2003-10-09 10:40:30 -04:00
|
|
|
|
|
|
|
|
<!-- ============================================================ -->
|
|
|
|
|
|
|
|
|
|
<p><strong>About</strong></p>
|
2002-10-30 13:56:46 -05:00
|
|
|
<ul>
|
|
|
|
|
<li> <a href="./index.html">Overview</a>
|
2005-05-14 19:05:04 -04:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./features.html">Features</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
2004-05-18 09:32:01 -04:00
|
|
|
<li> <a href="http://wiki.apache.org/jakarta-lucene/PoweredBy">Powered by Lucene</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./whoweare.html">Who We Are</a>
|
|
|
|
|
</li>
|
2005-03-26 07:58:35 -05:00
|
|
|
<li> <a href="./mailinglists.html">Mailing Lists</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p><strong>Resources</strong></p>
|
|
|
|
|
<ul>
|
2004-02-28 21:43:36 -05:00
|
|
|
<li> <a href="http://wiki.apache.org/jakarta-lucene">Wiki</a>
|
|
|
|
|
</li>
|
2004-12-30 16:50:43 -05:00
|
|
|
<li> <a href="http://wiki.apache.org/jakarta-lucene/LuceneFAQ">FAQ</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./gettingstarted.html">Getting Started</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./queryparsersyntax.html">Query Syntax</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./fileformats.html">File Formats</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./api/index.html">Javadoc</a>
|
|
|
|
|
</li>
|
|
|
|
|
<li> <a href="./contributions.html">Contributions</a>
|
2002-12-04 00:56:33 -05:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./benchmarks.html">Benchmarks</a>
|
2002-11-29 16:23:47 -05:00
|
|
|
</li>
|
2004-11-15 14:00:49 -05:00
|
|
|
<li> <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Lucene&short_desc=%5BPATCH%5D&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&order=Importance">Patches</a>
|
2002-11-07 15:18:09 -05:00
|
|
|
</li>
|
2004-11-15 14:00:49 -05:00
|
|
|
<li> <a href="http://issues.apache.org/bugzilla/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&product=Lucene&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug_file_loc_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&order=Importance">Lucene Bugs</a>
|
2002-12-04 00:56:33 -05:00
|
|
|
</li>
|
|
|
|
|
<li> <a href="./lucene-sandbox/">Lucene Sandbox</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p><strong>Download</strong></p>
|
|
|
|
|
<ul>
|
2004-11-29 08:34:57 -05:00
|
|
|
<li> <a href="http://www.apache.org/dyn/closer.cgi/jakarta/lucene/binaries/">Binaries</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
2004-11-29 08:34:57 -05:00
|
|
|
<li> <a href="http://www.apache.org/dyn/closer.cgi/jakarta/lucene/source/">Source Code</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
2005-03-11 22:13:09 -05:00
|
|
|
<li> <a href="http://svn.apache.org/viewcvs.cgi/lucene/">Source Repository</a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</td>
|
|
|
|
|
<td width="80%" align="left" valign="top">
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Index File Formats"><strong>Index File Formats</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
This document defines the index file formats used
|
2005-06-05 09:10:45 -04:00
|
|
|
in Lucene version 1.4 and above.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2005-02-14 11:48:47 -05:00
|
|
|
Apache Lucene is written in Java, but several
|
2004-10-13 17:01:12 -04:00
|
|
|
efforts are underway to write
|
|
|
|
|
<a href="http://wiki.apache.org/jakarta-lucene/LuceneImplementations">versions
|
|
|
|
|
of Lucene in other programming
|
2005-02-14 11:48:47 -05:00
|
|
|
languages</a>. If these versions are to remain compatible with Apache
|
2002-10-30 13:56:46 -05:00
|
|
|
Lucene, then a language-independent definition of the Lucene index
|
|
|
|
|
format is required. This document thus attempts to provide a
|
2005-02-14 11:48:47 -05:00
|
|
|
complete and independent definition of the Apache Lucene 1.4 file
|
2002-10-30 13:56:46 -05:00
|
|
|
formats.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
2004-03-29 07:46:36 -05:00
|
|
|
As Lucene evolves, this document should evolve.
|
2002-10-30 13:56:46 -05:00
|
|
|
Versions of Lucene in different programming languages should endeavor
|
|
|
|
|
to agree on file formats, and generate new versions of this document.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Compatibility notes are provided in this document,
|
|
|
|
|
describing how file formats have changed from prior versions.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Definitions"><strong>Definitions</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The fundamental concepts in Lucene are index,
|
|
|
|
|
document, field and term.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
An index contains a sequence of documents.
|
|
|
|
|
</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
A document is a sequence of fields.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
A field is a named sequence of terms.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
A term is a string.
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p>
|
|
|
|
|
The same string in two different fields is
|
|
|
|
|
considered a different term. Thus terms are represented as a pair of
|
|
|
|
|
strings, the first naming the field, and the second naming text
|
|
|
|
|
within the field.
|
|
|
|
|
</p>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Inverted Indexing"><strong>Inverted Indexing</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The index stores statistics about terms in order
|
|
|
|
|
to make term-based search more efficient. Lucene's
|
|
|
|
|
index falls into the family of indexes known as an <i>inverted
|
|
|
|
|
index.</i> This is because it can list, for a term, the documents that contain
|
|
|
|
|
it. This is the inverse of the natural relationship, in which
|
|
|
|
|
documents list terms.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Types of Fields"><strong>Types of Fields</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
In Lucene, fields may be <i>stored</i>, in which
|
|
|
|
|
case their text is stored in the index literally, in a non-inverted
|
|
|
|
|
manner. Fields that are inverted are called <i>indexed</i>. A field
|
|
|
|
|
may be both stored and indexed.</p>
|
|
|
|
|
<p>The text of a field may be <i>tokenized</i> into terms to be
|
|
|
|
|
indexed, or the text of a field may be used literally as a term to be indexed.
|
|
|
|
|
Most fields are
|
|
|
|
|
tokenized, but sometimes it is useful for certain identifier fields
|
|
|
|
|
to be indexed literally.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Segments"><strong>Segments</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
Lucene indexes may be composed of multiple sub-indexes, or<i>
|
|
|
|
|
segments</i>. Each segment is a fully independent index, which could be searched
|
|
|
|
|
separately. Indexes evolve by:
|
|
|
|
|
</p>
|
|
|
|
|
<ol>
|
|
|
|
|
<li><p>Creating new segments for newly added documents.</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li><p>Merging existing segments.</p>
|
|
|
|
|
</li>
|
|
|
|
|
</ol>
|
|
|
|
|
<p>
|
|
|
|
|
Searches may involve multiple segments and/or multiple indexes, each
|
|
|
|
|
index potentially composed of a set of segments.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Document Numbers"><strong>Document Numbers</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
Internally, Lucene refers to documents by an integer <i>document
|
|
|
|
|
number</i>. The first document added to an index is numbered zero, and each
|
|
|
|
|
subsequent document added gets a number one greater than the previous.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<br />
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Note that a document's number may change, so caution should be taken
|
|
|
|
|
when storing these numbers outside of Lucene. In particular, numbers may
|
|
|
|
|
change in the following situations:
|
|
|
|
|
</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
The
|
|
|
|
|
numbers stored in each segment are unique only within the segment,
|
|
|
|
|
and must be converted before they can be used in a larger context.
|
|
|
|
|
The standard technique is to allocate each segment a range of
|
|
|
|
|
values, based on the range of numbers used in that segment. To
|
|
|
|
|
convert a document number from a segment to an external value, the
|
|
|
|
|
segment's <i>base</i> document
|
|
|
|
|
number is added. To convert an external value back to a
|
|
|
|
|
segment-specific value, the segment is identified by the range that
|
|
|
|
|
the external value is in, and the segment's base value is
|
|
|
|
|
subtracted. For example two five document segments might be
|
|
|
|
|
combined, so that the first segment has a base value of zero, and
|
|
|
|
|
the second of five. Document three from the second segment would
|
|
|
|
|
have an external value of eight.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
When documents are deleted, gaps are created
|
|
|
|
|
in the numbering. These are eventually removed as the index evolves
|
|
|
|
|
through merging. Deleted documents are dropped when segments are
|
|
|
|
|
merged. A freshly-merged segment thus has no gaps in its numbering.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Overview"><strong>Overview</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
Each segment index maintains the following:
|
|
|
|
|
</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><p>Field names. This
|
|
|
|
|
contains the set of field names used in the index.
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li><p>Stored Field
|
|
|
|
|
values. This contains, for each document, a list of attribute-value
|
|
|
|
|
pairs, where the attributes are field names. These are used to
|
|
|
|
|
store auxiliary information about the document, such as its title,
|
|
|
|
|
url, or an identifier to access a
|
|
|
|
|
database. The set of stored fields are what is returned for each hit
|
|
|
|
|
when searching. This is keyed by document number.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li><p>Term dictionary.
|
|
|
|
|
A dictionary containing all of the terms used in all of the indexed
|
|
|
|
|
fields of all of the documents. The dictionary also contains the
|
|
|
|
|
number of documents which contain the term, and pointers to the
|
|
|
|
|
term's frequency and proximity data.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li><p>Term Frequency
|
|
|
|
|
data. For each term in the dictionary, the numbers of all the
|
|
|
|
|
documents that contain that term, and the frequency of the term in
|
|
|
|
|
that document.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li><p>Term Proximity
|
|
|
|
|
data. For each term in the dictionary, the positions that the term
|
|
|
|
|
occurs in each document.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li><p>Normalization
|
|
|
|
|
factors. For each field in each document, a value is stored that is
|
|
|
|
|
multiplied into the score for hits on that field.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
2004-02-28 21:43:36 -05:00
|
|
|
<li><p>Term Vectors. For each field in each document, the term vector
|
|
|
|
|
(sometimes called document vector) is stored. A term vector consists
|
2004-08-02 16:43:58 -04:00
|
|
|
of term text and term frequency.
|
2004-02-28 21:43:36 -05:00
|
|
|
</p>
|
|
|
|
|
</li>
|
2002-10-30 13:56:46 -05:00
|
|
|
<li><p>Deleted documents.
|
|
|
|
|
An optional file indicating which documents are deleted.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
<p>Details on each of these are provided in subsequent sections.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="File Naming"><strong>File Naming</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
All files belonging to a segment have the same name with varying
|
|
|
|
|
extensions. The extensions correspond to the different file formats
|
|
|
|
|
described below.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Typically, all segments
|
|
|
|
|
in an index are stored in a single directory, although this is not
|
|
|
|
|
required.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Primitive Types"><strong>Primitive Types</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Byte"><strong>Byte</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The most primitive type
|
|
|
|
|
is an eight-bit byte. Files are accessed as sequences of bytes. All
|
|
|
|
|
other data types are defined as sequences
|
|
|
|
|
of bytes, so file formats are byte-order independent.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="UInt32"><strong>UInt32</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
32-bit unsigned integers are written as four
|
|
|
|
|
bytes, high-order bytes first.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
2003-03-06 14:14:17 -05:00
|
|
|
UInt32 --> <Byte><sup>4</sup>
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Uint64"><strong>Uint64</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
64-bit unsigned integers are written as eight
|
|
|
|
|
bytes, high-order bytes first.
|
|
|
|
|
</p>
|
2003-10-08 13:09:24 -04:00
|
|
|
<p>UInt64 --> <Byte><sup>8</sup>
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="VInt"><strong>VInt</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
A variable-length format for positive integers is
|
|
|
|
|
defined where the high-order bit of each byte indicates whether more
|
|
|
|
|
bytes remain to be read. The low-order seven bits are appended as
|
|
|
|
|
increasingly more significant bits in the resulting integer value.
|
|
|
|
|
Thus values from zero to 127 may be stored in a single byte, values
|
|
|
|
|
from 128 to 16,383 may be stored in two bytes, and so on.
|
|
|
|
|
</p>
|
|
|
|
|
<p><b>VInt Encoding Example</b></p>
|
|
|
|
|
<table>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT"><b>Value</b>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT"><b>First byte</b>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT"><b>Second byte</b>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT"><b>Third byte</b>
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">0
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
00000000
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">1
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
00000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">2
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
00000010
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">...
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">127
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
01111111
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">128
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
10000000
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm">
|
|
|
|
|
00000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">129
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
10000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm">
|
|
|
|
|
00000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">130
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
10000010
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm">
|
|
|
|
|
00000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">...
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">16,383
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
11111111
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm">
|
|
|
|
|
01111111
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm"><br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">16,384
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
10000000
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm">
|
|
|
|
|
10000000
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm">
|
|
|
|
|
00000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">16,385
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
10000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm">
|
|
|
|
|
10000000
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm">
|
|
|
|
|
00000001
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
<tr>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p align="RIGHT">...
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: 0.11cm; margin-right: 0.01cm">
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.07cm; margin-right: 0.01cm">
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
<td bgcolor="#a0ddf0" colspan="" rowspan="" valign="top" align="left">
|
|
|
|
|
<font color="#000000" size="-1" face="arial,helvetica,sanserif">
|
|
|
|
|
|
|
|
|
|
<p class="western" align="RIGHT" style="margin-left: -0.47cm; margin-right: 0.01cm">
|
|
|
|
|
<br />
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
</font>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
</table>
|
|
|
|
|
<p>
|
|
|
|
|
This provides compression while still being
|
|
|
|
|
efficient to decode.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Chars"><strong>Chars</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
Lucene writes unicode
|
2005-08-27 18:10:34 -04:00
|
|
|
character sequences using Java's
|
|
|
|
|
<a href="http://en.wikipedia.org/wiki/UTF-8#Modified_UTF-8">"modified
|
|
|
|
|
UTF-8 encoding"</a>.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="String"><strong>String</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
Lucene writes strings as a VInt representing the length, followed by
|
|
|
|
|
the character data.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
String --> VInt, Chars
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Per-Index Files"><strong>Per-Index Files</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The files in this section exist one-per-index.
|
|
|
|
|
</p>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Segments File"><strong>Segments File</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The active segments in the index are stored in the
|
|
|
|
|
segment info file. An index only has
|
|
|
|
|
a single file in this format, and it is named "segments".
|
|
|
|
|
This lists each segment by name, and also contains the size of each
|
|
|
|
|
segment.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
2004-06-15 20:16:16 -04:00
|
|
|
Segments --> Format, Version, SegCount, <SegName, SegSize><sup>SegCount</sup>
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2004-06-15 20:16:16 -04:00
|
|
|
Format, SegCount, SegSize --> UInt32
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Version --> UInt64
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2003-03-06 14:14:17 -05:00
|
|
|
SegName --> String
|
2004-06-15 20:16:16 -04:00
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Format is -1 in Lucene 1.4.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Version counts how often the index has been
|
|
|
|
|
changed by adding or deleting documents.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
SegName is the name of the segment, and is used as the file name prefix
|
2004-06-15 20:16:16 -04:00
|
|
|
for all of the files that compose the segment's index.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
SegSize is the number of documents contained in the segment index.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Lock Files"><strong>Lock Files</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
Several files are used to indicate that another
|
2003-10-13 09:53:53 -04:00
|
|
|
process is using an index. Note that these files are not
|
|
|
|
|
stored in the index directory itself, but rather in the
|
|
|
|
|
system's temporary directory, as indicated in the Java
|
|
|
|
|
system property "java.io.tmpdir".
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
When a file named "commit.lock"
|
|
|
|
|
is present, a process is currently re-writing the "segments"
|
|
|
|
|
file and deleting outdated segment index files, or a process is
|
|
|
|
|
reading the "segments"
|
|
|
|
|
file and opening the files of the segments it names. This lock file
|
|
|
|
|
prevents files from being deleted by another process after a process
|
|
|
|
|
has read the "segments"
|
|
|
|
|
file but before it has managed to open all of the files of the
|
|
|
|
|
segments named therein.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
2003-10-13 09:53:53 -04:00
|
|
|
When a file named "write.lock"
|
2002-10-30 13:56:46 -05:00
|
|
|
is present, a process is currently adding documents to an index, or
|
|
|
|
|
removing files from that index. This lock file prevents several
|
|
|
|
|
processes from attempting to modify an index at the same time.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
2003-10-13 09:53:53 -04:00
|
|
|
<a name="Deletable File"><strong>Deletable File</strong></a>
|
2002-10-30 13:56:46 -05:00
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
2003-10-13 09:53:53 -04:00
|
|
|
A file named "deletable"
|
2002-10-30 13:56:46 -05:00
|
|
|
contains the names of files that are no longer used by the index, but
|
2004-08-02 16:43:58 -04:00
|
|
|
which could not be deleted. This is only used on Win32, where a
|
|
|
|
|
file may not be deleted while it is still open. On other platforms
|
|
|
|
|
the file contains only null bytes.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2003-10-13 09:53:53 -04:00
|
|
|
Deletable --> DeletableCount,
|
|
|
|
|
<DelableName><sup>DeletableCount</sup>
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-10-13 09:53:53 -04:00
|
|
|
<p>DeletableCount --> UInt32
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-10-13 09:53:53 -04:00
|
|
|
<p>DeletableName -->
|
2002-10-30 13:56:46 -05:00
|
|
|
String
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
2005-06-01 15:47:14 -04:00
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Compound Files"><strong>Compound Files</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>Starting with Lucene 1.4 the compound file format became default. This
|
|
|
|
|
is simply a container for all files described in the next section.</p>
|
|
|
|
|
<p>Compound (.cfs) --> FileCount, <DataOffset, FileName><sup>FileCount</sup>,
|
|
|
|
|
FileData<sup>FileCount</sup></p>
|
|
|
|
|
<p>FileCount --> VInt</p>
|
|
|
|
|
<p>DataOffset --> Long</p>
|
|
|
|
|
<p>FileName --> String</p>
|
|
|
|
|
<p>FileData --> raw file data</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
2002-10-30 13:56:46 -05:00
|
|
|
</table>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Per-Segment Files"><strong>Per-Segment Files</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The remaining files are all per-segment, and are
|
|
|
|
|
thus defined by suffix.
|
|
|
|
|
</p>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Fields"><strong>Fields</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p><br /><b>Field Info</b><br /></p>
|
|
|
|
|
<p>
|
|
|
|
|
Field names are
|
|
|
|
|
stored in the field info file, with suffix .fnm.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
FieldInfos
|
2003-03-06 14:14:17 -05:00
|
|
|
(.fnm) --> FieldsCount, <FieldName,
|
2002-10-30 13:56:46 -05:00
|
|
|
FieldBits><sup>FieldsCount</sup>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
2003-03-06 14:14:17 -05:00
|
|
|
FieldsCount --> VInt
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2003-03-06 14:14:17 -05:00
|
|
|
FieldName --> String
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2003-03-06 14:14:17 -05:00
|
|
|
FieldBits --> Byte
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
2004-02-28 21:43:36 -05:00
|
|
|
The low-order bit is one for
|
|
|
|
|
indexed fields, and zero for non-indexed fields. The second lowest-order
|
|
|
|
|
bit is one for fields that have term vectors stored, and zero for fields
|
|
|
|
|
without term vectors.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
Fields are numbered by their order in this file. Thus field zero is
|
|
|
|
|
the
|
|
|
|
|
first field in the file, field one the next, and so on. Note that,
|
|
|
|
|
like document numbers, field numbers are segment relative.
|
|
|
|
|
</p>
|
|
|
|
|
<p><br /><b>Stored Fields</b><br /></p>
|
|
|
|
|
<p>
|
|
|
|
|
Stored fields are represented by two files:
|
|
|
|
|
</p>
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
The field index, or .fdx file.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
This contains, for each document, a pointer to
|
|
|
|
|
its field data, as follows:
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
FieldIndex
|
2003-03-06 14:14:17 -05:00
|
|
|
(.fdx) -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<FieldValuesPosition><sup>SegSize</sup>
|
|
|
|
|
</p>
|
|
|
|
|
<p>FieldValuesPosition
|
|
|
|
|
--> Uint64
|
|
|
|
|
</p>
|
|
|
|
|
<p>This
|
|
|
|
|
is used to find the location within the field data file of the
|
|
|
|
|
fields of a particular document. Because it contains fixed-length
|
|
|
|
|
data, this file may be easily randomly accessed. The position of
|
|
|
|
|
document<i> n</i>'s<i> </i>field data is the Uint64 at <i>n*8</i> in
|
|
|
|
|
this file.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
The field data, or .fdt file.
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
This contains the stored fields of each document,
|
|
|
|
|
as follows:
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
2003-03-06 14:14:17 -05:00
|
|
|
FieldData (.fdt) -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<DocFieldData><sup>SegSize</sup>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>DocFieldData -->
|
2002-10-30 13:56:46 -05:00
|
|
|
FieldCount, <FieldNum, Bits, Value><sup>FieldCount</sup>
|
|
|
|
|
</p>
|
2004-06-23 21:02:27 -04:00
|
|
|
<p>FieldCount -->
|
2002-10-30 13:56:46 -05:00
|
|
|
VInt
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>FieldNum -->
|
2002-10-30 13:56:46 -05:00
|
|
|
VInt
|
|
|
|
|
</p>
|
2004-10-13 17:01:12 -04:00
|
|
|
|
|
|
|
|
<p><b>Lucene <= 1.4:</b></p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>Bits -->
|
2002-10-30 13:56:46 -05:00
|
|
|
Byte
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>Value -->
|
2002-10-30 13:56:46 -05:00
|
|
|
String
|
|
|
|
|
</p>
|
2004-10-13 17:01:12 -04:00
|
|
|
<p>Only the low-order bit of Bits is used. It is one for
|
2002-10-30 13:56:46 -05:00
|
|
|
tokenized fields, and zero for non-tokenized fields.
|
|
|
|
|
</p>
|
2004-10-13 17:01:12 -04:00
|
|
|
<p><b>Lucene >= 1.9:</b></p>
|
|
|
|
|
<p>Bits -->
|
|
|
|
|
Byte
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<ul>
|
|
|
|
|
<li>low order bit is one for tokenized fields</li>
|
|
|
|
|
<li>second bit is one for fields containing binary data</li>
|
2004-10-14 16:23:03 -04:00
|
|
|
<li>third bit is one for fields with compression option enabled
|
|
|
|
|
(if compression is enabled, the algorithm used is ZLIB)</li>
|
2004-10-13 17:01:12 -04:00
|
|
|
</ul>
|
|
|
|
|
</p>
|
|
|
|
|
<p>Value -->
|
2004-10-14 16:23:03 -04:00
|
|
|
String | BinaryValue (depending on Bits)
|
|
|
|
|
</p>
|
|
|
|
|
<p>BinaryValue -->
|
|
|
|
|
ValueSize, <Byte>^ValueSize
|
|
|
|
|
</p>
|
|
|
|
|
<p>ValueSize -->
|
|
|
|
|
VInt
|
2004-10-13 17:01:12 -04:00
|
|
|
</p>
|
|
|
|
|
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
</ol>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Term Dictionary"><strong>Term Dictionary</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The term dictionary is represented as two files:
|
|
|
|
|
</p>
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
The term infos, or tis file.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
TermInfoFile (.tis)-->
|
2004-03-29 17:30:40 -05:00
|
|
|
TIVersion, TermCount, IndexInterval, SkipInterval, TermInfos
|
|
|
|
|
</p>
|
|
|
|
|
<p>TIVersion -->
|
|
|
|
|
UInt32
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>TermCount -->
|
2004-03-29 17:30:40 -05:00
|
|
|
UInt64
|
|
|
|
|
</p>
|
|
|
|
|
<p>IndexInterval -->
|
|
|
|
|
UInt32
|
|
|
|
|
</p>
|
|
|
|
|
<p>SkipInterval -->
|
2002-10-30 13:56:46 -05:00
|
|
|
UInt32
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>TermInfos -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<TermInfo><sup>TermCount</sup>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>TermInfo -->
|
2004-03-30 12:28:11 -05:00
|
|
|
<Term, DocFreq, FreqDelta, ProxDelta, SkipDelta>
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>Term -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<PrefixLength, Suffix, FieldNum>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>Suffix -->
|
2002-10-30 13:56:46 -05:00
|
|
|
String
|
|
|
|
|
</p>
|
|
|
|
|
<p>PrefixLength,
|
2004-03-30 12:28:11 -05:00
|
|
|
DocFreq, FreqDelta, ProxDelta, SkipDelta<br /> --> VInt
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>This
|
|
|
|
|
file is sorted by Term. Terms are ordered first lexicographically
|
|
|
|
|
by the term's field name, and within that lexicographically by the
|
|
|
|
|
term's text.
|
|
|
|
|
</p>
|
2004-03-29 17:30:40 -05:00
|
|
|
<p>TIVersion names the version of the format
|
2004-06-15 20:16:16 -04:00
|
|
|
of this file and is -2 in Lucene 1.4.
|
2004-03-29 17:30:40 -05:00
|
|
|
</p>
|
2002-10-30 13:56:46 -05:00
|
|
|
<p>Term
|
|
|
|
|
text prefixes are shared. The PrefixLength is the number of initial
|
|
|
|
|
characters from the previous term which must be pre-pended to a
|
|
|
|
|
term's suffix in order to form the term's text. Thus, if the
|
|
|
|
|
previous term's text was "bone" and the term is "boy",
|
|
|
|
|
the PrefixLength is two and the suffix is "y".
|
|
|
|
|
</p>
|
|
|
|
|
<p>FieldNumber
|
|
|
|
|
determines the term's field, whose name is stored in the .fdt file.
|
|
|
|
|
</p>
|
|
|
|
|
<p>DocFreq
|
|
|
|
|
is the count of documents which contain the term.
|
|
|
|
|
</p>
|
|
|
|
|
<p>FreqDelta
|
|
|
|
|
determines the position of this term's TermFreqs within the .frq
|
|
|
|
|
file. In particular, it is the difference between the position of
|
|
|
|
|
this term's data in that file and the position of the previous
|
|
|
|
|
term's data (or zero, for the first term in the file).
|
|
|
|
|
</p>
|
|
|
|
|
<p>ProxDelta
|
|
|
|
|
determines the position of this term's TermPositions within the .prx
|
|
|
|
|
file. In particular, it is the difference between the position of
|
|
|
|
|
this term's data in that file and the position of the previous
|
|
|
|
|
term's data (or zero, for the first term in the file.
|
|
|
|
|
</p>
|
2004-03-30 12:28:11 -05:00
|
|
|
<p>SkipDelta determines the position of this
|
|
|
|
|
term's SkipData within the .frq file. In
|
|
|
|
|
particular, it is the number of bytes
|
|
|
|
|
after TermFreqs that the SkipData starts.
|
|
|
|
|
In other words, it is the length of the
|
|
|
|
|
TermFreq data.
|
|
|
|
|
</p>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<p>
|
|
|
|
|
The term info index, or .tii file.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
2004-03-29 17:30:40 -05:00
|
|
|
This contains every IndexInterval<sup>th</sup> entry from the .tis
|
2002-10-30 13:56:46 -05:00
|
|
|
file, along with its location in the "tis" file. This is
|
|
|
|
|
designed to be read entirely into memory and used to provide random
|
|
|
|
|
access to the "tis" file.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
The structure of this file is very similar to the
|
|
|
|
|
.tis file, with the addition of one item per record, the IndexDelta.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
TermInfoIndex (.tii)-->
|
2005-06-05 09:10:45 -04:00
|
|
|
TIVersion, IndexTermCount, IndexInterval, SkipInterval, TermIndices
|
|
|
|
|
</p>
|
|
|
|
|
<p>TIVersion -->
|
|
|
|
|
UInt32
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>IndexTermCount -->
|
2005-06-05 09:10:45 -04:00
|
|
|
UInt64
|
|
|
|
|
</p>
|
|
|
|
|
<p>IndexInterval -->
|
|
|
|
|
UInt32
|
|
|
|
|
</p>
|
|
|
|
|
<p>SkipInterval -->
|
|
|
|
|
UInt32
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>TermIndices -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<TermInfo, IndexDelta><sup>IndexTermCount</sup>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>IndexDelta -->
|
2005-06-05 09:10:45 -04:00
|
|
|
VLong
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>IndexDelta
|
2004-08-07 07:27:30 -04:00
|
|
|
determines the position of this term's TermInfo within the .tis file. In
|
2002-10-30 13:56:46 -05:00
|
|
|
particular, it is the difference between the position of this term's
|
2005-06-05 09:10:45 -04:00
|
|
|
entry in that file and the position of the previous term's entry.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2005-06-05 09:10:45 -04:00
|
|
|
<p>TODO: document skipInterval information</p>
|
2002-10-30 13:56:46 -05:00
|
|
|
</li>
|
|
|
|
|
</ol>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Frequencies"><strong>Frequencies</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The .frq file contains the lists of documents
|
|
|
|
|
which contain each term, along with the frequency of the term in that
|
|
|
|
|
document.
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>FreqFile (.frq) -->
|
2004-03-30 12:28:11 -05:00
|
|
|
<TermFreqs, SkipData><sup>TermCount</sup>
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>TermFreqs -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<TermFreq><sup>DocFreq</sup>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>TermFreq -->
|
2002-10-30 13:56:46 -05:00
|
|
|
DocDelta, Freq?
|
|
|
|
|
</p>
|
2004-03-30 12:28:11 -05:00
|
|
|
<p>SkipData -->
|
|
|
|
|
<SkipDatum><sup>DocFreq/SkipInterval</sup>
|
|
|
|
|
</p>
|
|
|
|
|
<p>SkipDatum -->
|
2004-03-29 17:30:40 -05:00
|
|
|
DocSkip,FreqSkip,ProxSkip
|
|
|
|
|
</p>
|
|
|
|
|
<p>DocDelta,Freq,DocSkip,FreqSkip,ProxSkip -->
|
2002-10-30 13:56:46 -05:00
|
|
|
VInt
|
|
|
|
|
</p>
|
|
|
|
|
<p>TermFreqs
|
|
|
|
|
are ordered by term (the term is implicit, from the .tis file).
|
|
|
|
|
</p>
|
|
|
|
|
<p>TermFreq
|
|
|
|
|
entries are ordered by increasing document number.
|
|
|
|
|
</p>
|
|
|
|
|
<p>DocDelta
|
|
|
|
|
determines both the document number and the frequency. In
|
|
|
|
|
particular, DocDelta/2 is the difference between this document number
|
|
|
|
|
and the previous document number (or zero when this is the first
|
|
|
|
|
document in a TermFreqs). When DocDelta is odd, the frequency is
|
|
|
|
|
one. When DocDelta is even, the frequency is read as another VInt.
|
|
|
|
|
</p>
|
|
|
|
|
<p>For
|
|
|
|
|
example, the TermFreqs for a term which occurs once in document seven
|
|
|
|
|
and three times in document eleven would be the following sequence of
|
|
|
|
|
VInts:
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p> 15,
|
2002-10-30 13:56:46 -05:00
|
|
|
22, 3
|
2004-03-29 17:30:40 -05:00
|
|
|
</p>
|
|
|
|
|
<p>DocSkip records the document number before every
|
|
|
|
|
SkipInterval<sup>th</sup> document in TermFreqs.
|
|
|
|
|
Document numbers are represented as differences
|
|
|
|
|
from the previous value in the sequence. FreqSkip
|
|
|
|
|
and ProxSkip record the position of every
|
|
|
|
|
SkipInterval<sup>th</sup> entry in FreqFile and
|
|
|
|
|
ProxFile, respectively. File positions are
|
|
|
|
|
relative to the start of TermFreqs and Positions,
|
|
|
|
|
to the previous SkipDatum in the sequence.
|
|
|
|
|
</p>
|
2004-03-30 12:28:11 -05:00
|
|
|
<p>For example, if DocFreq=35 and SkipInterval=16,
|
2004-03-29 17:30:40 -05:00
|
|
|
then there are two SkipData entries, containing
|
|
|
|
|
the 15<sup>th</sup> and 31<sup>st</sup> document
|
|
|
|
|
numbers in TermFreqs. The first FreqSkip names
|
|
|
|
|
the number of bytes after the beginning of
|
|
|
|
|
TermFreqs that the 16<sup>th</sup> SkipDatum
|
|
|
|
|
starts, and the second the number of bytes after
|
|
|
|
|
that that the 32<sup>nd</sup> starts. The first
|
|
|
|
|
ProxSkip names the number of bytes after the
|
|
|
|
|
beginning of Positions that the 16<sup>th</sup>
|
|
|
|
|
SkipDatum starts, and the second the number of
|
|
|
|
|
bytes after that that the 32<sup>nd</sup> starts.
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Positions"><strong>Positions</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>
|
|
|
|
|
The .prx file contains the lists of positions that
|
|
|
|
|
each term occurs at within documents.
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>ProxFile (.prx) -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<TermPositions><sup>TermCount</sup>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>TermPositions -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<Positions><sup>DocFreq</sup>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>Positions -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<PositionDelta><sup>Freq</sup>
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>PositionDelta -->
|
2002-10-30 13:56:46 -05:00
|
|
|
VInt
|
|
|
|
|
</p>
|
|
|
|
|
<p>TermPositions
|
|
|
|
|
are ordered by term (the term is implicit, from the .tis file).
|
|
|
|
|
</p>
|
|
|
|
|
<p>Positions
|
|
|
|
|
entries are ordered by increasing document number (the document
|
|
|
|
|
number is implicit from the .frq file).
|
|
|
|
|
</p>
|
|
|
|
|
<p>PositionDelta
|
|
|
|
|
is the difference between the position of the current occurrence in
|
|
|
|
|
the document and the previous occurrence (or zero, if this is the
|
|
|
|
|
first occurrence in this document).
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
For example, the TermPositions for a
|
|
|
|
|
term which occurs as the fourth term in one document, and as the
|
|
|
|
|
fifth and ninth term in a subsequent document, would be the following
|
|
|
|
|
sequence of VInts:
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p> 4,
|
2002-10-30 13:56:46 -05:00
|
|
|
5, 4
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Normalization Factors"><strong>Normalization Factors</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
2003-09-02 09:58:01 -04:00
|
|
|
<p>There's a norm file for each indexed field with a byte for
|
2003-10-13 09:53:53 -04:00
|
|
|
each document. The .f[0-9]* file contains,
|
2002-10-30 13:56:46 -05:00
|
|
|
for each document, a byte that encodes a value that is multiplied
|
|
|
|
|
into the score for hits on that field:
|
|
|
|
|
</p>
|
|
|
|
|
<p>Norms
|
2003-10-13 09:53:53 -04:00
|
|
|
(.f[0-9]*) --> <Byte><sup>SegSize</sup>
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
|
|
|
|
<p>Each
|
|
|
|
|
byte encodes a floating point value. Bits 0-2 contain the 3-bit
|
|
|
|
|
mantissa, and bits 3-8 contain the 5-bit exponent.
|
|
|
|
|
</p>
|
|
|
|
|
<p>These
|
|
|
|
|
are converted to an IEEE single float value as follows:
|
|
|
|
|
</p>
|
|
|
|
|
<ol>
|
|
|
|
|
<li><p>If
|
|
|
|
|
the byte is zero, use a zero float.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li><p>Otherwise,
|
|
|
|
|
set the sign bit of the float to zero;
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li><p>add
|
|
|
|
|
48 to the exponent and use this as the float's exponent;
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li><p>map
|
|
|
|
|
the mantissa to the high-order 3 bits of the float's mantissa; and
|
|
|
|
|
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li><p>set
|
|
|
|
|
the low-order 21 bits of the float's mantissa to zero.
|
|
|
|
|
</p>
|
|
|
|
|
</li>
|
|
|
|
|
</ol>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
2004-02-28 21:43:36 -05:00
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Term Vectors"><strong>Term Vectors</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<ol>
|
|
|
|
|
<li>
|
|
|
|
|
<p>The Document Index or .tvx file.</p>
|
|
|
|
|
<p>This contains, for each document, a pointer to the document data in the Document
|
|
|
|
|
(.tvd) file.
|
|
|
|
|
</p>
|
2004-03-29 17:30:40 -05:00
|
|
|
<p>DocumentIndex (.tvx) --> TVXVersion<DocumentPosition><sup>NumDocs</sup></p>
|
|
|
|
|
<p>TVXVersion --> Int</p>
|
2004-02-28 21:43:36 -05:00
|
|
|
<p>DocumentPosition --> UInt64</p>
|
|
|
|
|
<p>This is used to find the position of the Document in the .tvd file.</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<p>The Document or .tvd file.</p>
|
|
|
|
|
<p>This contains, for each document, the number of fields, a list of the fields with
|
|
|
|
|
term vector info and finally a list of pointers to the field information in the .tvf
|
|
|
|
|
(Term Vector Fields) file.</p>
|
|
|
|
|
<p>
|
2004-03-29 17:30:40 -05:00
|
|
|
Document (.tvd) --> TVDVersion<NumFields, FieldNums, FieldPositions,><sup>NumDocs</sup>
|
2004-02-28 21:43:36 -05:00
|
|
|
</p>
|
2004-03-29 17:30:40 -05:00
|
|
|
<p>TVDVersion --> Int</p>
|
2004-02-28 21:43:36 -05:00
|
|
|
<p>NumFields --> VInt</p>
|
|
|
|
|
<p>FieldNums --> <FieldNumDelta><sup>NumFields</sup></p>
|
|
|
|
|
<p>FieldNumDelta --> VInt</p>
|
|
|
|
|
<p>FieldPositions --> <FieldPosition><sup>NumFields</sup></p>
|
|
|
|
|
<p>FieldPosition --> VLong</p>
|
|
|
|
|
<p>The .tvd file is used to map out the fields that have term vectors stored and
|
|
|
|
|
where the field information is in the .tvf file.</p>
|
|
|
|
|
</li>
|
|
|
|
|
<li>
|
|
|
|
|
<p>The Field or .tvf file.</p>
|
|
|
|
|
<p>This file contains, for each field that has a term vector stored, a list of
|
|
|
|
|
the terms and their frequencies.</p>
|
2004-03-29 17:30:40 -05:00
|
|
|
<p>Field (.tvf) --> TVFVersion<NumTerms, NumDistinct, TermFreqs><sup>NumFields</sup></p>
|
|
|
|
|
<p>TVFVersion --> Int</p>
|
2004-02-28 21:43:36 -05:00
|
|
|
<p>NumTerms --> VInt</p>
|
|
|
|
|
<p>NumDistinct --> VInt -- Future Use</p>
|
|
|
|
|
<p>TermFreqs --> <TermText, TermFreq><sup>NumTerms</sup></p>
|
2004-06-12 12:54:37 -04:00
|
|
|
<p>TermText --> <PrefixLength, Suffix></p>
|
|
|
|
|
<p>PrefixLength --> VInt</p>
|
|
|
|
|
<p>Suffix --> String</p>
|
2004-02-28 21:43:36 -05:00
|
|
|
<p>TermFreq --> VInt</p>
|
2004-06-12 12:54:37 -04:00
|
|
|
<p>Term
|
|
|
|
|
text prefixes are shared. The PrefixLength is the number of initial
|
|
|
|
|
characters from the previous term which must be pre-pended to a
|
|
|
|
|
term's suffix in order to form the term's text. Thus, if the
|
|
|
|
|
previous term's text was "bone" and the term is "boy",
|
|
|
|
|
the PrefixLength is two and the suffix is "y".
|
|
|
|
|
</p>
|
2004-02-28 21:43:36 -05:00
|
|
|
</li>
|
|
|
|
|
</ol>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
2002-10-30 13:56:46 -05:00
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#828DA6">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Deleted Documents"><strong>Deleted Documents</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>The .del file is
|
|
|
|
|
optional, and only exists when a segment contains deletions:
|
|
|
|
|
</p>
|
|
|
|
|
<p>Deletions
|
2003-03-06 14:14:17 -05:00
|
|
|
(.del) --> ByteCount,BitCount,Bits
|
2002-10-30 13:56:46 -05:00
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>ByteSize,BitCount -->
|
2002-10-30 13:56:46 -05:00
|
|
|
Uint32
|
|
|
|
|
</p>
|
2003-03-06 14:14:17 -05:00
|
|
|
<p>Bits -->
|
2002-10-30 13:56:46 -05:00
|
|
|
<Byte><sup>ByteCount</sup>
|
|
|
|
|
</p>
|
|
|
|
|
<p>ByteCount
|
|
|
|
|
indicates the number of bytes in Bits. It is typically
|
|
|
|
|
(SegSize/8)+1.
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
BitCount
|
|
|
|
|
indicates the number of bits that are currently set in Bits.
|
|
|
|
|
</p>
|
|
|
|
|
<p>Bits
|
|
|
|
|
contains one bit for each document indexed. When the bit
|
|
|
|
|
corresponding to a document number is set, that document is marked as
|
|
|
|
|
deleted. Bit ordering is from least to most significant. Thus, if
|
|
|
|
|
Bits contains two bytes, 0x00 and 0x02, then document 9 is marked as
|
|
|
|
|
deleted.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
<table border="0" cellspacing="0" cellpadding="2" width="100%">
|
|
|
|
|
<tr><td bgcolor="#525D76">
|
|
|
|
|
<font color="#ffffff" face="arial,helvetica,sanserif">
|
|
|
|
|
<a name="Limitations"><strong>Limitations</strong></a>
|
|
|
|
|
</font>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td>
|
|
|
|
|
<blockquote>
|
|
|
|
|
<p>There
|
|
|
|
|
are a few places where these file formats limit the maximum number of
|
|
|
|
|
terms and documents to a 32-bit quantity, or to approximately 4
|
|
|
|
|
billion. This is not today a problem, but, in the long term,
|
|
|
|
|
probably will be. These should therefore be replaced with either
|
|
|
|
|
UInt64 values, or better yet, with VInt values which have no limit.
|
|
|
|
|
</p>
|
|
|
|
|
</blockquote>
|
|
|
|
|
</p>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td><br/></td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</td>
|
|
|
|
|
</tr>
|
|
|
|
|
|
|
|
|
|
<!-- FOOTER -->
|
|
|
|
|
<tr><td colspan="2">
|
|
|
|
|
<hr noshade="" size="1"/>
|
|
|
|
|
</td></tr>
|
|
|
|
|
<tr><td colspan="2">
|
|
|
|
|
<div align="center"><font color="#525D76" size="-1"><em>
|
2005-01-18 08:57:32 -05:00
|
|
|
Copyright © 1999-2005, The Apache Software Foundation
|
2002-10-30 13:56:46 -05:00
|
|
|
</em></font></div>
|
|
|
|
|
</td></tr>
|
|
|
|
|
</table>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
|
|
|
|
<!-- end the processing -->
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
