DCMTK  Version 3.6.3
OFFIS DICOM Toolkit
Public Member Functions | Private Attributes | List of all members
DcmVR Class Reference

a class representing a DICOM Value Representation More...

Public Member Functions

 DcmVR ()
 default constructor
 
 DcmVR (DcmEVR evr)
 constructor More...
 
 DcmVR (const char *vrName)
 constructor More...
 
 DcmVR (const DcmVR &avr)
 copy constructor More...
 
void setVR (DcmEVR evr)
 assign new VR value More...
 
void setVR (const char *vrName)
 assign new VR value by name More...
 
void setVR (const DcmVR &avr)
 assign new VR value More...
 
DcmVRoperator= (const DcmVR &arg)
 copy assignment operator More...
 
DcmEVR getEVR () const
 get enumerated VR managed by this object More...
 
DcmEVR getValidEVR () const
 get enumerated standard VR managed by this object. More...
 
const char * getVRName () const
 get symbolic VR name for this object More...
 
const char * getValidVRName () const
 get symbolic standard VR name for this object. More...
 
size_t getValueWidth () const
 compute the size for non-empty values of this VR. More...
 
OFBool isStandard () const
 returns true if VR is a standard DICOM VR More...
 
OFBool isForInternalUseOnly () const
 returns true if VR is for internal use only More...
 
OFBool isaString () const
 returns true if VR represents a string More...
 
OFBool usesExtendedLengthEncoding () const
 returns true if VR uses an extended length encoding for explicit transfer syntaxes More...
 
OFBool isEquivalent (const DcmVR &avr) const
 check if VRs are equivalent. More...
 
Uint32 getMinValueLength () const
 return minimum length of a single value with this VR. More...
 
Uint32 getMaxValueLength () const
 return maximum length of a single value with this VR. More...
 
OFBool isAffectedBySpecificCharacterSet () const
 return whether elements of this VR are affected by SpecificCharacterSet More...
 
const OFStringgetDelimiterChars () const
 retrieve delimiter characters to be used for character set conversion (to switch back to the default character set in case code extension techniques like ISO 2022 are used). More...
 
OFBool isLengthInChar () const
 check whether the maximum or minimum length of a value with this VR is in bytes or characters. More...
 

Private Attributes

DcmEVR vr
 the enumerated VR value
 

Detailed Description

a class representing a DICOM Value Representation

Constructor & Destructor Documentation

◆ DcmVR() [1/3]

DcmVR::DcmVR ( DcmEVR  evr)
inline

constructor

Parameters
evrenumerated VR value

◆ DcmVR() [2/3]

DcmVR::DcmVR ( const char *  vrName)
inline

constructor

Parameters
vrNamesymbolic name of value representation

◆ DcmVR() [3/3]

DcmVR::DcmVR ( const DcmVR avr)
inline

copy constructor

Parameters
avrVR value

Member Function Documentation

◆ getDelimiterChars()

const OFString& DcmVR::getDelimiterChars ( ) const

retrieve delimiter characters to be used for character set conversion (to switch back to the default character set in case code extension techniques like ISO 2022 are used).

Returns
a reference to an OFString containing the delimiter characters for this VR or a reference to an empty OFString.

◆ getEVR()

DcmEVR DcmVR::getEVR ( ) const
inline

get enumerated VR managed by this object

Returns
enumerated VR

◆ getMaxValueLength()

Uint32 DcmVR::getMaxValueLength ( ) const

return maximum length of a single value with this VR.

Whether the returned length is in bytes or characters can be determined by isLengthInChar().

Returns
maximum length of a value

◆ getMinValueLength()

Uint32 DcmVR::getMinValueLength ( ) const

return minimum length of a single value with this VR.

Whether the returned length is in bytes or characters can be determined by isLengthInChar().

Returns
minimum length of a value

◆ getValidEVR()

DcmEVR DcmVR::getValidEVR ( ) const

get enumerated standard VR managed by this object.

If this object manages a non-standard, internal VR such as EVR_ox, this method returns the enumerated VR to which the internal VR will be mapped when writing the DICOM object.

Please note that some VR, e.g. EVR_pixelItem, won't be written as EVR_UNKNOWN, although this method will return that value for them. This means that e.g. usesExtendedLengthEncoding() for the returned VR might not be correct.

Also note that DcmItem::checkAndUpdateVR() will in some cases influence the VR which is written out.

Returns
enumerated VR

◆ getValidVRName()

const char* DcmVR::getValidVRName ( ) const

get symbolic standard VR name for this object.

If this object manages a non-standard, internal VR such as EVR_ox, this method returns the name of the VR to which the internal VR will be mapped when writing the DICOM object.

Returns
VR name string, never NULL

◆ getValueWidth()

size_t DcmVR::getValueWidth ( ) const

compute the size for non-empty values of this VR.

For fixed size VRs such as OW, US, SL, the method returns the size of each value, in bytes. For variable length VRs (strings), it returns 1. For internal VRs it returns 0.

Returns
size of values of this VR

◆ getVRName()

const char* DcmVR::getVRName ( ) const

get symbolic VR name for this object

Returns
VR name string, never NULL

◆ isAffectedBySpecificCharacterSet()

OFBool DcmVR::isAffectedBySpecificCharacterSet ( ) const

return whether elements of this VR are affected by SpecificCharacterSet

Returns
true for the following VRs: PN, LO, LT, SH, ST, UC and UT, false for all others.

◆ isaString()

OFBool DcmVR::isaString ( ) const

returns true if VR represents a string

Returns
true if VR represents a string, false otherwise

◆ isEquivalent()

OFBool DcmVR::isEquivalent ( const DcmVR avr) const

check if VRs are equivalent.

VRs are considered equivalent if equal or if one of them is an internal VR and the other one is a possible standard VR to which the internal one maps.

Parameters
avrVR to compare with
Returns
true if VRs are equivalent, false otherwise

◆ isForInternalUseOnly()

OFBool DcmVR::isForInternalUseOnly ( ) const

returns true if VR is for internal use only

Returns
true if VR is for internal use only, false otherwise

◆ isLengthInChar()

OFBool DcmVR::isLengthInChar ( ) const

check whether the maximum or minimum length of a value with this VR is in bytes or characters.

See getMinValueLength() and getMaxValueLength().

Returns
true if length is stated in characters, false if in bytes

◆ isStandard()

OFBool DcmVR::isStandard ( ) const

returns true if VR is a standard DICOM VR

Returns
true if VR is a standard DICOM VR, false otherwise

◆ operator=()

DcmVR& DcmVR::operator= ( const DcmVR arg)
inline

copy assignment operator

Parameters
argvr to assign from
Returns
reference to this object

References vr.

◆ setVR() [1/3]

void DcmVR::setVR ( DcmEVR  evr)

assign new VR value

Parameters
evrenumerated VR value

◆ setVR() [2/3]

void DcmVR::setVR ( const char *  vrName)

assign new VR value by name

Parameters
vrNamesymbolic name of value representation

◆ setVR() [3/3]

void DcmVR::setVR ( const DcmVR avr)
inline

assign new VR value

Parameters
avrVR value

References vr.

◆ usesExtendedLengthEncoding()

OFBool DcmVR::usesExtendedLengthEncoding ( ) const

returns true if VR uses an extended length encoding for explicit transfer syntaxes

Returns
true if VR uses an extended length encoding for explicit transfer syntaxes, false otherwise

The documentation for this class was generated from the following file:


Generated on Mon Feb 5 2018 for DCMTK Version 3.6.3 by Doxygen 1.8.14