Package org.webpki.cbor

Class CBORFloat

java.lang.Object

org.webpki.cbor.CBORObject

org.webpki.cbor.CBORFloat

All Implemented Interfaces:

Cloneable, Comparable<CBORObject>

public class CBORFloat
extends CBORObject

Class for holding CBOR float objects.

Numbers are in the IEEE 754 format using the length 16, 32, and 64 bit on the "wire". Which length to use is governed by the size and precision required to (minimally) correctly represent a number.

See Also:

• Non-Finite Numbers

Constructor Summary

Constructors

Constructor	Description
CBORFloat(double value)	Creates a CBOR float object.

Method Summary

Modifier and Type	Method	Description
static CBORObject	createExtendedFloat(double value)	Creates an "extended" CBOR float object.
int	length()	Get length of the serialized IEEE 754 object.

Methods inherited from class org.webpki.cbor.CBORObject

checkForUnread, clone, compareTo, encode, equals, getArray, getBigInteger, getBoolean, getBytes, getDateTime, getEpochTime, getExtendedFloat64, getFloat16, getFloat32, getFloat64, getInt16, getInt32, getInt64, getInt8, getMap, getSimple, getString, getTag, getUint16, getUint32, getUint64, getUint8, hashCode, isNull, scan, toDiagnosticNotation, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Details

CBORFloat

public CBORFloat(double value)

Creates a CBOR float object.

This constructor only implements support for finite ("regular") floating point numbers. That is, a Double.NaN argument causes a CBORException to be thrown.

CBORObject.getFloat64() is the decoder counterpart.

For NaN and Infinity support see createExtendedFloat(double).

Parameters:

value - Floating-point value

Method Details

createExtendedFloat

public static CBORObject createExtendedFloat(double value)

Creates an "extended" CBOR float object.

Unlike CBORFloat(double), this method also supports the Double.NaN, Double.POSITIVE_INFINITY, and Double.NEGATIVE_INFINITY non-finite variants.

CBORObject.getExtendedFloat64() is the decoder counterpart.

Note that return type is either CBORFloat or CBORNonFinite, depending on if the argument is a "regular" floating-point value of one of the non-finite variants.

Parameters:

value - Floating-point value

Returns:

CBORObject

Throws:

CBORException

See Also:

• CBORNonFinite(long)

length

public int length()

Get length of the serialized IEEE 754 object.

Note that you must cast a CBORObject to CBORFloat in order to access length().

Returns:

Length in bytes: 2, 4, or 8.