DCMTK  Version 3.6.1 20120515
OFFIS DICOM Toolkit
Public Member Functions
DcmFloatingPointDouble Class Reference

a class representing the DICOM value representation 'Floating Point Double' (FD) More...

+ Inheritance diagram for DcmFloatingPointDouble:

List of all members.

Public Member Functions

 DcmFloatingPointDouble (const DcmTag &tag, const Uint32 len=0)
 constructor.
 DcmFloatingPointDouble (const DcmFloatingPointDouble &old)
 copy constructor
virtual ~DcmFloatingPointDouble ()
 destructor
DcmFloatingPointDoubleoperator= (const DcmFloatingPointDouble &obj)
 assignment operator
virtual DcmObjectclone () const
 clone method
virtual OFCondition copyFrom (const DcmObject &rhs)
 Virtual object copying.
virtual DcmEVR ident () const
 get element type identifier
virtual OFCondition checkValue (const OFString &vm="1-n", const OFBool oldFormat=OFFalse)
 check whether stored value conforms to the VR and to the specified VM
virtual unsigned long getVM ()
 get value multiplicity
virtual void print (STD_NAMESPACE ostream &out, const size_t flags=0, const int level=0, const char *pixelFileName=NULL, size_t *pixelCounter=NULL)
 print element to a stream.
virtual OFCondition getFloat64 (Float64 &doubleVal, const unsigned long pos=0)
 get particular double value
virtual OFCondition getFloat64Array (Float64 *&doubleVals)
 get reference to stored double data
virtual OFCondition getOFString (OFString &stringVal, const unsigned long pos, OFBool normalize=OFTrue)
 get a particular value as a character string.
virtual OFCondition putFloat64 (const Float64 doubleval, const unsigned long pos=0)
 set particular element value to given double
virtual OFCondition putFloat64Array (const Float64 *doubleVals, const unsigned long numDoubles)
 set element value to given double array data
virtual OFCondition putString (const char *stringVal)
 set element value from the given character string.
virtual OFCondition putString (const char *stringVal, const Uint32 stringLen)
 set element value from the given character string.
virtual OFCondition verify (const OFBool autocorrect=OFFalse)
 check the currently stored element value

Detailed Description

a class representing the DICOM value representation 'Floating Point Double' (FD)


Constructor & Destructor Documentation

DcmFloatingPointDouble::DcmFloatingPointDouble ( const DcmTag tag,
const Uint32  len = 0 
)

constructor.

Create new element from given tag and length.

Parameters:
tagDICOM tag for the new element
lenvalue length for the new element

copy constructor

Parameters:
oldelement to be copied

Member Function Documentation

virtual OFCondition DcmFloatingPointDouble::checkValue ( const OFString vm = "1-n",
const OFBool  oldFormat = OFFalse 
) [virtual]

check whether stored value conforms to the VR and to the specified VM

Parameters:
vmvalue multiplicity (according to the data dictionary) to be checked for. (See DcmElement::checkVM() for a list of valid values.)
oldFormatparameter not used for this VR (only for DA, TM, PN)
Returns:
status of the check, EC_Normal if value is correct, an error code otherwise

Reimplemented from DcmElement.

virtual DcmObject* DcmFloatingPointDouble::clone ( ) const [inline, virtual]

clone method

Returns:
deep copy of this object

Implements DcmObject.

virtual OFCondition DcmFloatingPointDouble::copyFrom ( const DcmObject rhs) [virtual]

Virtual object copying.

This method can be used for DcmObject and derived classes to get a deep copy of an object. Internally the assignment operator is called if the given DcmObject parameter is of the same type as "this" object instance. If not, an error is returned. This function permits copying an object by value in a virtual way which therefore is different to just calling the assignment operator of DcmElement which could result in slicing the object.

Parameters:
rhs- [in] The instance to copy from. Has to be of the same class type as "this" object
Returns:
EC_Normal if copying was successful, error otherwise

Reimplemented from DcmElement.

virtual OFCondition DcmFloatingPointDouble::getFloat64 ( Float64 &  doubleVal,
const unsigned long  pos = 0 
) [virtual]

get particular double value

Parameters:
doubleValreference to result variable (cleared in case of error)
posindex of the value to be retrieved (0..vm-1)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DcmElement.

virtual OFCondition DcmFloatingPointDouble::getFloat64Array ( Float64 *&  doubleVals) [virtual]

get reference to stored double data

Parameters:
doubleValsreference to result variable
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DcmElement.

virtual OFCondition DcmFloatingPointDouble::getOFString ( OFString stringVal,
const unsigned long  pos,
OFBool  normalize = OFTrue 
) [virtual]

get a particular value as a character string.

The resulting string contains a variable number of digits as created by the OFStandard::ftoa() function by default.

Parameters:
stringValvariable in which the result value is stored
posindex of the value in case of multi-valued elements (0..vm-1)
normalizenot used
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DcmElement.

virtual unsigned long DcmFloatingPointDouble::getVM ( ) [virtual]

get value multiplicity

Returns:
number of currently stored values

Implements DcmObject.

virtual DcmEVR DcmFloatingPointDouble::ident ( ) const [virtual]

get element type identifier

Returns:
type identifier of this class (EVR_FD)

Implements DcmObject.

DcmFloatingPointDouble& DcmFloatingPointDouble::operator= ( const DcmFloatingPointDouble obj)

assignment operator

Parameters:
objelement to be assigned/copied
Returns:
reference to this object
virtual void DcmFloatingPointDouble::print ( STD_NAMESPACE ostream &  out,
const size_t  flags = 0,
const int  level = 0,
const char *  pixelFileName = NULL,
size_t *  pixelCounter = NULL 
) [virtual]

print element to a stream.

The output format of the value is a backslash separated sequence of numbers. This function uses a variable number of digits for the floating point values as created by the OFStandard::ftoa() function by default.

Parameters:
outoutput stream
flagsoptional flag used to customize the output (see DCMTypes::PF_xxx)
levelcurrent level of nested items. Used for indentation.
pixelFileNamenot used
pixelCounternot used

Implements DcmObject.

virtual OFCondition DcmFloatingPointDouble::putFloat64 ( const Float64  doubleval,
const unsigned long  pos = 0 
) [virtual]

set particular element value to given double

Parameters:
doublevaldouble precision floating point value to be set
posindex of the value to be set (0 = first position)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DcmElement.

virtual OFCondition DcmFloatingPointDouble::putFloat64Array ( const Float64 *  doubleVals,
const unsigned long  numDoubles 
) [virtual]

set element value to given double array data

Parameters:
doubleValsdouble precision floating point data to be set
numDoublesnumber of double values to be set
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DcmElement.

virtual OFCondition DcmFloatingPointDouble::putString ( const char *  stringVal) [virtual]

set element value from the given character string.

The input string is expected to be a backslash separated sequence of numeric characters, e.g. "12.3456\1\-123.456\1234.0".

Parameters:
stringValinput character string
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DcmElement.

virtual OFCondition DcmFloatingPointDouble::putString ( const char *  stringVal,
const Uint32  stringLen 
) [virtual]

set element value from the given character string.

The input string is expected to be a backslash separated sequence of numeric characters, e.g. "12.3456\1\-123.456\1234.0". The length of the string has to be specified explicitly. The string can, therefore, also contain more than one NULL byte.

Parameters:
stringValinput character string
stringLenlength of the string (number of characters without the trailing NULL byte)
Returns:
status, EC_Normal if successful, an error code otherwise

Reimplemented from DcmElement.

virtual OFCondition DcmFloatingPointDouble::verify ( const OFBool  autocorrect = OFFalse) [virtual]

check the currently stored element value

Parameters:
autocorrectcorrect value length if OFTrue
Returns:
status, EC_Normal if value length is correct, an error code otherwise

Implements DcmObject.


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


Generated on Tue May 15 2012 for DCMTK Version 3.6.1 20120515 by Doxygen 1.7.5.1-20111027