/usr/include/dcmtk/dcmsr/cmr/cid5001.h is in libdcmtk-dev 3.6.1~20160216-4.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 | /*
*
* Copyright (C) 2015, J. Riesmeier, Oldenburg, Germany
* All rights reserved. See COPYRIGHT file for details.
*
* Header file for class CID5001_Countries
*
* Author: Joerg Riesmeier
*
*/
#ifndef CMR_CID5001_H
#define CMR_CID5001_H
#include "dcmtk/config/osconfig.h" /* make sure OS specific configuration is included first */
#include "dcmtk/dcmsr/dsrctxgr.h"
#include "dcmtk/dcmsr/cmr/define.h"
/*---------------------*
* class declaration *
*---------------------*/
/** Implementation of DCMR Context Group:
* CID 5001 - Countries.
*/
class DCMTK_CMR_EXPORT CID5001_Countries
: public DSRContextGroup
{
public:
/** available countries (in alphabetical order).
* Please note that this list is everything but complete.
*/
enum EnumType
{
/// (AT,ISO3166_1,"Austria")
Austria,
/// (CA,ISO3166_1,"Canada")
Canada,
/// (FR,ISO3166_1,"France")
France,
/// (DE,ISO3166_1,"Germany")
Germany,
/// (CH,ISO3166_1,"Switzerland")
Switzerland,
/// (GB,ISO3166_1,"United Kingdom of Great Britain and Northern Ireland")
UnitedKingdom,
/// (US,ISO3166_1,"United States of America")
UnitedStates
};
/** (default) constructor
** @param selectedValue coded entry to be selected as the current value (optional).
* Should be a valid code according to the DICOM definitions
* for this context group, i.e. should be based on ISO 3166.
*/
CID5001_Countries(const DSRCodedEntryValue &selectedValue = DSRCodedEntryValue());
/** constructor
** @param selectedValue country mapped to a coded entry that is selected as the
* current value
* @param enhancedEncodingMode set enhanced encoding mode for coded entry (if enabled)
*/
CID5001_Countries(const EnumType selectedValue,
const OFBool enhancedEncodingMode = OFFalse);
/** select a coded entry given by its type as the current value
** @param selectedValue country mapped to a coded entry that is selected as
* the current value
* @param enhancedEncodingMode set enhanced encoding mode for coded entry (if enabled)
** @return status, EC_Normal if successful, an error code otherwise
*/
virtual OFCondition selectValue(const EnumType selectedValue,
const OFBool enhancedEncodingMode = OFFalse);
// --- static helper functions ---
/** initialize this context group explicitly. Internally, the list of standard coded
* entries is created and initialized by calling getCodes().
** @note This function can be called multiple times but in case of multi-threaded
* applications should be called at least once before any instance of this class
* is actually used. For single-threaded applications, there is no need to call
* it since the initialization is done implicitly.
*/
static void initialize();
/** cleanup this context group, i.e.\ delete the internal list of standard coded entries.
* Usually, there is no need to call this method, but it might be useful in order to
* explicitly free the associated memory, e.g. when checking for memory leaks. The list
* will be recreated automatically when needed (or when initialize() is called).
*/
static void cleanup();
/** map a given country to the associated coded entry
** @param value country that should be mapped to a coded entry
* @param enhancedEncodingMode set enhanced encoding mode for coded entry (if enabled)
** @return coded entry that is associated with the given type
*/
static DSRCodedEntryValue getCodedEntry(const EnumType value,
const OFBool enhancedEncodingMode = OFFalse);
// --- reintroduce methods from base class
using DSRContextGroup::selectValue;
using DSRContextGroup::findCodedEntry;
protected:
/// type used for storing and managing the coded entries
typedef OFMap<EnumType, DSRBasicCodedEntry> CodeList;
/** print details on coded entries that are contained in this context group.
* See DSRCodedEntryValue::print() for details of the coded entry output.
** @param stream stream to which the output should be printed
*/
virtual void printCodes(STD_NAMESPACE ostream &stream) const;
/** search for a given coded entry in this context group
** @param searchForCodedEntry coded entry to be searched for
* @param foundCodedEntry pointer to variable that will store the coded entry
* (if found and pointer is not NULL)
* @param enhancedEncodingMode set enhanced encoding mode for coded entry (if enabled)
** @return result of the search process, also defines the type of the entry
*/
virtual OFCondition findCodedEntry(const DSRCodedEntryValue &searchForCodedEntry,
DSRCodedEntryValue *foundCodedEntry,
const OFBool enhancedEncodingMode = OFFalse) const;
// --- static helper function ---
/** get list of standard coded entries that are managed by this context group.
* Internally, the singleton pattern is used, so the list is initialized only once.
* Please note that this function is not thread-safe. Therefore, the initialize()
* function can be called before any instance of this class is actually used.
** @return reference to list of coded entries managed by this context group
*/
static CodeList &getCodes();
/** set the "Enhanced Encoding Mode" for a given coded entry
** @param codedEntryValue coded entry for which the enhanced encoding mode is set
** @return status, EC_Normal if successful, an error code otherwise
*/
static OFCondition setEnhancedEncodingMode(DSRCodedEntryValue &codedEntryValue);
private:
/// pointer to internal code list (use a static variable for singleton pattern)
static CodeList *Codes;
};
#endif
|