Package blbutil

Class StringUtil

java.lang.Object
blbutil.StringUtil
public class StringUtil extends Object
Class StringUtil is a utility class with static methods for counting and returning delimited fields in a string.

  • Method Summary

    Modifier and Type
    Method
    Description
    static int
    countFields(String s)
    Returns the number of white-space delimited fields in the specified string.
    static int
    countFields(String s, char delimiter)
    Returns the number of delimited fields in the specified string.
    static int
    countFields(String s, char delimiter, int max)
    Returns Math.min(countFields(s, delimiter), max).
    static String[]
    getFields(String s)
    Returns an array obtained by trimming white-space from the beginning and end of the specified string, and splitting the resulting string around white space.
    static String[]
    getFields(String s, char delimiter)
    Returns an array obtained by splitting the specified string around the specified delimiter.
    static String[]
    getFields(String s, char delimiter, int limit)
    Returns an array obtained by splitting the specified string around the first (limit - 1) occurrences of the specified delimiter.
    static String[]
    getFields(String s, int limit)
    Returns an array obtained by trimming white-space from the beginning and end of the specified string, and splitting the resulting string around the first (limit-1) white-space delimiters.

    Methods inherited from class java.lang.Object

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

  • Method Details

    • countFields

      public static int countFields(String s, char delimiter)
      Returns the number of delimited fields in the specified string. Returns 0 if the specified string has length 0.
      Parameters:
      s - a string
      delimiter - a delimiter character
      Returns:
      the number of delimited fields in the specified string
      Throws:
      NullPointerException - if s == null

    • countFields

      public static int countFields(String s, char delimiter, int max)
      Returns Math.min(countFields(s, delimiter), max).
      Parameters:
      s - a string with 0 or more delimiter characters
      delimiter - the delimiter character
      max - the maximum value that can be returned
      Returns:
      Math.min(countFields(s, delimiter), max)
      Throws:
      NullPointerException - if s == null

    • getFields

      public static String[] getFields(String s, char delimiter)
      Returns an array obtained by splitting the specified string around the specified delimiter. The array returned by this method contains each substring of the string that does not contain the delimiter and that is preceded by the delimiter or the beginning of the string and that is terminated by the delimiter or the end of the string. The substrings in the array are in the order in which they occur in the specified string. If there are no delimiters in the specified string then the method return an array of length one, whose single element is the specified string.
      Parameters:
      s - a string
      delimiter - a delimiter character
      Returns:
      the array of strings obtained by splitting the specified string around the specified delimiter
      Throws:
      NullPointerException - if s == null

    • getFields

      public static String[] getFields(String s, char delimiter, int limit)
      Returns an array obtained by splitting the specified string around the first (limit - 1) occurrences of the specified delimiter. If the string contains fewer than (limit - 1) delimiter characters, the returned value will equal StringUtil.getFields(s, delimiter)
      Parameters:
      s - a string
      delimiter - a delimiter character
      limit - the maximum length of the returned array
      Returns:
      an array obtained by splitting the specified string around the specified delimiter
      Throws:
      NullPointerException - if s == null
      IllegalArgumentException - if limit < 2

    • countFields

      public static int countFields(String s)
      Returns the number of white-space delimited fields in the specified string. A field is a maximal set of consecutive characters that are not white space characters. White space is defined as any unicode characters less than or equal to '\u0020'.
      Parameters:
      s - a string
      Returns:
      the number of white-space delimited fields in the specified string
      Throws:
      NullPointerException - if s == null

    • getFields

      public static String[] getFields(String s)
      Returns an array obtained by trimming white-space from the beginning and end of the specified string, and splitting the resulting string around white space. White space is any maximal substring of unicode characters less than or equal to '\u0020'. White-space at the beginning and end of the string is ignored. The substrings in the returned array are in the order in which they occur in this string. If there is no white-space in the specified string, the method returns an array of length one whose single element is the trimmed string. If the specified string contains only white-space a string array of length 0 is returned.
      Parameters:
      s - a string
      Returns:
      the array of strings obtained by splitting the specified string around white space
      Throws:
      NullPointerException - if s == null

    • getFields

      public static String[] getFields(String s, int limit)

      Returns an array obtained by trimming white-space from the beginning and end of the specified string, and splitting the resulting string around the first (limit-1) white-space delimiters. A white-space delimiter is any maximal substring of unicode characters less than or equal to '\u0020'. If the trimmed string contains fewer than (limit - 1) white space delimiters, the returned value will equal StringUtil.getFields(s). The substrings in the returned array are in the order in which they occur in this string. If there are no white-space delimiters in the specified string, the method returns an array of length one whose single element is the trimmed string. If the specified string contains only white-space, a string array of length 0 is returned.

      Parameters:
      s - a string
      limit - the maximum length of the returned array
      Returns:
      the array of strings obtained by splitting the specified string around white space
      Throws:
      NullPointerException - if s == null
      IllegalArgumentException - if limit < 2