[This is preliminary documentation and is subject to change.]
When the tag sequence is single attribute specifying, this method does the following:
- When the attribute already exists and also has VR SQ, the values or sequence items
are appended to the already existing values or sequence items.
- When the attribute already exists but has a different VR, an error is displayed and
nothing is appended.
- When the attribute does not already exists, it is created and the values or sequence
items are added.
When the tag sequence contains wildcards, the rules above are applied to each existing attribute
specified by the tag sequence.
Whenever the VR specified is SQ and the parameters supplied contain non sequence
item(s), and exception is thrown.
Whenever the VR specified is unequal SQ and the parameters contain sequence item(s),
and exception is thrown.
- tagSequence (String)
- The tag sequence.
- vR (VR)
- The VR.
- parameters (array< Object >[]()[])
- The parameters to append.