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.
|
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).
|
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, 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, 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 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
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 removeValues()
Attribute
Remove any existing values, making the attribute empty (zero length).
removeValues
in class Attribute
public byte[] getVR()
Get the value representation of this attribute (UN).
getVR
in class Attribute
ValueRepresentation
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 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 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