message.getDICOMUnsignedShortsAsArray¶
Use when: You want to read values from the modified message during mapping. If you need the original incoming message, use source.getDICOMUnsignedShortsAsArray.
Signature: message.getDICOMUnsignedShortsAsArray(nodePath, instance*)
Returns: Number[] result - the first node as a JS Array of JS Numbers that matches the nodePath and instance
Get the result as an array of unsigned shorts of the first node that matches the nodePath.
Note
When the optional instance value is specified, the nodePath should not include an instance identifier.
Parameters¶
| Type | Name | Description | Default |
|---|---|---|---|
| String | nodePath | the DICOM node path | |
| Integer | instance* | (optional) the match instance to return. Use 1 for the first instance. | 1 |
Example¶
// assumes `message` is a DICOM message model object
// Retrieve an array of unsigned shorts for the specified DICOM tag
var unsignedShortsArray = message.getDICOMUnsignedShortsAsArray(
"0010,0010" // Example node path
);
// Optionally retrieve a specific instance
var unsignedShortsArrayInstance = message.getDICOMUnsignedShortsAsArray(
"0010,0010", // node path
2 // instance (1 = first instance)
);
// Result:
// - unsignedShortsArray contains a JS Array of unsigned short values
// - unsignedShortsArrayInstance contains values for the specified instance