source.getDICOMUnsignedShorts¶
Use when: You want to read values from the original incoming message before any mapping changes. If you need the modified message during mapping, use message.getDICOMUnsignedShorts.
Signature: source.getDICOMUnsignedShorts(nodePath, instance*)
Returns: String result - the first node that matches the nodePath and instance
Get the result as a \\ delimited string 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¶
// Example: Retrieve unsigned short values from a DICOM node.
// Get a backslash-delimited string of unsigned shorts from the first matching node
var unsignedShorts = source.getDICOMUnsignedShorts(
"0010,0010" // DICOM tag
); // e.g. "1\\0\\255\\1024"
// Get unsigned shorts from a specific instance (useful for sequences)
var unsignedShortsInstance = source.getDICOMUnsignedShorts(
"0010,0010", // DICOM tag
2 // instance
);