beagled/Lucene.Net/Index/TermPositionVector.cs

   1 /*
   2  * Copyright 2004 The Apache Software Foundation
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  * http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 using System;
  18
  19 namespace Lucene.Net.Index
  20 {
  21
  22         /// <summary>Extends <code>TermFreqVector</code> to provide additional information about
  23         /// positions in which each of the terms is found. A TermPositionVector not necessarily
  24         /// contains both positions and offsets, but at least one of these arrays exists.
  25         /// </summary>
  26         public interface TermPositionVector : TermFreqVector
  27         {
  28
  29                 /// <summary>Returns an array of positions in which the term is found.
  30                 /// Terms are identified by the index at which its number appears in the
  31                 /// term String array obtained from the <code>indexOf</code> method.
  32                 /// May return null if positions have not been stored.
  33                 /// </summary>
  34                 int[] GetTermPositions(int index);
  35
  36                 /// <summary> Returns an array of TermVectorOffsetInfo in which the term is found.
  37                 /// May return null if offsets have not been stored.
  38                 ///
  39                 /// </summary>
  40                 /// <seealso cref="Lucene.Net.analysis.Token">
  41                 ///
  42                 /// </seealso>
  43                 /// <param name="index">The position in the array to get the offsets from
  44                 /// </param>
  45                 /// <returns> An array of TermVectorOffsetInfo objects or the empty list
  46                 /// </returns>
  47                 TermVectorOffsetInfo[] GetOffsets(int index);
  48         }
  49 }