Package bitchanger.calculations

Interface ChangeableNumber

All Known Implementing Classes:

SimpleChangeableNumber

public interface ChangeableNumber

Interface that defines methods to convert numbers from any numeral system into another numeral system

Since:

Bitchanger 0.1.0

Version:

1.0.0

Author:

Tim Muehle

Field Summary

Fields

Modifier and Type	Field	Description
static String	NaN
static String	NEGATIVE_INFINITY
static String	POSITIVE_INFINITY

Method Summary

Modifier and Type	Method	Description
default double	asDouble()
javafx.beans.property.IntegerProperty	baseProperty()
javafx.beans.property.ReadOnlyStringProperty	logicStringProperty()
void	reset()	Resets the wrapped value.
void	set(double decValue)
void	setBin(String binValue)	Sets the value of this ChangeableNumber to the value of a binary string
void	setDec(String decValue)	Sets the value of this ChangeableNumber to the value of a decimal string
void	setHex(String hexValue)	Sets the value of this ChangeableNumber to the value of a hexadecimal string
void	setIEEE(String ieee, IEEEStandard standard)	Sets the value of this ChangeableNumber to a value of one of both IEEE standards (16 Bit or 32 Bit)
void	setOct(String octValue)	Sets the value of this ChangeableNumber to the value of an octal string
void	setValue(String value, int baseOfValue)	Sets the value of this ChangeableNumber to a value of any numeral system
javafx.beans.property.ReadOnlyStringProperty	stringProperty()
String	toBaseString(int base)	Returns the string representation of this ChangeableNumber to any base.
String	toBinString()	Returns the string representation of this ChangeableNumber as a binary string.
String	toDecString()	Returns the string representation of this ChangeableNumber as a decimal string.
String	toHexString()	Returns the string representation of this ChangeableNumber as a hexadecimal string.
String	toIEEEString(IEEEStandard standard)	Returns the String representation of this ChangeableNumber as IEEE standard String.
String	toOctString()	Returns the string representation of this ChangeableNumber as an octal string.

Field Detail

NaN

static final String NaN

See Also:

Constant Field Values

POSITIVE_INFINITY

static final String POSITIVE_INFINITY

See Also:

Constant Field Values

NEGATIVE_INFINITY

static final String NEGATIVE_INFINITY

See Also:

Constant Field Values

Method Detail

asDouble

default double asDouble()

set

void set(double decValue)
  throws NullPointerException,
         NumberFormatException,
         IllegalArgumentException,
         NumberOverflowException

Throws:

NullPointerException

NumberFormatException

IllegalArgumentException

NumberOverflowException

setHex

void setHex(String hexValue)
     throws NullPointerException,
            NumberFormatException,
            IllegalArgumentException

Sets the value of this ChangeableNumber to the value of a hexadecimal string

Parameters:

hexValue - New Value that is represented as a hexadecimal string by this class

Throws:

NullPointerException - if the parameter hexValue is null

NumberFormatException - if the parameter hexValue is not a number of the hexadecimal system

IllegalArgumentException - if hexValue is an empty string

setDec

void setDec(String decValue)
     throws NullPointerException,
            NumberFormatException,
            IllegalArgumentException

Sets the value of this ChangeableNumber to the value of a decimal string

Parameters:

decValue - New value that is represented as a decimal string by this class

Throws:

NullPointerException - if the parameter decValue is null

NumberFormatException - if the parameter decValue is not a number of the decimal system

IllegalArgumentException - if decValue is an empty string

setOct

void setOct(String octValue)
     throws NullPointerException,
            NumberFormatException,
            IllegalArgumentException

Sets the value of this ChangeableNumber to the value of an octal string

Parameters:

octValue - New value that is represented as an octal string by this class

Throws:

NullPointerException - if the parameter octValue is null

NumberFormatException - if the parameter octValue is not a number of the octal system

IllegalArgumentException - if octValue is an empty string

setBin

void setBin(String binValue)
     throws NullPointerException,
            NumberFormatException,
            IllegalArgumentException

Sets the value of this ChangeableNumber to the value of a binary string

Parameters:

binValue - New value that is represented as a binary string by this class

Throws:

NullPointerException - if the parameter binValue is null

NumberFormatException - if the parameter binValue is not a number of the binary system

IllegalArgumentException - if binValue is an empty string

setValue

void setValue(String value,
              int baseOfValue)
       throws NullPointerException,
              NumberFormatException,
              IllegalArgumentException

Sets the value of this ChangeableNumber to a value of any numeral system

Parameters:

value - New value that is represented as string by this class

baseOfValue - Base of the numeral system of value

Throws:

NullPointerException - if the parameter value is null

NumberFormatException - if the parameter value is not a number of the binary system

IllegalArgumentException - if value is an empty string or if baseOfValue leaves the range of values [2, 36] - see ConvertingNumbers.isValueToBase(int base, String value)

setIEEE

void setIEEE(String ieee,
             IEEEStandard standard)
      throws NullPointerException,
             NumberFormatException,
             IllegalArgumentException,
             NumberOverflowException

Sets the value of this ChangeableNumber to a value of one of both IEEE standards (16 Bit or 32 Bit)

Parameters:

ieee - New Value that is represented as a String, by this class

standard - Standard of the used IEEE standard of ieee

Throws:

NullPointerException - if the parameter ieee is null

NumberFormatException - if the parameter ieee is not a number of the binary system or has more characters than 16 respectively 32

IllegalArgumentException - if ieee is an empty String or standard is something else than 16 or 32

NumberOverflowException

Since:

Bitchanger 0.1.6

reset

void reset()

Resets the wrapped value. The previous value gets deleted! If a toString method is called after this method, an empty string will be returned.

The wrapped value can be set again by using one of the set methods.

toHexString

String toHexString()

Returns the string representation of this ChangeableNumber as a hexadecimal string.

The string is not labeled as hexadecimal, so the prefix is not leading!

Returns:

hexadecimal string representation of this ChangeableNumber

toDecString

String toDecString()

Returns the string representation of this ChangeableNumber as a decimal string.

Returns:

decimal string representation of this ChangeableNumber

toOctString

String toOctString()

Returns the string representation of this ChangeableNumber as an octal string.

The string is not labeled as octal, so the prefix is not leading!

Returns:

octal string representation of this ChangeableNumber

toBinString

String toBinString()

Returns the string representation of this ChangeableNumber as a binary string.

The string is not labeled as binary, so the prefix is not leading!

Returns:

binary string representation of this ChangeableNumber

toBaseString

String toBaseString(int base)
             throws IllegalArgumentException

Returns the string representation of this ChangeableNumber to any base.

The String is not labeled by a prefix!

Parameters:

base - Base of the numeral system, in which this ChangeableNumber is represented

Returns:

String representation of this ChangeableNumber to the committed base

Throws:

IllegalArgumentException - if base leaves the range of values [2, 36] - see ConvertingNumbers.isValueToBase(int, String)

toIEEEString

String toIEEEString(IEEEStandard standard)
             throws ArithmeticException

Returns the String representation of this ChangeableNumber as IEEE standard String.

Parameters:

standard - IEEE standard that is used for converting

Returns:

IEEE as String representation of this ChangeableNumber

Throws:

ArithmeticException - if this number cannot be presented by the given ieee standard

Since:

Bitchanger 0.1.6

stringProperty

javafx.beans.property.ReadOnlyStringProperty stringProperty()

Returns:

Since:

Bitchanger 0.1.7

logicStringProperty

javafx.beans.property.ReadOnlyStringProperty logicStringProperty()

Returns:

Since:

Bitchanger 0.1.7

baseProperty

javafx.beans.property.IntegerProperty baseProperty()

Returns:

Since:

Bitchanger 0.1.7