public class AttributeTagAttribute extends Attribute
A concrete class specializing Attribute
for
Attribute Tag (AT) attributes.
Though an instance of this class may be created
using its constructors, there is also a factory class, AttributeFactory
.
Attribute
,
AttributeFactory
,
AttributeList
valueLength, valueMultiplicity
Constructor and Description |
---|
AttributeTagAttribute(AttributeTag t)
Construct an (empty) attribute.
|
AttributeTagAttribute(AttributeTag t,
long vl,
DicomInputStream i)
Read an attribute from an input stream.
|
AttributeTagAttribute(AttributeTag t,
java.lang.Long vl,
DicomInputStream i)
Read an attribute from an input stream.
|
Modifier and Type | Method and Description |
---|---|
void |
addValue(AttributeTag t) |
void |
addValue(int g,
int e) |
void |
addValue(java.lang.String s)
Add a(nother)
String value after any existing values of this attribute. |
AttributeTag[] |
getAttributeTagValues() |
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 (AT).
|
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, getByteValues, getByteValues, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrDefault, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrEmptyString, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDelimitedStringValuesOrNull, getDoubleValues, getDoubleValues, getDoubleValues, getElement, getFloatValues, 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, setValues, setValues, toString, writeBase
public AttributeTagAttribute(AttributeTag t)
Construct an (empty) attribute.
t
- the tag of the attributepublic AttributeTagAttribute(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
- if an I/O error occursDicomException
- if error in DICOM encodingpublic AttributeTagAttribute(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
- if an I/O error occursDicomException
- if error in DICOM encodingpublic void addValue(AttributeTag t) throws DicomException
t
- the tagDicomException
- never thrownpublic void addValue(int g, int e) throws DicomException
g
- group numbere
- element numberDicomException
- never thrownpublic void addValue(java.lang.String s) throws DicomException
Attribute
String
value after any existing values of this attribute.addValue
in class Attribute
s
- a String of the form returned by toString()
, i.e., "(0xgggg,0xeeee)" where gggg and eeee are the zero-padded hexadecimal representations of the group and element respectivelyDicomException
- if String is not a valid representation of a tagpublic AttributeTag[] getAttributeTagValues() throws DicomException
DicomException
- thrown if values are not availablepublic java.lang.String[] getStringValues(java.text.NumberFormat format) throws DicomException
Attribute
Get the values of this attribute as strings.
The strings may have been cleaned up into a canonical form, such as to remove padding as well as numbers formatted.
getStringValues
in class Attribute
format
- the format to use for each numerical or decimal valueString
DicomException
- thrown if values are not available (such as not supported for this concrete attribute class)public byte[] getVR()
Get the value representation of this attribute (AT).
getVR
in class Attribute
ValueRepresentation
public void removeValues()
Attribute
Remove any existing values, making the attribute empty (zero length).
removeValues
in class Attribute
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
- the output streamDicomException
- if error in DICOM encodingjava.io.IOException
- if an I/O error occurs