Package com.upokecenter.cbor

Class CBORDataUtilities

  • public final class CBORDataUtilities
extends java.lang.Object
    Contains methods useful for reading and writing data, with a focus on CBOR.

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static CBORObject ParseJSONNumber​(java.lang.String str)
      Parses a number whose format follows the JSON specification.
      static CBORObject ParseJSONNumber​(java.lang.String str, boolean integersOnly, boolean positiveOnly)
      Parses a number whose format follows the JSON specification (RFC 8259).
      static CBORObject ParseJSONNumber​(java.lang.String str, boolean integersOnly, boolean positiveOnly, boolean preserveNegativeZero)
      Parses a number whose format follows the JSON specification (RFC 8259).

      • Methods inherited from class java.lang.Object

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

    • Method Detail

      • ParseJSONNumber

        public static CBORObject ParseJSONNumber​(java.lang.String str)
        Parses a number whose format follows the JSON specification. See #ParseJSONNumber(string, integersOnly, parseOnly) for more information.
        Parameters:
        str - A string to parse. The string is not allowed to contain white space characters, including spaces.
        Returns:
        A CBOR object that represents the parsed number. Returns positive zero if the number is a zero that starts with a minus sign (such as "-0" or "-0.0"). Returns null if the parsing fails, including if the string is null or empty.

      • ParseJSONNumber

        public static CBORObject ParseJSONNumber​(java.lang.String str,
                                         boolean integersOnly,
                                         boolean positiveOnly)
        Parses a number whose format follows the JSON specification (RFC 8259). Roughly speaking, a valid number consists of an optional minus sign, one or more basic digits (starting with 1 to 9 unless the only digit is 0), an optional decimal point (".", full stop) with one or more basic digits, and an optional letter E or e with an optional plus or minus sign and one or more basic digits (the exponent).
        Parameters:
        str - A string to parse. The string is not allowed to contain white space characters, including spaces.
        integersOnly - If true, no decimal points or exponents are allowed in the string.
        positiveOnly - If true, only positive numbers are allowed (the leading minus is disallowed).
        Returns:
        A CBOR object that represents the parsed number. Returns positive zero if the number is a zero that starts with a minus sign (such as "-0" or "-0.0"). Returns null if the parsing fails, including if the string is null or empty.

      • ParseJSONNumber

        public static CBORObject ParseJSONNumber​(java.lang.String str,
                                         boolean integersOnly,
                                         boolean positiveOnly,
                                         boolean preserveNegativeZero)
        Parses a number whose format follows the JSON specification (RFC 8259). Roughly speaking, a valid number consists of an optional minus sign, one or more basic digits (starting with 1 to 9 unless the only digit is 0), an optional decimal point (".", full stop) with one or more basic digits, and an optional letter E or e with an optional plus or minus sign and one or more basic digits (the exponent).
        Parameters:
        str - A string to parse. The string is not allowed to contain white space characters, including spaces.
        integersOnly - If true, no decimal points or exponents are allowed in the string.
        positiveOnly - If true, only positive numbers are allowed (the leading minus is disallowed).
        preserveNegativeZero - If true, returns positive zero if the number is a zero that starts with a minus sign (such as "-0" or "-0.0"). Otherwise, returns negative zero in this case.
        Returns:
        A CBOR object that represents the parsed number. Returns null if the parsing fails, including if the string is null or empty.