Class Parser


  • public final class Parser
    extends java.lang.Object
    Parser utilities.
    Since:
    10/02/2015 14:29:47
    • Constructor Summary

      Constructors 
      Constructor Description
      Parser()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static boolean parseBoolean​(java.lang.Object what)
      Method used to parse accepted boolean values in incoming messages
      static double parseDouble​(java.lang.String input)
      Quick double string parser that can handle negative and positive doubles but not exponents.
      static double parseDoubleException​(java.lang.String input)
      Quick double string parser that can handle negative and positive doubles but not exponents.
      static float parseFloat​(java.lang.String input)
      Convenience method which uses the double parser and casts the result.
      static float[] parseFloatArray​(java.lang.String input)
      Parses a float array in the form '[a, b, c, ...]
      static float[] parseFloatArrayException​(java.lang.String input)
      Parses a float array in the form '[a, b, c, ...]
      static float parseFloatException​(java.lang.String input)
      Convenience method which uses the double parser and casts the result.
      static int parseInt​(java.lang.String str)
      Parses an integer.
      static int parseIntException​(java.lang.String str)
      Parses an integer.
      static long parseLong​(java.lang.String input)
      Quick long string parser that can handle negative and positive values.
      static long parseLongException​(java.lang.String input)
      Quick long string parser that can handle negative and positive values.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • Parser

        public Parser()
    • Method Detail

      • parseLong

        public static long parseLong​(java.lang.String input)

        Quick long string parser that can handle negative and positive values.

        Parser supports leading/trailing whitespace.

        Parameters:
        input - String to parse
        Returns:
        Parsed long or 0 if the parsing fails
      • parseLongException

        public static long parseLongException​(java.lang.String input)
                                       throws java.lang.NumberFormatException

        Quick long string parser that can handle negative and positive values.

        Parser supports leading/trailing whitespace.

        Parameters:
        input - String to parse
        Returns:
        Parsed long or 0 if the parsing fails
        Throws:
        java.lang.NumberFormatException - If the given input can not be parsed
      • parseDouble

        public static double parseDouble​(java.lang.String input)

        Quick double string parser that can handle negative and positive doubles but not exponents.

        Parser supports NaN, +/-Inf, exponents and leading/trailing whitespace.

        Parser is mostly locale unaware except for dot and comma for decimal separator.

        Parameters:
        input - String to parse
        Returns:
        Parsed double or Double.NaN if the parsing fails See also parseDoubleException(String) If exceptions on invalid input is necessary
      • parseDoubleException

        public static double parseDoubleException​(java.lang.String input)
                                           throws java.lang.NumberFormatException

        Quick double string parser that can handle negative and positive doubles but not exponents.

        Parser supports NaN, +/-Inf and leading/trailing whitespace.

        Parser is mostly locale unaware except for dot and comma for decimal separator.

        Parameters:
        input - String to parse
        Returns:
        Parsed double or Double.NaN if the parsing fails
        Throws:
        java.lang.NumberFormatException - If the input string is invalid
      • parseBoolean

        public static boolean parseBoolean​(java.lang.Object what)
        Method used to parse accepted boolean values in incoming messages
        Parameters:
        what - What to parse
        Returns:
        True or false (also default return) depending on the value of what
      • parseInt

        public static int parseInt​(java.lang.String str)
        Parses an integer. If the input is not a valid integer representation it returns 0.
        Parameters:
        str - The input string.
        Returns:
        The integer representation of the string.
      • parseIntException

        public static int parseIntException​(java.lang.String str)
                                     throws java.lang.NumberFormatException
        Parses an integer. Throws a NumberFormatException if the input is not a valid integer representation.
        Parameters:
        str - The input string.
        Returns:
        The integer representation of the string.
        Throws:
        java.lang.NumberFormatException
      • parseFloat

        public static float parseFloat​(java.lang.String input)
        Convenience method which uses the double parser and casts the result. It will not throw Please check parseDouble(String).
        Parameters:
        input - The input string.
        Returns:
        The parsed float, or 0 if the parsing failed.
      • parseFloatException

        public static float parseFloatException​(java.lang.String input)
                                         throws java.lang.NumberFormatException
        Convenience method which uses the double parser and casts the result. Please check parseDoubleException(String)
        Parameters:
        input - The input string.
        Returns:
        The parsed float, or Float.NaN if the parsing failed.
        Throws:
        java.lang.NumberFormatException - if the parsing failed.
      • parseFloatArray

        public static float[] parseFloatArray​(java.lang.String input)
        Parses a float array in the form '[a, b, c, ...]
        Parameters:
        input - The input string.
        Returns:
        The parsed float array, or null if the parsing failed.
      • parseFloatArrayException

        public static float[] parseFloatArrayException​(java.lang.String input)
                                                throws java.lang.NumberFormatException
        Parses a float array in the form '[a, b, c, ...]
        Parameters:
        input - The input string.
        Returns:
        The parsed float array, or null if the parsing failed.
        Throws:
        java.lang.NumberFormatException