com.dd.plist

Class NSNumber

java.lang.Object

com.dd.plist.NSObject

com.dd.plist.NSNumber

All Implemented Interfaces:

Comparable<Object>

public class NSNumber
extends NSObject
implements Comparable<Object>

A number whose value is either an integer, a real number or boolean.

Author:

Daniel Dreibrodt

Field Summary

Fields

Modifier and Type	Field and Description
static int	BOOLEAN Indicates that the number's value is boolean.
static int	INTEGER Indicates that the number's value is an integer.
static int	REAL Indicates that the number's value is a real number.

Constructor Summary

Constructors

Constructor and Description
NSNumber(boolean b) Creates a boolean number.
NSNumber(byte[] bytes, int type) Parses integers and real numbers from their binary representation.
NSNumber(byte[] bytes, int startIndex, int endIndex, int type) Parses integers and real numbers from their binary representation.
NSNumber(double d) Creates a real number.
NSNumber(int i) Creates an integer number.
NSNumber(long l) Creates an integer number.
NSNumber(String text) Creates a number from its textual representation.

Method Summary

Modifier and Type	Method and Description
boolean	boolValue() The number's boolean value.
int	compareTo(Object o)
double	doubleValue() The number's double value.
boolean	equals(Object obj) Checks whether the other object is a NSNumber of the same value.
float	floatValue() The number's float value.
int	hashCode()
int	intValue() The number's int value.
boolean	isBoolean() Checks whether the value of this NSNumber is a boolean.
boolean	isInteger() Checks whether the value of this NSNumber is an integer.
boolean	isReal() Checks whether the value of this NSNumber is a real number.
long	longValue() The number's long value.
protected void	toASCII(StringBuilder ascii, int level) Generates the ASCII representation of this object.
protected void	toASCIIGnuStep(StringBuilder ascii, int level) Generates the ASCII representation of this object in the GnuStep format.
String	toString()
int	type() Gets the type of this number's value.

Methods inherited from class com.dd.plist.NSObject

fromJavaObject, toJavaObject, toJavaObject, toXMLPropertyList

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

INTEGER

public static final int INTEGER

Indicates that the number's value is an integer. The number is stored as a Java long. Its original value could have been char, short, int, long or even long long.

See Also:

Constant Field Values

REAL

public static final int REAL

Indicates that the number's value is a real number. The number is stored as a Java double. Its original value could have been float or double.

See Also:

Constant Field Values

BOOLEAN

public static final int BOOLEAN

Indicates that the number's value is boolean.

See Also:

Constant Field Values

Constructor Detail

NSNumber

public NSNumber(byte[] bytes,
                int type)

Parses integers and real numbers from their binary representation. Note: real numbers are not yet supported.

Parameters:

bytes - The binary representation of only this number

type - The type of number

See Also:

INTEGER, REAL

NSNumber

public NSNumber(byte[] bytes,
                int startIndex,
                int endIndex,
                int type)

Parses integers and real numbers from their binary representation. Note: real numbers are not yet supported.

Parameters:

bytes - array of bytes that contains this number's binary representation

startIndex - int with the position where to start reading from the byte array

endIndex - int with the position where to end reading from the byte array

type - The type of number

See Also:

INTEGER, REAL

NSNumber

public NSNumber(String text)

Creates a number from its textual representation.

Parameters:

text - The textual representation of the number.

Throws:

IllegalArgumentException - If the text does not represent an integer, real number or boolean value.

See Also:

Boolean.parseBoolean(java.lang.String), Long.parseLong(java.lang.String), Double.parseDouble(java.lang.String)

NSNumber

public NSNumber(int i)

Creates an integer number.

Parameters:

i - The integer value.

NSNumber

public NSNumber(long l)

Creates an integer number.

Parameters:

l - The long integer value.

NSNumber

public NSNumber(double d)

Creates a real number.

Parameters:

d - The real value.

NSNumber

public NSNumber(boolean b)

Creates a boolean number.

Parameters:

b - The boolean value.

Method Detail

type

public int type()

Gets the type of this number's value.

Returns:

The type flag.

See Also:

BOOLEAN, INTEGER, REAL

isBoolean

public boolean isBoolean()

Checks whether the value of this NSNumber is a boolean.

Returns:

Whether the number's value is a boolean.

isInteger

public boolean isInteger()

Checks whether the value of this NSNumber is an integer.

Returns:

Whether the number's value is an integer.

isReal

public boolean isReal()

Checks whether the value of this NSNumber is a real number.

Returns:

Whether the number's value is a real number.

boolValue

public boolean boolValue()

The number's boolean value.

Returns:

true if the value is true or non-zero, false otherwise.

longValue

public long longValue()

The number's long value.

Returns:

The value of the number as long

intValue

public int intValue()

The number's int value. Note: Even though the number's type might be INTEGER it can be larger than a Java int. Use intValue() only if you are certain that it contains a number from the int range. Otherwise the value might be innaccurate.

Returns:

The value of the number as int

doubleValue

public double doubleValue()

The number's double value.

Returns:

The value of the number as double.

floatValue

public float floatValue()

The number's float value. WARNING: Possible loss of precision if the value is outside the float range.

Returns:

The value of the number as float.

equals

public boolean equals(Object obj)

Checks whether the other object is a NSNumber of the same value.

Overrides:

equals in class Object

Parameters:

obj - The object to compare to.

Returns:

Whether the objects are equal in terms of numeric value and type.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

toASCII

protected void toASCII(StringBuilder ascii,
                       int level)

Description copied from class: NSObject

Generates the ASCII representation of this object. The generated ASCII representation does not end with a newline. Complies with https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/PropertyLists/OldStylePlists/OldStylePLists.html

Specified by:

toASCII in class NSObject

Parameters:

ascii - The StringBuilder onto which the ASCII representation is appended.

level - The indentation level of the object.

toASCIIGnuStep

protected void toASCIIGnuStep(StringBuilder ascii,
                              int level)

Description copied from class: NSObject

Generates the ASCII representation of this object in the GnuStep format. The generated ASCII representation does not end with a newline.

Specified by:

toASCIIGnuStep in class NSObject

Parameters:

ascii - The StringBuilder onto which the ASCII representation is appended.

level - The indentation level of the object.

compareTo

public int compareTo(Object o)

Specified by:

compareTo in interface Comparable<Object>