org.apache.lucene.document
Class NumberTools

java.lang.Object
  extended by org.apache.lucene.document.NumberTools

Deprecated. For new indexes use NumericUtils instead, which provides a sortable binary representation (prefix encoded) of numeric values. To index and efficiently query numeric values use NumericField and NumericRangeQuery. This class is included for use with existing indices and will be removed in a future release (possibly Lucene 4.0).

@Deprecated
public class NumberTools
extends Object

Provides support for converting longs to Strings, and back again. The strings are structured so that lexicographic sorting order is preserved.

That is, if l1 is less than l2 for any two longs l1 and l2, then NumberTools.longToString(l1) is lexicographically less than NumberTools.longToString(l2). (Similarly for "greater than" and "equals".)

This class handles all long values (unlike DateField).


Field Summary
static String MAX_STRING_VALUE
          Deprecated. Equivalent to longToString(Long.MAX_VALUE)
static String MIN_STRING_VALUE
          Deprecated. Equivalent to longToString(Long.MIN_VALUE)
static int STR_SIZE
          Deprecated. The length of (all) strings returned by longToString(long)
 
Constructor Summary
NumberTools()
          Deprecated.  
 
Method Summary
static String longToString(long l)
          Deprecated. Converts a long to a String suitable for indexing.
static long stringToLong(String str)
          Deprecated. Converts a String that was returned by longToString(long) back to a long.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

MIN_STRING_VALUE

public static final String MIN_STRING_VALUE
Deprecated. 
Equivalent to longToString(Long.MIN_VALUE)

See Also:
Constant Field Values

MAX_STRING_VALUE

public static final String MAX_STRING_VALUE
Deprecated. 
Equivalent to longToString(Long.MAX_VALUE)

See Also:
Constant Field Values

STR_SIZE

public static final int STR_SIZE
Deprecated. 
The length of (all) strings returned by longToString(long)

Constructor Detail

NumberTools

public NumberTools()
Deprecated. 
Method Detail

longToString

public static String longToString(long l)
Deprecated. 
Converts a long to a String suitable for indexing.


stringToLong

public static long stringToLong(String str)
Deprecated. 
Converts a String that was returned by longToString(long) back to a long.

Throws:
IllegalArgumentException - if the input is null
NumberFormatException - if the input does not parse (it was not a String returned by longToString()).


Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.