Class UnknownAttribute
- Direct Known Subclasses:
TestPrivateCreatorValueRepresentation.OurUnknownAttribute
,TestUnknownSequenceValueRepresentation.OurUnknownAttribute
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
.
- See Also:
-
Field Summary
FieldsFields inherited from class com.pixelmed.dicom.Attribute
valueLength, valueMultiplicity
-
Constructor Summary
ConstructorsConstructorDescriptionConstruct an (empty) attribute.UnknownAttribute
(AttributeTag t, long vl, DicomInputStream i) Read an attribute from an input stream.UnknownAttribute
(AttributeTag t, Long vl, DicomInputStream i) Read an attribute from an input stream. -
Method Summary
Modifier and TypeMethodDescriptionbyte[]
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[]
Get the values of this attribute as doubles.float[]
Get the values of this attribute as floats.String[]
getStringValues
(NumberFormat format) Get the values of this attribute as strings.byte[]
getVR()
Get the value representation of this attribute (UN).void
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.toString
(DicomDictionary dictionary) Dump the contents of the attribute as a human-readable string.void
Write the entire attribute (including values) to the output stream.Methods inherited from class com.pixelmed.dicom.Attribute
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, getLengthOfBaseOfEncodedAttribute, getLengthOfEncodedValue, getLengthOfEntireEncodedAttribute, 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
-
Field Details
-
originalLittleEndianByteValues
protected byte[] originalLittleEndianByteValues
-
-
Constructor Details
-
UnknownAttribute
Construct an (empty) attribute.
- Parameters:
t
- the tag of the attribute
-
UnknownAttribute
public UnknownAttribute(AttributeTag t, long vl, DicomInputStream i) throws IOException, DicomException Read an attribute from an input stream.
- Parameters:
t
- the tag of the attributevl
- the value length of the attributei
- the input stream- Throws:
IOException
DicomException
-
UnknownAttribute
public UnknownAttribute(AttributeTag t, Long vl, DicomInputStream i) throws IOException, DicomException Read an attribute from an input stream.
- Parameters:
t
- the tag of the attributevl
- the value length of the attributei
- the input stream- Throws:
IOException
DicomException
-
-
Method Details
-
write
Description copied from class:Attribute
Write the entire attribute (including values) to the output stream.
- Specified by:
write
in classAttribute
- Parameters:
o
-- Throws:
IOException
DicomException
-
toString
Description copied from class: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>
-
removeValues
public void removeValues()Description copied from class:Attribute
Remove any existing values, making the attribute empty (zero length).
- Specified by:
removeValues
in classAttribute
-
getVR
public byte[] getVR()Get the value representation of this attribute (UN).
- Overrides:
getVR
in classAttribute
- Returns:
- 'U','U' in ASCII as a two byte array; see
ValueRepresentation
-
setValues
Description copied from class:Attribute
Replace any existing values with the supplied array of byte.- Overrides:
setValues
in classAttribute
- Parameters:
v
-- Throws:
DicomException
-
setValues
Description copied from class:Attribute
Replace any existing values with the supplied array of byte, accounting for byte ordering of values that are larger than one byte.- Overrides:
setValues
in classAttribute
- Parameters:
v
-big
-- Throws:
DicomException
-
getByteValues
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.
- Overrides:
getByteValues
in classAttribute
- Returns:
- the values as an array of bytes
-
getByteValues
Description copied from class:Attribute
Get the values of this attribute as a byte array, accounting for byte ordering of values that are larger than one byte.
- Overrides:
getByteValues
in classAttribute
- Parameters:
big
- whether or not to intepret the values larger than bytes as big endian or not- Returns:
- the values as an array of bytes
- Throws:
DicomException
-
getStringValues
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.
- Overrides:
getStringValues
in classAttribute
- Parameters:
format
- the format to use for each numerical or decimal value - ignored- Returns:
- the values as an array of
String
- Throws:
DicomException
- not thrown
-
getDoubleValues
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).
- Overrides:
getDoubleValues
in classAttribute
- Returns:
- the values as an array of double
- Throws:
DicomException
-
getFloatValues
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).
- Overrides:
getFloatValues
in classAttribute
- Returns:
- the values as an array of float
- Throws:
DicomException
-