TokenUtils (Dataflow Library Distribution Project 6.6.0-111 API)

java.lang.Object
- com.pervasive.datarush.tokens.TokenUtils

```
public class TokenUtils
extends Object
```
Utilities for working with token values.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`asString(BinaryValued value)` Formats a binary value as a string suitable for output.
`static String`	`asString(BooleanValued value)` Formats a boolean value as a string suitable for output.
`static String`	`asString(CharValued value)` Formats a character value as a string suitable for output.
`static String`	`asString(DateValued value)` Formats a date value as a string suitable for output.
`static String`	`asString(DoubleValued value)` Formats a double value as a string suitable for output.
`static String`	`asString(FloatValued value)` Formats a float value as a string suitable for output.
`static String`	`asString(IntValued value)` Formats an integer value as a string suitable for output.
`static String`	`asString(LongValued value)` Formats a long value as a string suitable for output.
`static String`	`asString(NumericValued value)` Formats a numeric value as a string suitable for output.
`static String`	`asString(ObjectValued<?> value)` Formats an object value as a string suitable for output.
`static String`	`asString(StringValued value)` Formats a string value as a string suitable for output.
`static String`	`asString(TimestampValued value)` Formats a timestamp value as a string suitable for output.
`static String`	`asString(TimeValued value)` Formats a time value as a string suitable for output.
`static String`	`asString(TokenValued value)` Formats a token value as a string suitable for output.
`static DataToken`	`asToken(TokenValued value)` Creates an immutable copy of the given token value.
`static <T extends ScalarSettable> T[]`	`castFields(RecordSettable value, Class<T> clazz, String[] fieldNames)` Extracts the given list of field names, casting them to the specified type.
`static <T extends ScalarValued> T[]`	`castFields(RecordValued value, Class<T> clazz, String[] fieldNames)` Extracts the given list of field names, casting them to the specified type.
`static <T extends ScalarSettable> T[]`	`castFields(ScalarSettable[] fields, Class<T> clazz)` Casts an array of fields to the specified type
`static <T extends ScalarSettable> T[]`	`castFields(ScalarSettable[] fields, Class<T> clazz, Integer[] fieldIndices)` Extracts the given list of field indices, casting them to the specified type.
`static <T extends ScalarValued> T[]`	`castFields(ScalarValued[] fields, Class<T> clazz)` Casts an array of fields to the specified type
`static int`	`compare(BinaryValued value1, BinaryValued value2)` Indicates the relative ordering of two binary values in ascending order.
`static int`	`compare(BinaryValued value1, byte[] value2)` Indicates the relative ordering of a binary value and a non-null binary data array in ascending order.
`static int`	`compare(BooleanValued value1, BooleanValued value2)` Indicates the relative ordering of two boolean values in ascending order.
`static int`	`compare(CharValued value1, CharValued value2)` Indicates the relative ordering of two character values in ascending order.
`static int`	`compare(DateValued value1, DateValued value2)` Indicates the relative ordering of two date values in ascending order.
`static int`	`compare(DoubleValued value1, DoubleValued value2)` Indicates the relative ordering of two double values in ascending order.
`static int`	`compare(FloatValued value1, FloatValued value2)` Indicates the relative ordering of two float values in ascending order.
`static int`	`compare(IntValued value1, IntValued value2)` Indicates the relative ordering of two integer values in ascending order.
`static int`	`compare(LongValued value1, LongValued value2)` Indicates the relative ordering of two long values in ascending order.
`static int`	`compare(NumericValued value1, BigDecimal value2)` Indicates the relative ordering of a number value and a non-null `java.math.BigDecimal` in ascending order.
`static int`	`compare(NumericValued value1, double value2)` Indicates the relative ordering of a number value and a non-null `double` in ascending order.
`static int`	`compare(NumericValued value1, long value2)` Indicates the relative ordering of a number value and a non-null `long` in ascending order.
`static int`	`compare(NumericValued value1, NumericValued value2)` Indicates the relative ordering of two numeric values in ascending order.
`static <O extends Comparable<O>> int`	`compare(ObjectValued<O> value1, ObjectValued<O> value2)` Indicates the relative ordering of two object values in ascending order.
`static int`	`compare(ScalarValued value1, ScalarValued value2)` Indicates the relative ordering of two scalar values in ascending order.
`static int`	`compare(StringValued value1, StringValued value2)` Indicates the relative ordering of two string values in ascending order.
`static int`	`compare(TimestampValued value1, TimestampValued value2)` Indicates the relative ordering of two timestamp values in ascending order.
`static int`	`compare(TimeValued value1, TimeValued value2)` Indicates the relative ordering of two time values in ascending order.
`static int`	`compareByCodepoint(String value1, String value2)` Indicates the relative ordering of two string values by code point in ascending order.
`static BigDecimal`	`convert(double d)` Converts a double value to a `BigDecimal`.
`static BigDecimal`	`convert(long l)` Converts a long value to a `BigDecimal`.
`static boolean`	`equal(BinaryValued value1, BinaryValued value2)` Indicates whether two binary values are equal.
`static boolean`	`equal(BooleanValued value1, BooleanValued value2)` Indicates whether two boolean values are equal.
`static boolean`	`equal(CharValued value1, CharValued value2)` Indicates whether two character values are equal.
`static boolean`	`equal(DateValued value1, DateValued value2)` Indicates whether two date values are equal.
`static boolean`	`equal(DoubleValued value1, DoubleValued value2)` Indicates whether two double values are equal.
`static boolean`	`equal(FloatValued value1, FloatValued value2)` Indicates whether two float values are equal.
`static boolean`	`equal(IntValued value1, IntValued value2)` Indicates whether two integer values are equal.
`static boolean`	`equal(LongValued value1, LongValued value2)` Indicates whether two long values are equal.
`static boolean`	`equal(NumericValued value1, NumericValued value2)` Indicates whether two numeric values are equal.
`static <O> boolean`	`equal(ObjectValued<O> value1, ObjectValued<O> value2)` Indicates whether two object values are equal.
`static boolean`	`equal(StringValued value1, StringValued value2)` Indicates whether two string values are equal.
`static boolean`	`equal(TimestampValued value1, TimestampValued value2)` Indicates whether two timestamp values are equal.
`static boolean`	`equal(TimeValued value1, TimeValued value2)` Indicates whether two time values are equal.
`static double`	`forceDouble(NumericValued value)` Converts a numeric value to a double value, truncating if necessary.
`static float`	`forceFloat(NumericValued value)` Converts a numeric value to a float value, truncating if necessary.
`static int`	`forceInt(NumericValued value)` Converts a numeric value to an integer value, truncating if necessary.
`static long`	`forceLong(NumericValued value)` Converts a numeric value to a long value, truncating if necessary.
`static TokenValued`	`getNull(TokenType type)` Returns an appropriate null value for the given type.
`static ScalarTokenType[]`	`getTypes(ScalarValued[] values)` Extracts the types of an array of scalar token values.
`static DataToken`	`getZero(TokenType type)` Returns an appropriate zero value for the given type.
`static int`	`hashCode(BinaryValued value)` Computes a hash code for a binary value.
`static int`	`hashCode(BooleanValued value)` Computes a hash code for a boolean value.
`static int`	`hashCode(CharValued value)` Computes a hash code for a char value.
`static int`	`hashCode(DateValued value)` Computes a hash code for a date value.
`static int`	`hashCode(DoubleValued value)` Computes a hash code for a double value.
`static int`	`hashCode(FloatValued value)` Computes a hash code for a float value.
`static int`	`hashCode(IntValued value)` Computes a hash code for an integer value.
`static int`	`hashCode(LongValued value)` Computes a hash code for a long value.
`static int`	`hashCode(NumericValued value)` Computes a hash code for a numeric value.
`static int`	`hashCode(ObjectValued<?> value)` Computes a hash code for an object value.
`static int`	`hashCode(StringValued value)` Computes a hash code for a string value.
`static int`	`hashCode(TimestampValued value)` Computes a hash code for a string value.
`static int`	`hashCode(TimeValued value)` Computes a hash code for a time value.
`static ScalarToken`	`parse(ScalarTokenType type, String value)` Parses the given string as a value of the specified type.
`static ScalarSettable[]`	`selectFields(RecordSettable value, String[] fieldNames)` Extracts the given list of field setters from a writeable record buffer.
`static ScalarValued[]`	`selectFields(RecordValued value, String[] fieldNames)` Extracts the given list of field values from a record value.
`static void`	`transfer(TokenValued[] sources, TokenSettable[] dest)` Transfers the given array of sources to the array of destinations by-position.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - getTypes
```
public static ScalarTokenType[] getTypes(ScalarValued[] values)
```
    Extracts the types of an array of scalar token values.
    
    Parameters:
    
    values - the scalar token values whose types should be extracted
    
    Returns:
    
    an array of the token types, in the same order as the input values
  - selectFields
```
public static ScalarValued[] selectFields(RecordValued value,
                                          String[] fieldNames)
```
    Extracts the given list of field values from a record value.
    
    Parameters:
    
    value - the record to decompose
    
    fieldNames - the fields to extract
    
    Returns:
    
    the values of the the named fields, in the order they were specified.
  - selectFields
```
public static ScalarSettable[] selectFields(RecordSettable value,
                                            String[] fieldNames)
```
    Extracts the given list of field setters from a writeable record buffer.
    
    Parameters:
    
    value - the record to decompose
    
    fieldNames - the fields to extract
    
    Returns:
    
    the setters of the the named fields, in the order they were specified.
  - castFields
```
public static <T extends ScalarValued> T[] castFields(RecordValued value,
                                                      Class<T> clazz,
                                                      String[] fieldNames)
```
    Extracts the given list of field names, casting them to the specified type.
    
    Type Parameters:
    
    T - the type to which we are casting
    
    Parameters:
    
    value - The record from which we are extracting fields
    
    clazz - The type to which we are casting
    
    fieldNames - The list of field names to extract
    
    Returns:
    
    A list of fields in the order specified by fieldNames
  - castFields
```
public static <T extends ScalarSettable> T[] castFields(RecordSettable value,
                                                        Class<T> clazz,
                                                        String[] fieldNames)
```
    Extracts the given list of field names, casting them to the specified type.
    
    Type Parameters:
    
    T - the type to which we are casting
    
    Parameters:
    
    value - The record from which we are extracting fields
    
    clazz - The type to which we are casting
    
    fieldNames - The list of field names to extract
    
    Returns:
    
    A list of fields in the order specified by fieldNames
  - castFields
```
public static <T extends ScalarSettable> T[] castFields(ScalarSettable[] fields,
                                                        Class<T> clazz,
                                                        Integer[] fieldIndices)
```
    Extracts the given list of field indices, casting them to the specified type.
    
    Type Parameters:
    
    T - the type to which we are casting
    
    Parameters:
    
    fields - The array of fields
    
    clazz - The type to which we are casting
    
    fieldIndices - The list of field indices to extract
    
    Returns:
    
    A list of fields in the order specified by fieldNames
  - castFields
```
public static <T extends ScalarValued> T[] castFields(ScalarValued[] fields,
                                                      Class<T> clazz)
```
    Casts an array of fields to the specified type
    
    Type Parameters:
    
    T - the type to which we are casting
    
    Parameters:
    
    fields - the array of fields
    
    clazz - the type to cast the fields to
    
    Returns:
    
    The list of fields, casted to the specified type
  - castFields
```
public static <T extends ScalarSettable> T[] castFields(ScalarSettable[] fields,
                                                        Class<T> clazz)
```
    Casts an array of fields to the specified type
    
    Type Parameters:
    
    T - the type to which we are casting
    
    Parameters:
    
    fields - the array of fields
    
    clazz - the type to cast the fields to
    
    Returns:
    
    The list of fields, casted to the specified type
  - asToken
```
public static DataToken asToken(TokenValued value)
```
    Creates an immutable copy of the given token value.
    If a large number of values are to be converted, it is usually more efficient to use a TokenConverter instead of repeatedly calling this method.
    
    Parameters:
    
    value - the value to copy
    
    Returns:
    
    a token containing the same value as the input
  - convert
```
public static BigDecimal convert(double d)
```
    Converts a double value to a BigDecimal.
    
    Parameters:
    
    d - the value to convert
    
    Returns:
    
    a BigDecimal with the given value.
  - convert
```
public static BigDecimal convert(long l)
```
    Converts a long value to a BigDecimal.
    
    Parameters:
    
    l - the value to convert
    
    Returns:
    
    a BigDecimal with the given value.
  - forceDouble
```
public static double forceDouble(NumericValued value)
```
    Converts a numeric value to a double value, truncating if necessary. Precision will be lost if the source is wider than a double.
    
    Parameters:
    
    value - the source number value
    
    Returns:
    
    the number value as a double.
  - forceFloat
```
public static float forceFloat(NumericValued value)
```
    Converts a numeric value to a float value, truncating if necessary. Precision will be lost if the source is wider than a float.
    
    Parameters:
    
    value - the source number value
    
    Returns:
    
    the value as a float.
  - forceLong
```
public static long forceLong(NumericValued value)
```
    Converts a numeric value to a long value, truncating if necessary. Precision will be lost if the source is wider than a long.
    
    Parameters:
    
    value - the source number value
    
    Returns:
    
    the value as a long.
  - forceInt
```
public static int forceInt(NumericValued value)
```
    Converts a numeric value to an integer value, truncating if necessary. Precision will be lost if the source is wider than an int.
    
    Parameters:
    
    value - the source number value
    
    Returns:
    
    the value as an int.
  - hashCode
```
public static int hashCode(BinaryValued value)
```
    Computes a hash code for a binary value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(BooleanValued value)
```
    Computes a hash code for a boolean value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(CharValued value)
```
    Computes a hash code for a char value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(DateValued value)
```
    Computes a hash code for a date value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(DoubleValued value)
```
    Computes a hash code for a double value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(FloatValued value)
```
    Computes a hash code for a float value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(IntValued value)
```
    Computes a hash code for an integer value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(LongValued value)
```
    Computes a hash code for a long value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(NumericValued value)
```
    Computes a hash code for a numeric value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(ObjectValued<?> value)
```
    Computes a hash code for an object value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(StringValued value)
```
    Computes a hash code for a string value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(TimeValued value)
```
    Computes a hash code for a time value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - hashCode
```
public static int hashCode(TimestampValued value)
```
    Computes a hash code for a string value.
    
    Parameters:
    
    value - the value to hash
    
    Returns:
    
    the hash code for the value
  - asString
```
public static String asString(TokenValued value)
```
    Formats a token value as a string suitable for output.
    If a large number of values are to be formatted, it is usually more efficient to use a TokenConverter instead of repeatedly calling this method.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string value. A null value is represented as the empty string.
  - asString
```
public static String asString(BinaryValued value)
```
    Formats a binary value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a hexadecimal string encoding the value. A null value is represented as the empty string.
  - asString
```
public static String asString(BooleanValued value)
```
    Formats a boolean value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string representing the value. A null value is represented as the empty string.
  - asString
```
public static String asString(CharValued value)
```
    Formats a character value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string representing the value. A null value is represented as the empty string.
  - asString
```
public static String asString(DateValued value)
```
    Formats a date value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    an ISO 8601 formatted date string. A null value is represented as the empty string.
  - asString
```
public static String asString(DoubleValued value)
```
    Formats a double value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string representing the value. A null value is represented as the empty string.
  - asString
```
public static String asString(FloatValued value)
```
    Formats a float value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string representing the value. A null value is represented as the empty string.
  - asString
```
public static String asString(IntValued value)
```
    Formats an integer value as a string suitable for output.
    
    Parameters:
    
    value - i value to format
    
    Returns:
    
    a string representing the value. A null value is represented as the empty string.
  - asString
```
public static String asString(LongValued value)
```
    Formats a long value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string representing the value. A null value is represented as the empty string.
  - asString
```
public static String asString(NumericValued value)
```
    Formats a numeric value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string representing the value. A null value is represented as the empty string.
  - asString
```
public static String asString(ObjectValued<?> value)
```
    Formats an object value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string representing the value. The exact representation will depend on the implementation of toString() on the object. A null value is represented as the empty string.
  - asString
```
public static String asString(StringValued value)
```
    Formats a string value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    a string value. A null value is represented as the empty string.
  - asString
```
public static String asString(TimeValued value)
```
    Formats a time value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    an ISO 8601 time of day string with zone offset. A null value is represented as the empty string.
  - asString
```
public static String asString(TimestampValued value)
```
    Formats a timestamp value as a string suitable for output.
    
    Parameters:
    
    value - the value to format
    
    Returns:
    
    an ISO 8601 timestamp string. A null value is represented as the empty string.
  - equal
```
public static boolean equal(BinaryValued value1,
                            BinaryValued value2)
```
    Indicates whether two binary values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(BooleanValued value1,
                            BooleanValued value2)
```
    Indicates whether two boolean values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(CharValued value1,
                            CharValued value2)
```
    Indicates whether two character values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(DateValued value1,
                            DateValued value2)
```
    Indicates whether two date values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(DoubleValued value1,
                            DoubleValued value2)
```
    Indicates whether two double values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(FloatValued value1,
                            FloatValued value2)
```
    Indicates whether two float values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(IntValued value1,
                            IntValued value2)
```
    Indicates whether two integer values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(LongValued value1,
                            LongValued value2)
```
    Indicates whether two long values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(NumericValued value1,
                            NumericValued value2)
```
    Indicates whether two numeric values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static <O> boolean equal(ObjectValued<O> value1,
                                ObjectValued<O> value2)
```
    Indicates whether two object values are equal. Nulls are considered unequal in this context.
    
    Type Parameters:
    
    O - the type of the objects
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal (as determined by their equals() method), false otherwise
  - equal
```
public static boolean equal(StringValued value1,
                            StringValued value2)
```
    Indicates whether two string values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(TimeValued value1,
                            TimeValued value2)
```
    Indicates whether two time values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - equal
```
public static boolean equal(TimestampValued value1,
                            TimestampValued value2)
```
    Indicates whether two timestamp values are equal. Nulls are considered unequal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    true if the two values are equal, false otherwise
  - compare
```
public static int compare(BinaryValued value1,
                          BinaryValued value2)
```
    Indicates the relative ordering of two binary values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(BinaryValued value1,
                          byte[] value2)
```
    Indicates the relative ordering of a binary value and a non-null binary data array in ascending order.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second non-null value, as an array of binary data
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(BooleanValued value1,
                          BooleanValued value2)
```
    Indicates the relative ordering of two boolean values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(CharValued value1,
                          CharValued value2)
```
    Indicates the relative ordering of two character values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(DateValued value1,
                          DateValued value2)
```
    Indicates the relative ordering of two date values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(DoubleValued value1,
                          DoubleValued value2)
```
    Indicates the relative ordering of two double values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(FloatValued value1,
                          FloatValued value2)
```
    Indicates the relative ordering of two float values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(IntValued value1,
                          IntValued value2)
```
    Indicates the relative ordering of two integer values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(LongValued value1,
                          LongValued value2)
```
    Indicates the relative ordering of two long values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(NumericValued value1,
                          long value2)
```
    Indicates the relative ordering of a number value and a non-null long in ascending order. If necessary, the narrower of the two values will be widened.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(NumericValued value1,
                          double value2)
```
    Indicates the relative ordering of a number value and a non-null double in ascending order. If necessary, the narrower of the two values will be widened.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(NumericValued value1,
                          BigDecimal value2)
```
    Indicates the relative ordering of a number value and a non-null java.math.BigDecimal in ascending order. If necessary, the narrower of the two values will be widened.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(NumericValued value1,
                          NumericValued value2)
```
    Indicates the relative ordering of two numeric values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static <O extends Comparable<O>> int compare(ObjectValued<O> value1,
                                                    ObjectValued<O> value2)
```
    Indicates the relative ordering of two object values in ascending order. Nulls are considered equal in this context. The ordering is that defined by the object's compareTo(Object,Object) method; thus this is restricted to Java objects implementing Comparable.
    
    Type Parameters:
    
    O - the type of Java objects. This must be a comparable type.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(StringValued value1,
                          StringValued value2)
```
    Indicates the relative ordering of two string values in ascending order. Nulls are considered equal in this context. Strings are ordered based on the Unicode code points of their characters.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compareByCodepoint
```
public static int compareByCodepoint(String value1,
                                     String value2)
```
    Indicates the relative ordering of two string values by code point in ascending order. Unlike String.compareTo(String), this method produces an ordering consistent with Unicode code points. This ordering differs only for characters above Character.MAX_SURROGATE which have code points before those represented by any surrogate pair.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(TimeValued value1,
                          TimeValued value2)
```
    Indicates the relative ordering of two time values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(TimestampValued value1,
                          TimestampValued value2)
```
    Indicates the relative ordering of two timestamp values in ascending order. Nulls are considered equal in this context.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - compare
```
public static int compare(ScalarValued value1,
                          ScalarValued value2)
```
    Indicates the relative ordering of two scalar values in ascending order. Nulls are considered equal in this context. The two values must be of comparable types.
    If a large number of comparisons are to be done, it is more efficient to use a TokenComparator instead of repeatedly calling this method.
    
    Parameters:
    
    value1 - the first value
    
    value2 - the second value
    
    Returns:
    
    a negative integer, zero, or a positive integer if the first argument is respectively less than, equal to, or greater than the second.
  - getNull
```
public static TokenValued getNull(TokenType type)
```
    Returns an appropriate null value for the given type.
    
    Parameters:
    
    type - The token type.
    
    Returns:
    
    an appropriate null value for the given type.
  - transfer
```
public static void transfer(TokenValued[] sources,
                            TokenSettable[] dest)
```
    Transfers the given array of sources to the array of destinations by-position.
    
    Parameters:
    
    sources - The sources.
    
    dest - The desrinations. Must be the same length as sources
  - getZero
```
public static DataToken getZero(TokenType type)
```
    Returns an appropriate zero value for the given type.
    
    Parameters:
    
    type - The token type.
    
    Returns:
    
    an appropriate null value for the given type.
  - parse
```
public static ScalarToken parse(ScalarTokenType type,
                                String value)
```
    Parses the given string as a value of the specified type. If the value is available in a primitive form (that is, as an int or other datatype), it is more efficient to directly create a token instead of converting it to a string and parsing it.
    
    Parameters:
    
    type - the expected type of the value's string representation
    
    value - the string representation of a token value
    
    Returns:
    
    a token with the represented value

Class TokenUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getTypes

selectFields

selectFields

castFields

castFields

castFields

castFields

castFields

asToken

convert

convert

forceDouble

forceFloat

forceLong

forceInt

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

hashCode

asString

asString

asString

asString

asString

asString

asString

asString

asString

asString

asString

asString

asString

asString

equal

equal

equal

equal

equal

equal

equal

equal

equal

equal

equal

equal

equal

compare

compare

compare

compare

compare

compare

compare

compare

compare

compare

compare

compare

compare

compare

compare

compareByCodepoint

compare

compare

compare

getNull

transfer