Routines (alphabetical) > Object Classes > File Format Object Classes > IDLffDICOM::GetVR

# IDLffDICOM::GetVR

Syntax | Return Value | Arguments | Keywords | Examples | Version History

The IDLffDICOM::GetVR function method takes optional DICOM group and/or element arguments and returns an array of VR (Value Representation) STRINGs for those parameters.

## Syntax

array = Obj->[IDLffDICOM::]GetVR([Group [, Element]] [, REFERENCE=list of references])

## Return Value

Returns an array of strings containing VRs (Value Representations) for the Group and Element parameters. A VR is a DICOM value representation as described in the DICOM specification PS 3.5. If no arguments or keywords are specified, the returned array contains VRs for all elements in the object. The effect of multiple keywords and parameters is to AND their results. If no matching elements can be found, the function returns -1.

## Arguments

### Group

An optional argument representing the value for the DICOM group for which to search, such as ‘0018’x. If this argument is omitted, then all of the DICOM array elements are returned.

### Element

An optional argument specified only if the Group argument has also been specified. Set this to the value for the DICOM element for which to search, such as ‘0010’x. If this argument is omitted and the Group argument was specified, then all elements of the specified Group are returned.

## Keywords

### REFERENCE

Use the specified list of references from which to return VR STRING values.

## Examples

obj = OBJ_NEW('IDLffDICOM')

read = obj->Read(DIALOG_PICKFILE(FILTER='*'))

; Get the VR of the patient name element:

arr = obj->GetVR('0010'x,'0010'x)

PRINT, arr

; Get an array of all of the VRs from the patient info group:

arr = obj->GetVR('0010'x)

PRINT, arr

OBJ_DESTROY,obj

## Version History

5.2 | Introduced