public class UnknownAttribute extends Attribute
A concrete class specializing Attribute
for
Unknown (UN) attributes.
Though an instance of this class may be created
using its constructors, there is also a factory class, AttributeFactory
.
Attribute
,
AttributeFactory
,
AttributeList
Modifier and Type | Field and Description |
---|---|
protected byte[] |
originalLittleEndianByteValues |
valueLength, valueMultiplicity
Constructor and Description |
---|
UnknownAttribute(AttributeTag t)
Construct an (empty) attribute.
|
UnknownAttribute(AttributeTag t,
long vl,
DicomInputStream i)
Read an attribute from an input stream.
|
UnknownAttribute(AttributeTag t,
java.lang.Long vl,
DicomInputStream i)
Read an attribute from an input stream.
|
Modifier and Type | Method and Description |
---|---|
byte[] |
getByteValues()
Get the values of this attribute as a byte array.
|
byte[] |
getByteValues(boolean big)
Get the values of this attribute as a byte array, accounting for byte ordering of values that are larger than one byte.
|
double[] |
getDoubleValues()
Get the values of this attribute as doubles.
|
float[] |
getFloatValues()
Get the values of this attribute as floats.
|
java.lang.String[] |
getStringValues(java.text.NumberFormat format)
Get the values of this attribute as strings.
|
byte[] |
getVR()
Get the value representation of this attribute (UN).
|
void |
removeValues()
Remove any existing values, making the attribute empty (zero length).
|
void |
setValues(byte[] v)
Replace any existing values with the supplied array of byte.
|
void |
setValues(byte[] v,
boolean big)
Replace any existing values with the supplied array of byte, accounting for byte ordering of values that are larger than one byte.
|
java.lang.String |
toString(DicomDictionary dictionary)
Dump the contents of the attribute as a human-readable string.
|
void |
write(DicomOutputStream o)
Write the entire attribute (including values) to the output stream.
|
addValue, addValue, addValue, addValue, addValue, addValue, addValue, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDoubleValues, getDoubleValues, getElement, getFloatValues, getFloatValues, getGroup, getIntegerValues, getIntegerValues, getIntegerValues, getLengthOfEncodedValue, getLongValues, getLongValues, getLongValues, getOriginalStringValues, getPaddedVL, getShortValues, getSingleDoubleValueOrDefault, getSingleDoubleValueOrDefault, getSingleDoubleValueOrDefault, getSingleFloatValueOrDefault, getSingleFloatValueOrDefault, getSingleFloatValueOrDefault, getSingleIntegerValueOrDefault, getSingleIntegerValueOrDefault, getSingleIntegerValueOrDefault, getSingleLongValueOrDefault, getSingleLongValueOrDefault, getSingleLongValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrDefault, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrEmptyString, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getSingleStringValueOrNull, getStringValues, getStringValues, getStringValues, getStringValues, getStringValues, getTag, getVL, getVM, getVRAsString, isValid, repairValues, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValues, setValues, setValues, setValues, setValues, toString, writeBase
public UnknownAttribute(AttributeTag t)
Construct an (empty) attribute.
t
- the tag of the attributepublic UnknownAttribute(AttributeTag t, long vl, DicomInputStream i) throws java.io.IOException, DicomException
Read an attribute from an input stream.
t
- the tag of the attributevl
- the value length of the attributei
- the input streamjava.io.IOException
DicomException
public UnknownAttribute(AttributeTag t, java.lang.Long vl, DicomInputStream i) throws java.io.IOException, DicomException
Read an attribute from an input stream.
t
- the tag of the attributevl
- the value length of the attributei
- the input streamjava.io.IOException
DicomException
public byte[] getByteValues()
Get the values of this attribute as a byte array.
Always to be interpreted as little endian, per the DICOM definition of UN, regardless of the received transfer syntax.
getByteValues
in class Attribute
public byte[] getByteValues(boolean big) throws DicomException
Attribute
Get the values of this attribute as a byte array, accounting for byte ordering of values that are larger than one byte.
getByteValues
in class Attribute
big
- whether or not to intepret the values larger than bytes as big endian or notDicomException
public double[] getDoubleValues() throws DicomException
Get the values of this attribute as doubles.
Assumes the caller knows that the UN VR is really a valid FD (e.g., knows the VR of a private attribute).
getDoubleValues
in class Attribute
DicomException
public float[] getFloatValues() throws DicomException
Get the values of this attribute as floats.
Assumes the caller knows that the UN VR is really a valid FL (e.g., knows the VR of a private attribute).
getFloatValues
in class Attribute
DicomException
public java.lang.String[] getStringValues(java.text.NumberFormat format) throws DicomException
Get the values of this attribute as strings.
Assumes the caller knows that the UN VR is really a valid string (e.g., knows the VR of a private attribute).
Assumes ASCII encoding (i.e., does not consider SpecificCharacterSet).
The strings are first cleaned up into a canonical form, to remove leading and trailing padding.
getStringValues
in class Attribute
format
- the format to use for each numerical or decimal value - ignoredString
DicomException
- not thrownpublic byte[] getVR()
Get the value representation of this attribute (UN).
getVR
in class Attribute
ValueRepresentation
public void removeValues()
Attribute
Remove any existing values, making the attribute empty (zero length).
removeValues
in class Attribute
public void setValues(byte[] v) throws DicomException
Attribute
setValues
in class Attribute
v
- DicomException
public void setValues(byte[] v, boolean big) throws DicomException
Attribute
setValues
in class Attribute
v
- big
- DicomException
public java.lang.String toString(DicomDictionary dictionary)
Attribute
Dump the contents of the attribute as a human-readable string.
No new line is appended.
The result is of the form:
(0xgggg,0xeeee) Name VR=<XX> VL=<0xnnnn> <...>
For example:
(0x0018,0x0020) ScanningSequence VR=<CS> VL=<0x2> <GR>
public void write(DicomOutputStream o) throws DicomException, java.io.IOException
Attribute
Write the entire attribute (including values) to the output stream.
write
in class Attribute
o
- java.io.IOException
DicomException