net.sf.plist

Class NSData

java.lang.Object

net.sf.plist.NSObject

net.sf.plist.NSData

public final class NSData
extends NSObject

Represents a binary blob.

In this implementation, a primitive byte array or a ByteArrayInputStream is used to represent the NSData.

See Also:

ByteArrayInputStream

Constructor Summary

Constructors

Constructor and Description
NSData(byte[] theData) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
java.io.ByteArrayInputStream	getValue() Get the unmodifiable value of this object.
boolean	isTrue() Return whether or not the value evaluates to true.
byte[]	toBytes() Return the contents of this object as primitive array. Because the array is copied to keep this object immutable, it's recommended to use toStream() instead.
double	toDouble() Return the value as a double.
long	toLong() Get the length of the content in bytes.
java.io.ByteArrayInputStream	toStream() Get a ByteArrayInputStream which can be used to read the contents of this object.
java.lang.String	toString() Returns an unformatted hexadecimal representation of the content.

Methods inherited from class net.sf.plist.NSObject

equals, hashCode, toBoolean, toDate, toInteger, toList, toMap, toNumber

Methods inherited from class java.lang.Object

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

Constructor Detail

NSData

public NSData(byte[] theData)

Constructor.

Parameters:

theData - value of the new object

Method Detail

getValue

public java.io.ByteArrayInputStream getValue()

Get the unmodifiable value of this object.

Specified by:

getValue in class NSObject

Returns:

the unmodifiable value of this object

See Also:

toStream()

toStream

public java.io.ByteArrayInputStream toStream()

Get a ByteArrayInputStream which can be used to read the contents of this object. This is the most cost-efficient way to retrieve the value contained in an NSData object.

Overrides:

toStream in class NSObject

Returns:

the ByteArrayInputStream

toBytes

public byte[] toBytes()

Return the contents of this object as primitive array.
Because the array is copied to keep this object immutable, it's recommended to use toStream() instead.

Overrides:

toBytes in class NSObject

Returns:

the array

isTrue

public boolean isTrue()

Return whether or not the value evaluates to true.

A value returns to true if and only if

• it is the NSBoolean type NSBoolean.TRUE
• It is an NSString which has a length greater than zero and does not equal "NO" or "False" (case insensitive)
• It is an NSNumber greater than 0
• It is an NSCollection which contains more than zero elements
• It is an NSDate
• It is an NSData with a length greater than 0

Specified by:

isTrue in class NSObject

Returns:

the value evaluates to true

toString

public java.lang.String toString()

Returns an unformatted hexadecimal representation of the content.

Overrides:

toString in class NSObject

Returns:

the hexadecimal string

See Also:

Object.toString()

toLong

public long toLong()

Get the length of the content in bytes.

Specified by:

toLong in class NSObject

Returns:

the length

toDouble

public double toDouble()

Return the value as a double. If this is not a NSReal the double value is derived from the actual value.

Specified by:

toDouble in class NSObject

Returns:

the double