Class UnknownAttribute
- java.lang.Object
-
- com.pixelmed.dicom.Attribute
-
- com.pixelmed.dicom.UnknownAttribute
-
- Direct Known Subclasses:
TestPrivateCreatorValueRepresentation.OurUnknownAttribute,TestUnknownSequenceValueRepresentation.OurUnknownAttribute
public class UnknownAttribute extends Attribute
A concrete class specializing
Attributefor Unknown (UN) attributes.Though an instance of this class may be created using its constructors, there is also a factory class,
AttributeFactory.- See Also:
Attribute,AttributeFactory,AttributeList
-
-
Field Summary
Fields Modifier and Type Field Description protected byte[]originalLittleEndianByteValues-
Fields inherited from class com.pixelmed.dicom.Attribute
valueLength, valueMultiplicity
-
-
Constructor Summary
Constructors Constructor 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.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method 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).voidremoveValues()Remove any existing values, making the attribute empty (zero length).java.lang.StringtoString(DicomDictionary dictionary)Dump the contents of the attribute as a human-readable string.voidwrite(DicomOutputStream o)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, 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
-
-
-
-
Constructor Detail
-
UnknownAttribute
public UnknownAttribute(AttributeTag t)
Construct an (empty) attribute.
- Parameters:
t- the tag of the attribute
-
UnknownAttribute
public UnknownAttribute(AttributeTag t, long vl, DicomInputStream i) throws java.io.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:
java.io.IOExceptionDicomException
-
UnknownAttribute
public UnknownAttribute(AttributeTag t, java.lang.Long vl, DicomInputStream i) throws java.io.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:
java.io.IOExceptionDicomException
-
-
Method Detail
-
write
public void write(DicomOutputStream o) throws DicomException, java.io.IOException
Description copied from class:AttributeWrite the entire attribute (including values) to the output stream.
- Specified by:
writein classAttribute- Parameters:
o-- Throws:
java.io.IOExceptionDicomException
-
toString
public java.lang.String toString(DicomDictionary dictionary)
Description copied from class:AttributeDump 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:AttributeRemove any existing values, making the attribute empty (zero length).
- Specified by:
removeValuesin classAttribute
-
getVR
public byte[] getVR()
Get the value representation of this attribute (UN).
- Overrides:
getVRin classAttribute- Returns:
- 'U','U' in ASCII as a two byte array; see
ValueRepresentation
-
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:
getByteValuesin classAttribute- Returns:
- the values as an array of bytes
-
getStringValues
public java.lang.String[] getStringValues(java.text.NumberFormat format) throws DicomExceptionGet 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:
getStringValuesin 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
public double[] getDoubleValues() throws DicomExceptionGet 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:
getDoubleValuesin classAttribute- Returns:
- the values as an array of double
- Throws:
DicomException
-
getFloatValues
public float[] getFloatValues() throws DicomExceptionGet 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:
getFloatValuesin classAttribute- Returns:
- the values as an array of float
- Throws:
DicomException
-
-