## org.apache.lucene.search
Class TermRangeFilter

    java.lang.Object
      org.apache.lucene.search.Filter
          org.apache.lucene.search.MultiTermQueryWrapperFilter<TermRangeQuery>
              org.apache.lucene.search.TermRangeFilter

All Implemented Interfaces:
  Serializable

    public class TermRangeFilter

extends MultiTermQueryWrapperFilter<TermRangeQuery>

A Filter that restricts search results to a range of term values in a given field.

This filter matches the documents looking for terms that fall into the supplied range according to `String.compareTo(String)`, unless a `Collator` is provided. It is not intended for numerical ranges; use `NumericRangeFilter` instead.

If you construct a large number of range filters with different ranges but on the same field, `FieldCacheRangeFilter` may have significantly better performance.

Since:
  2.9
See Also:
  Serialized Form

Field Summary

Fields inherited from class org.apache.lucene.search.MultiTermQueryWrapperFilter
`query`

Constructor Summary
`TermRangeFilter(String fieldName, String lowerTerm, String upperTerm, boolean includeLower, boolean includeUpper)`
`TermRangeFilter(String fieldName, String lowerTerm, String upperTerm, boolean includeLower, boolean includeUpper, Collator collator)` WARNING: Using this constructor and supplying a non-null value in the `collator` parameter will cause every single index Term in the Field referenced by lowerTerm and/or upperTerm to be examined.

Method Summary
`Collator` `getCollator()` Returns the collator used to determine range inclusion, if any.
`String` `getField()` Returns the field name for this filter
`String` `getLowerTerm()` Returns the lower value of this range filter
`String` `getUpperTerm()` Returns the upper value of this range filter
`boolean` `includesLower()` Returns `true` if the lower endpoint is inclusive
`boolean` `includesUpper()` Returns `true` if the upper endpoint is inclusive
`static TermRangeFilter` `Less(String fieldName, String upperTerm)` Constructs a filter for field `fieldName` matching less than or equal to `upperTerm`.
`static TermRangeFilter` `More(String fieldName, String lowerTerm)` Constructs a filter for field `fieldName` matching greater than or equal to `lowerTerm`.

Methods inherited from class org.apache.lucene.search.MultiTermQueryWrapperFilter
`clearTotalNumberOfTerms, equals, getDocIdSet, getTotalNumberOfTerms, hashCode, toString`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Constructor Detail

### TermRangeFilter

    public TermRangeFilter(String fieldName,
                           String lowerTerm,
                           String upperTerm,
                           boolean includeLower,
                           boolean includeUpper)

Parameters:
  `fieldName` - The field this range applies to
  `lowerTerm` - The lower bound on this range
  `upperTerm` - The upper bound on this range
  `includeLower` - Does this range include the lower bound?
  `includeUpper` - Does this range include the upper bound?
Throws:
  `IllegalArgumentException` - if both terms are null or if lowerTerm is null and includeLower is true (similar for upperTerm and includeUpper)

### TermRangeFilter

    public TermRangeFilter(String fieldName,
                           String lowerTerm,
                           String upperTerm,
                           boolean includeLower,
                           boolean includeUpper,
                           Collator collator)

  WARNING: Using this constructor and supplying a non-null value in the `collator` parameter will cause every single index Term in the Field referenced by lowerTerm and/or upperTerm to be examined. Depending on the number of index Terms in this Field, the operation could be very slow.

  Parameters:
    `lowerTerm` - The lower bound on this range
    `upperTerm` - The upper bound on this range
    `includeLower` - Does this range include the lower bound?
    `includeUpper` - Does this range include the upper bound?
    `collator` - The collator to use when determining range inclusion; set to null to use Unicode code point ordering instead of collation.
  Throws:
    `IllegalArgumentException` - if both terms are null or if lowerTerm is null and includeLower is true (similar for upperTerm and includeUpper)

Method Detail

### Less

    public static TermRangeFilter Less(String fieldName,
                                       String upperTerm)

  Constructs a filter for field `fieldName` matching less than or equal to `upperTerm`.

### More

    public static TermRangeFilter More(String fieldName,
                                       String lowerTerm)

  Constructs a filter for field `fieldName` matching greater than or equal to `lowerTerm`.

### getField

    public String getField()

  Returns the field name for this filter

### getLowerTerm

    public String getLowerTerm()

  Returns the lower value of this range filter

### getUpperTerm

    public String getUpperTerm()

  Returns the upper value of this range filter

### includesLower

    public boolean includesLower()

  Returns `true` if the lower endpoint is inclusive

### includesUpper

    public boolean includesUpper()

  Returns `true` if the upper endpoint is inclusive

### getCollator

    public Collator getCollator()

  Returns the collator used to determine range inclusion, if any.