Module is.codion.common.utilities
Package is.codion.common.utilities

Class Text

java.lang.Object
is.codion.common.utilities.Text
public final class Text extends Object
A utility class for working with text, such as collating and padding.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final PropertyValue<String>
    COLLATOR_LOCALE
    Specifies the default collator locale, as an IETF BCP 47 language tag - is, zh-TW, pt-BR.

  • Method Summary

    Modifier and Type
    Method
    Description
    static <T> List<T>
    collate(List<T> values)
    Sorts the given list in place, comparing the string representations of the list contents using the space aware collator.
    static <T> Comparator<T>
    collator()
    Returns a Comparator which compares the string representations of the objects using the Collator for the COLLATOR_LOCALE locale, taking spaces into account.
    static <T> Comparator<T>
    collator(Locale locale)
    Creates a Comparator which compares the string representations of the objects using the Collator for the given locale, taking spaces into account.
    static String
    leftPad(String string, int length, char padChar)
    Left pads the given string with the given pad character until a length of length has been reached
    static boolean
    nullOrEmpty(@Nullable String string)
    Returns true if the given string is null or empty.
    static boolean
    nullOrEmpty(@Nullable String... strings)
    Returns true if any of the given strings is null or empty.
    static List<String>
    parseCSV(@Nullable String csv)
    Splits and trims the given comma separated string.
    static String
    rightPad(String string, int length, char padChar)
    Right pads the given string with the given pad character until a length of length has been reached

    Methods inherited from class java.lang.Object

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

  • Field Details

    • COLLATOR_LOCALE

      public static final PropertyValue<String> COLLATOR_LOCALE
      Specifies the default collator locale, as an IETF BCP 47 language tag - is, zh-TW, pt-BR. A bare language is a valid tag, so the values this accepted when it took only a language still do.

      Note that the default is resolved when this class is loaded, so an application setting Locale.setDefault(Locale) must do so before anything touches Text.

      • Value type: String
      • Default value: Locale.getDefault().toLanguageTag().
      See Also:

  • Method Details

    • collate

      public static <T> List<T> collate(List<T> values)
      Sorts the given list in place, comparing the string representations of the list contents using the space aware collator.
      Type Parameters:
      T - the list element type
      Parameters:
      values - the list to sort (collate)
      Returns:
      the given list, sorted in place
      See Also:

    • collator

      public static <T> Comparator<T> collator()
      Returns a Comparator which compares the string representations of the objects using the Collator for the COLLATOR_LOCALE locale, taking spaces into account.

      Note that the locale is captured on first use; changing COLLATOR_LOCALE afterwards has no effect. Use collator(Locale) for a collator in a locale of your choosing.

      Type Parameters:
      T - the type of the objects to compare
      Returns:
      a space aware collator
      See Also:

    • collator

      public static <T> Comparator<T> collator(Locale locale)
      Creates a Comparator which compares the string representations of the objects using the Collator for the given locale, taking spaces into account.
      Type Parameters:
      T - the type of the objects to compare
      Parameters:
      locale - the collator locale
      Returns:
      a space aware collator

    • rightPad

      public static String rightPad(String string, int length, char padChar)
      Right pads the given string with the given pad character until a length of length has been reached
      Parameters:
      string - the string to pad
      length - the desired length
      padChar - the character to use for padding
      Returns:
      the padded string

    • leftPad

      public static String leftPad(String string, int length, char padChar)
      Left pads the given string with the given pad character until a length of length has been reached
      Parameters:
      string - the string to pad
      length - the desired length
      padChar - the character to use for padding
      Returns:
      the padded string

    • parseCSV

      public static List<String> parseCSV(@Nullable String csv)
      Splits and trims the given comma separated string. Returns an empty list in case of null or empty string argument. Empty segments are dropped, so "a,,b" yields [a, b].
      Parameters:
      csv - a String with comma separated values
      Returns:
      the trimmed values

    • nullOrEmpty

      public static boolean nullOrEmpty(@Nullable String string)
      Returns true if the given string is null or empty.
      Parameters:
      string - the string to check
      Returns:
      true if the given string is null or empty, false otherwise

    • nullOrEmpty

      public static boolean nullOrEmpty(@Nullable String... strings)
      Returns true if any of the given strings is null or empty.
      Parameters:
      strings - the strings to check
      Returns:
      true if one of the given strings is null or empty or if no arguments are provided, false otherwise