Class to represent a DICOM Data Element (Attribute) Tag (Group, Element). Basically an uint32_t which can also be expressed as two uint16_t (group and element) More...

#include <gdcmTag.h>

Inheritance diagram for gdcm::Tag:

[legend]

Public Member Functions
	Tag (uint16_t group, uint16_t element)
	Constructor with 2*uint16_t. More...

	Tag (uint32_t tag=0)
	Constructor with 1*uint32_t Prefer the cstor that takes two uint16_t. More...

	Tag (const Tag &_val)

uint16_t	GetElement () const
	Returns the 'Element number' of the given Tag. More...

uint32_t	GetElementTag () const
	Returns the full tag value of the given Tag. More...

uint16_t	GetGroup () const
	Returns the 'Group number' of the given Tag. More...

uint32_t	GetLength () const
	return the length of tag (read: size on disk) More...

Tag	GetPrivateCreator () const
	Return the Private Creator Data Element tag of a private data element. More...

bool	IsGroupLength () const
	return whether the tag correspond to a group length tag: More...

bool	IsGroupXX (const Tag &t) const
	e.g 6002,3000 belong to groupXX: 6000,3000 More...

bool	IsIllegal () const
	return if the tag is considered to be an illegal tag More...

bool	IsPrivate () const

bool	IsPrivateCreator () const

bool	IsPublic () const

bool	operator!= (const Tag &_val) const

bool	operator< (const Tag &_val) const

bool	operator<= (const Tag &t2) const

Tag &	operator= (const Tag &_val)

bool	operator== (const Tag &_val) const

const uint16_t &	operator[] (const unsigned int &_id) const
	Returns the Group or Element of the given Tag, depending on id (0/1) More...

uint16_t &	operator[] (const unsigned int &_id)
	Returns the Group or Element of the given Tag, depending on id (0/1) More...

std::string	PrintAsPipeSeparatedString () const

template<typename TSwap >
std::istream &	Read (std::istream &is)
	Read a tag from binary representation. More...

bool	ReadFromCommaSeparatedString (const char *str)

bool	ReadFromPipeSeparatedString (const char *str)

void	SetElement (uint16_t element)
	Sets the 'Element number' of the given Tag. More...

void	SetElementTag (uint16_t group, uint16_t element)
	Sets the 'Group number' & 'Element number' of the given Tag. More...

void	SetElementTag (uint32_t tag)
	Sets the full tag value of the given Tag. More...

void	SetGroup (uint16_t group)
	Sets the 'Group number' of the given Tag. More...

void	SetPrivateCreator (Tag const &t)
	Set private creator: More...

template<typename TSwap >
const std::ostream &	Write (std::ostream &os) const
	Write a tag in binary rep. More...

Friends
std::ostream &	operator<< (std::ostream &_os, const Tag &_val)

std::istream &	operator>> (std::istream &_is, Tag &_val)

Detailed Description

Class to represent a DICOM Data Element (Attribute) Tag (Group, Element). Basically an uint32_t which can also be expressed as two uint16_t (group and element)

Note: DATA ELEMENT TAG: A unique identifier for a Data Element composed of an ordered pair of numbers (a Group Number followed by an Element Number). GROUP NUMBER: The first number in the ordered pair of numbers that makes up a Data Element Tag. ELEMENT NUMBER: The second number in the ordered pair of numbers that makes up a Data Element Tag.

Examples:: ChangeSequenceUltrasound.cxx, ClinicalTrialAnnotate.cxx, ClinicalTrialIdentificationWorkflow.cs, CreateARGBImage.cxx, CreateCMYKImage.cxx, CreateJPIPDataSet.cxx, DumpToSQLITE3.cxx, DuplicatePCDE.cxx, EncapsulateFileInRawData.cxx, ExtractEncryptedContent.cxx, Extracting_All_Resolution.cxx, Fake_Image_Using_Stream_Image_Writer.cxx, FixBrokenJ2K.cxx, FixJAIBugJPEGLS.cxx, gdcmrtionplan.cxx, gdcmrtplan.cxx, GenAllVR.cxx, GenFakeIdentifyFile.cxx, GenFakeImage.cxx, GenLongSeqs.cxx, GenSeqs.cxx, GetJPEGSamplePrecision.cxx, GetSequenceUltrasound.cxx, GetSubSequenceData.cxx, iU22tomultisc.cxx, LargeVRDSExplicit.cxx, MergeTwoFiles.cxx, NewSequence.cs, PatchFile.cxx, pmsct_rgb1.cxx, PublicDict.cxx, ReadAndDumpDICOMDIR.cxx, ReadAndPrintAttributes.cxx, ReadExplicitLengthSQIVR.cxx, ReformatFile.cs, rle2img.cxx, SimplePrintPatientName.cs, SimpleScanner.cxx, SortImage.cxx, StandardizeFiles.cs, StreamImageReaderTest.cxx, TraverseModules.cxx, and VolumeSorter.cxx.

Constructor & Destructor Documentation

gdcm::Tag::Tag	(	uint16_t	group,
		uint16_t	element
	)

inline

Constructor with 2*uint16_t.

gdcm::Tag::Tag ( uint32_t tag = 0 )

inline

Constructor with 1*uint32_t Prefer the cstor that takes two uint16_t.

gdcm::Tag::Tag ( const Tag & _val )

inline

References tag.

Member Function Documentation

uint16_t gdcm::Tag::GetElement ( ) const

inline

Returns the 'Element number' of the given Tag.

Examples:: DuplicatePCDE.cxx, and PublicDict.cxx.

Referenced by gdcm::DataSet::ComputeGroupLength(), IsGroupXX(), gdcm::PrivateDict::PrintXML(), gdcm::SequenceOfFragments::ReadValue(), and SetPrivateCreator().

uint32_t gdcm::Tag::GetElementTag ( ) const

inline

Returns the full tag value of the given Tag.

uint16_t gdcm::Tag::GetGroup ( ) const

inline

Returns the 'Group number' of the given Tag.

Examples:: DuplicatePCDE.cxx, and GenAllVR.cxx.

Referenced by gdcm::DataSet::ComputeGroupLength(), gdcm::CommandDataSet::Insert(), gdcm::FileMetaInformation::Insert(), gdcm::DataSet::Insert(), IsGroupXX(), gdcm::PrivateDict::PrintXML(), gdcm::SequenceOfFragments::ReadValue(), gdcm::Attribute< Group, Element, TVR, TVM >::SetFromDataElement(), gdcm::Attribute< Group, Element, TVR, VM::VM1 >::SetFromDataElement(), and gdcm::Attribute< Group, Element, TVR, VM::VM1_n >::SetFromDataElement().

uint32_t gdcm::Tag::GetLength ( ) const

inline

return the length of tag (read: size on disk)

Tag gdcm::Tag::GetPrivateCreator ( ) const

inline

Return the Private Creator Data Element tag of a private data element.

References SetElement().

bool gdcm::Tag::IsGroupLength ( ) const

inline

return whether the tag correspond to a group length tag:

bool gdcm::Tag::IsGroupXX ( const Tag & t ) const

inline

e.g 6002,3000 belong to groupXX: 6000,3000

References GetElement(), GetGroup(), and IsPrivate().

bool gdcm::Tag::IsIllegal ( ) const

inline

return if the tag is considered to be an illegal tag

bool gdcm::Tag::IsPrivate ( ) const

inline

PRIVATE DATA ELEMENT: Additional Data Element, defined by an implementor, to communicate information that is not contained in Standard Data Elements. Private Data elements have odd Group Numbers.

Examples:: DuplicatePCDE.cxx.

Referenced by IsGroupXX(), and SetPrivateCreator().

bool gdcm::Tag::IsPrivateCreator ( ) const

inline

Returns if tag is a Private Creator (xxxx,00yy), where xxxx is odd number and yy in [0x10,0xFF]

Examples:: DuplicatePCDE.cxx.

bool gdcm::Tag::IsPublic ( ) const

inline

STANDARD DATA ELEMENT: A Data Element defined in the DICOM Standard, and therefore listed in the DICOM Data Element Dictionary in PS 3.6. Is the Tag from the Public dict...well the implementation is buggy it does not prove the element is indeed in the dict...

bool gdcm::Tag::operator!= ( const Tag & _val ) const

inline

References tag.

bool gdcm::Tag::operator< ( const Tag & _val ) const

inline

DICOM Standard expects the Data Element to be sorted by Tags All other comparison can be constructed from this one and operator ==

References tag, and tags.

bool gdcm::Tag::operator<= ( const Tag & t2 ) const

inline

Tag& gdcm::Tag::operator= ( const Tag & _val )

inline

References tag.

bool gdcm::Tag::operator== ( const Tag & _val ) const

inline

References tag.

const uint16_t& gdcm::Tag::operator[] ( const unsigned int & _id ) const

inline

Returns the Group or Element of the given Tag, depending on id (0/1)

uint16_t& gdcm::Tag::operator[] ( const unsigned int & _id )

inline

Returns the Group or Element of the given Tag, depending on id (0/1)

std::string gdcm::Tag::PrintAsPipeSeparatedString ( ) const

Print as a pipe separated string (GDCM 1.x compat only). Do not use in newer code

See Also: ReadFromPipeSeparatedString

template<typename TSwap >

std::istream& gdcm::Tag::Read ( std::istream & is )

inline

Read a tag from binary representation.

bool gdcm::Tag::ReadFromCommaSeparatedString ( const char * str )

Read from a comma separated string. This is a highly user oriented function, the string should be formated as: 1234,5678 to specify the tag (0x1234,0x5678) The notation comes from the DICOM standard, and is handy to use from a command line program

bool gdcm::Tag::ReadFromPipeSeparatedString ( const char * str )

Read from a pipe separated string (GDCM 1.x compat only). Do not use in newer code