Package com.illumon.iris.libs.primitives

Class FloatPrimitives

java.lang.Object
com.illumon.iris.libs.primitives.FloatPrimitives
public class FloatPrimitives
extends Object
A set of commonly used functions that can be applied to Float types.

  • Constructor Summary

    Constructors 
    Constructor Description
    FloatPrimitives()  

  • Method Summary

    Modifier and Type Method Description
    static DbFloatArray array​(float[] values)
    Converts a primitive array to a DB array.
    static float[] concat​(float[]... values)
    Returns the concatenation of multiple arrays into a single array.
    static float[] concat​(DbFloatArray... values)
    Returns the concatenation of multiple arrays into a single array.
    static int count​(float[] values)
    Counts the number of non-null values.
    static int count​(DbFloatArray values)
    Counts the number of non-null values.
    static int count​(Float[] values)
    Counts the number of non-null values.
    static long countDistinct​(float[] values)
    Counts the number of distinct elements in the array.
    static long countDistinct​(float[] values, boolean countNull)
    Counts the number of distinct elements in the array.
    static long countDistinct​(DbFloatArray values)
    Counts the number of distinct elements in the array.
    static long countDistinct​(DbFloatArray values, boolean countNull)
    Counts the number of distinct elements in the array.
    static float[] distinct​(float[] values)
    Returns an array containing only the distinct values from the input.
    static float[] distinct​(float[] values, boolean includeNull, boolean sort)
    Returns an array containing only the distinct values from the input.
    static DbFloatArray distinct​(DbFloatArray values)
    Returns an array containing only the distinct values from the input.
    static DbFloatArray distinct​(DbFloatArray values, boolean includeNull, boolean sort)
    Returns an array containing only the distinct values from the input.
    static float[] enlist​(float... values)
    Returns a list containing its arguments.
    static float first​(float[] values)
    Returns the first value from an array.
    static float first​(DbFloatArray values)
    Returns the first value from an array.
    static float[] forwardFill​(float[] values)  
    static boolean in​(float testedValues, float... possibleValues)
    Checks if a value is within a discrete set of possible values.
    static boolean inRange​(float testedValue, float lowInclusiveValue, float highInclusiveValue)
    Checks if a value is within a range.
    static boolean isNull​(float value)
    Determines if a value is null.
    static float last​(float[] values)
    Returns the last value from an array.
    static float last​(DbFloatArray values)
    Returns the last value from an array.
    static float nth​(int index, float[] values)
    Returns the nth value from an array.
    static float nth​(int index, DbFloatArray values)
    Returns the nth value from an array.
    static float[] nullToValue​(float[] values, float defaultValue)
    Replaces null values with a default value.
    static float nullToValue​(float value, float defaultValue)
    Replaces null values with a default value.
    static float[] nullToValue​(DbFloatArray values, float defaultValue)
    Replaces null values with a default value.
    static float[] repeat​(float value, int size)
    Returns an array with a value repeated.
    static float[] reverse​(float... values)
    Returns an array with the values reversed.
    static float[] reverse​(DbFloatArray values)
    Returns an array with the values reversed.
    static float[] unbox​(Float... values)
    Unboxes a array of values.
    static float uniqueValue​(DbFloatArray arr, boolean countNull)
    Get the single unique value in the array, or null if there are none, or there are more than 1 distinct values.
    static float[] vec​(DbFloatArray values)
    Converts a DB array to a primitive array.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

  • Method Details

    • unbox

      public static float[] unbox​(Float... values)
      Unboxes a array of values.
      Parameters:
      values - values.
      Returns:
      unboxed array of values.

    • isNull

      public static boolean isNull​(float value)
      Determines if a value is null.
      Parameters:
      value - value.
      Returns:
      true if the value is null, and false otherwise.

    • nullToValue

      public static float nullToValue​(float value, float defaultValue)
      Replaces null values with a default value.
      Parameters:
      value - value.
      defaultValue - default value to return for null values.
      Returns:
      value, if value is not null, and defaultValue if value is null.

    • nullToValue

      public static float[] nullToValue​(float[] values, float defaultValue)
      Replaces null values with a default value.
      Parameters:
      values - values.
      defaultValue - default value to return for null values.
      Returns:
      values with nulls replaced by defaultValue.

    • nullToValue

      public static float[] nullToValue​(DbFloatArray values, float defaultValue)
      Replaces null values with a default value.
      Parameters:
      values - values.
      defaultValue - default value to return for null values.
      Returns:
      values with nulls replaced by defaultValue.

    • count

      public static int count​(Float[] values)
      Counts the number of non-null values.
      Parameters:
      values - values.
      Returns:
      number of non-null values.

    • count

      public static int count​(float[] values)
      Counts the number of non-null values.
      Parameters:
      values - values.
      Returns:
      number of non-null values.

    • count

      public static int count​(DbFloatArray values)
      Counts the number of non-null values.
      Parameters:
      values - values.
      Returns:
      number of non-null values.

    • last

      public static float last​(DbFloatArray values)
      Returns the last value from an array.
      Parameters:
      values - values.
      Returns:
      last value from the array.

    • last

      public static float last​(float[] values)
      Returns the last value from an array.
      Parameters:
      values - values.
      Returns:
      last value from the array.

    • first

      public static float first​(DbFloatArray values)
      Returns the first value from an array.
      Parameters:
      values - values.
      Returns:
      first value from the array.

    • first

      public static float first​(float[] values)
      Returns the first value from an array.
      Parameters:
      values - values.
      Returns:
      first value from the array.

    • nth

      public static float nth​(int index, DbFloatArray values)
      Returns the nth value from an array.
      Parameters:
      index - index of the value to return.
      values - values.
      Returns:
      nth value from the array or null, if the index is outside of the array's index range.

    • nth

      public static float nth​(int index, float[] values)
      Returns the nth value from an array.
      Parameters:
      index - index of the value to return.
      values - values.
      Returns:
      nth value from the array or null, if the index is outside of the array's index range.

    • vec

      public static float[] vec​(DbFloatArray values)
      Converts a DB array to a primitive array.
      Parameters:
      values - DB array
      Returns:
      primitive array.

    • array

      public static DbFloatArray array​(float[] values)
      Converts a primitive array to a DB array.
      Parameters:
      values - primitive array
      Returns:
      DB array.

    • inRange

      public static boolean inRange​(float testedValue, float lowInclusiveValue, float highInclusiveValue)
      Checks if a value is within a range.
      Parameters:
      testedValue - tested value.
      lowInclusiveValue - lower inclusive bound of the range.
      highInclusiveValue - upper inclusive bound of the range.
      Returns:
      true if the tested value is within the range, and false if the tested value is not in the range or is null.

    • in

      public static boolean in​(float testedValues, float... possibleValues)
      Checks if a value is within a discrete set of possible values.
      Parameters:
      testedValues - tested value.
      possibleValues - possible values.
      Returns:
      true if the tested value is contained in the possible values, and false otherwise.

    • countDistinct

      public static long countDistinct​(float[] values)
      Counts the number of distinct elements in the array.
      Parameters:
      values - values.
      Returns:
      number of distinct non-null values.

    • countDistinct

      public static long countDistinct​(DbFloatArray values)
      Counts the number of distinct elements in the array.
      Parameters:
      values - values.
      Returns:
      number of distinct non-null values.

    • countDistinct

      public static long countDistinct​(float[] values, boolean countNull)
      Counts the number of distinct elements in the array.
      Parameters:
      values - values.
      countNull - true to count null values, and false to exclude null values.
      Returns:
      number of distinct values.

    • countDistinct

      public static long countDistinct​(DbFloatArray values, boolean countNull)
      Counts the number of distinct elements in the array.
      Parameters:
      values - values.
      countNull - true to count null values, and false to exclude null values.
      Returns:
      number of distinct values.

    • uniqueValue

      public static float uniqueValue​(DbFloatArray arr, boolean countNull)
      Get the single unique value in the array, or null if there are none, or there are more than 1 distinct values.
      Parameters:
      arr - the array
      countNull - if nulls should count as values
      Returns:
      the single unique value in the array, or null.

    • distinct

      public static float[] distinct​(float[] values)
      Returns an array containing only the distinct values from the input.
      Parameters:
      values - values.
      Returns:
      unsorted array containing only distinct non-null items from arr.

    • distinct

      public static DbFloatArray distinct​(DbFloatArray values)
      Returns an array containing only the distinct values from the input.
      Parameters:
      values - values.
      Returns:
      unsorted array containing only distinct non-null items from arr.

    • distinct

      public static float[] distinct​(float[] values, boolean includeNull, boolean sort)
      Returns an array containing only the distinct values from the input.
      Parameters:
      values - values.
      includeNull - true to include null values, and false to exclude null values.
      sort - true to sort the resultant array
      Returns:
      array containing only distinct items from arr.

    • distinct

      public static DbFloatArray distinct​(DbFloatArray values, boolean includeNull, boolean sort)
      Returns an array containing only the distinct values from the input.
      Parameters:
      values - values.
      includeNull - true to include null values, and false to exclude null values.
      sort - true to sort the resultant array
      Returns:
      array containing only distinct items from arr.

    • repeat

      public static float[] repeat​(float value, int size)
      Returns an array with a value repeated.
      Parameters:
      value - value.
      size - number of times to repeat the value.
      Returns:
      array of repeated values. If size is less than zero, an empty array is returned.

    • enlist

      public static float[] enlist​(float... values)
      Returns a list containing its arguments.
      Parameters:
      values - values.
      Returns:
      list containing values.

    • concat

      public static float[] concat​(float[]... values)
      Returns the concatenation of multiple arrays into a single array.
      Parameters:
      values - values.
      Returns:
      concatenation of multiple arrays into a single array.

    • concat

      public static float[] concat​(DbFloatArray... values)
      Returns the concatenation of multiple arrays into a single array.
      Parameters:
      values - values.
      Returns:
      concatenation of multiple arrays into a single array.

    • reverse

      public static float[] reverse​(float... values)
      Returns an array with the values reversed.
      Parameters:
      values - values.
      Returns:
      array with the values reversed.

    • reverse

      public static float[] reverse​(DbFloatArray values)
      Returns an array with the values reversed.
      Parameters:
      values - values.
      Returns:
      array with the values reversed.

    • forwardFill

      public static float[] forwardFill​(float[] values)