Package bitchanger.calculations

Class SimpleChangeableNumber

java.lang.Object

bitchanger.calculations.SimpleChangeableNumber

All Implemented Interfaces:

ChangeableNumber

public class SimpleChangeableNumber
extends Object
implements ChangeableNumber

The class SimpleChangeableNumber offers a complete implementation of ChangeableNumber.

Each instance of this class wraps a value, that gets set from different numeral systems and can get converted into any numeral system. The strings in these numeral systems do not contain any prefixes that refer to the base.

The string representations of the number systems are splitted into blocks for better readability. The blocks are four characters long in the hexadecimal and binary systems, in all other number systems the blocks are three characters long.

Since:

Bitchanger 0.1.0

Version:

1.0.2

Author:

Tim Muehle, Moritz Wolter

See Also:

ChangeableNumber

Field Summary

Fields inherited from interface bitchanger.calculations.ChangeableNumber

NaN, NEGATIVE_INFINITY, POSITIVE_INFINITY

Constructor Summary

Constructors

Constructor	Description
SimpleChangeableNumber()	Generates a new instance with 0 as wrapped value
SimpleChangeableNumber(String decValue)	Generates a new instance that represents the committed decimal value

Method Summary

Modifier and Type	Method	Description
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.
String	toString()	Returns a String that includes the hexadecimal, decimal, octal and binary presentation of the wrapped value.

Methods inherited from class java.lang.Object

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

Methods inherited from interface bitchanger.calculations.ChangeableNumber

asDouble

Constructor Detail

SimpleChangeableNumber

public SimpleChangeableNumber()

Generates a new instance with 0 as wrapped value

SimpleChangeableNumber

public SimpleChangeableNumber(String decValue)
                       throws NullPointerException,
                              NumberFormatException,
                              IllegalArgumentException

Generates a new instance that represents the committed decimal value

Parameters:

decValue - Value that should be wrapped by this object

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

Method Detail

set

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

Specified by:

set in interface ChangeableNumber

Throws:

NullPointerException

NumberFormatException

IllegalArgumentException

NumberOverflowException

setHex

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

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

Specified by:

setHex in interface ChangeableNumber

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

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

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

Specified by:

setDec in interface ChangeableNumber

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

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

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

Specified by:

setOct in interface ChangeableNumber

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

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

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

Specified by:

setBin in interface ChangeableNumber

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

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

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

Specified by:

setValue in interface ChangeableNumber

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

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

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

Specified by:

setIEEE in interface ChangeableNumber

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

reset

public 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.

Specified by:

reset in interface ChangeableNumber

toHexString

public 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!

Specified by:

toHexString in interface ChangeableNumber

Returns:

hexadecimal string representation of this ChangeableNumber

toDecString

public String toDecString()

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

Specified by:

toDecString in interface ChangeableNumber

Returns:

decimal string representation of this ChangeableNumber

toOctString

public 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!

Specified by:

toOctString in interface ChangeableNumber

Returns:

octal string representation of this ChangeableNumber

toBinString

public 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!

Specified by:

toBinString in interface ChangeableNumber

Returns:

binary string representation of this ChangeableNumber

toBaseString

public String toBaseString(int base)
                    throws IllegalArgumentException

Returns the string representation of this ChangeableNumber to any base.

The String is not labeled by a prefix!

Specified by:

toBaseString in interface ChangeableNumber

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)

toString

public String toString()

Returns a String that includes the hexadecimal, decimal, octal and binary presentation of the wrapped value.

Overrides:

toString in class Object

Returns:

String that consists of the hexadecimal, decimal, octal and binary String representation of the wrapped value. These Strings are cataloged consecutively.

toIEEEString

public String toIEEEString(IEEEStandard standard)
                    throws ArithmeticException

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

Specified by:

toIEEEString in interface ChangeableNumber

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

stringProperty

public javafx.beans.property.ReadOnlyStringProperty stringProperty()

Specified by:

stringProperty in interface ChangeableNumber

Returns:

logicStringProperty

public javafx.beans.property.ReadOnlyStringProperty logicStringProperty()

Specified by:

logicStringProperty in interface ChangeableNumber

Returns:

baseProperty

public javafx.beans.property.IntegerProperty baseProperty()

Specified by:

baseProperty in interface ChangeableNumber

Returns: