]> Creatis software - gdcm.git/blob - gdcmUtil.h
ecda0167c6d94aa946c17e54e9344770ed31cfad
[gdcm.git] / gdcmUtil.h
1 /*=========================================================================
2                                                                                 
3   Program:   gdcm
4   Module:    $RCSfile: gdcmUtil.h,v $
5   Language:  C++
6   Date:      $Date: 2005/10/27 17:04:36 $
7   Version:   $Revision: 1.65 $
8                                                                                 
9   Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
10   l'Image). All rights reserved. See Doc/License.txt or
11   http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
12                                                                                 
13      This software is distributed WITHOUT ANY WARRANTY; without even
14      the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15      PURPOSE.  See the above copyright notices for more information.
16                                                                                 
17 =========================================================================*/
18
19 #ifndef GDCMUTIL_H
20 #define GDCMUTIL_H
21
22 #include "gdcmCommon.h"
23 #include <vector>
24 #include <string>
25
26 namespace gdcm 
27 {
28 /**
29  * \brief    Here are some utility functions, belonging to the gdcm::Util class,
30  *           dealing with strings, file names... that can be called
31  *           from anywhere by whomsoever they can help.
32  */
33
34 //-----------------------------------------------------------------------------
35
36 class GDCM_EXPORT Util
37 {
38 public:
39    static std::string Format(const char *format, ...);
40    static void        Tokenize (const std::string &str,
41                                 std::vector<std::string> &tokens,
42                                 const std::string &delimiters = " ");
43    static int         CountSubstring (const std::string &str,
44                                       const std::string &subStr);
45
46    static std::string CreateCleanString(std::string const &s);
47    static std::string CreateCleanString(uint8_t *s, int l);
48    static bool IsCleanString(std::string const &s);
49    static bool IsCleanArea(uint8_t *s, int l);
50    static std::string NormalizePath(std::string const &name);
51    static std::string GetPath(std::string const &fullName);
52    static std::string GetName(std::string const &fullName);
53    static std::string GetCurrentDate();
54    static std::string GetCurrentTime();
55    static std::string GetCurrentDateTime();
56    /// Provides a simple static GetVersion() function
57    static std::string GetVersion() 
58                       { return GDCM_VERSION;}
59    static unsigned int GetCurrentThreadID();
60    static unsigned int GetCurrentProcessID();
61    static bool         IsCurrentProcessorBigEndian();
62
63    static std::string DicomString(const char *s, size_t l);
64    static std::string DicomString(const char *s);
65    static bool        DicomStringEqual(const std::string &s1, const char *s2);
66    static bool        CompareDicomString(const std::string &s1, 
67                                          const char *s2, int op);
68    static std::string GetMACAddress();
69
70    static std::string CreateUniqueUID(const std::string &root = "");
71    static void SetRootUID(const std::string &root = "");
72    static const std::string &GetRootUID();
73
74    static const uint8_t *GetFileMetaInformationVersion() 
75                      { return FileMetaInformationVersion;}
76    static void SetFileMetaInformationVersion( uint16_t fmiv )
77                      { FileMetaInformationVersion = (uint8_t *)&fmiv; }
78
79 // ----------------- to be removed later --------------------------     
80 //To perform a full check of inline functions on all the platforms, 
81 // we put here the two 'static' functions
82 // hifpswap and  hNoifpswap in a .h
83 // They will be remove ASAP
84
85    static inline void hifpswap(double *a, double *b)    
86    {
87       double tmp;
88       tmp = *a;
89       *a = *b;
90       *b = tmp;
91    }
92    static void hNoifpswap(double *a, double *b)    
93    {
94       double tmp;
95       tmp = *a;
96       *a = *b;
97       *b = tmp;
98    }    
99 // ------------ end of functions to remove --------------------
100 private:
101    static std::string GetIPAddress(); //Do not expose this method
102
103    static std::string RootUID;
104    static const std::string GDCM_UID;
105    static uint8_t *FileMetaInformationVersion;
106    static const uint16_t FMIV;
107    static std::string GDCM_MAC_ADRESS;
108 };
109
110 GDCM_EXPORT std::ostream &binary_write(std::ostream &os, const uint16_t &val);
111 GDCM_EXPORT std::ostream &binary_write(std::ostream &os, const uint32_t &val);
112 GDCM_EXPORT std::ostream &binary_write(std::ostream &os, const double &val);
113 GDCM_EXPORT std::ostream &binary_write(std::ostream &os, const char *val);
114 GDCM_EXPORT std::ostream &binary_write(std::ostream &os, std::string const &val);
115 GDCM_EXPORT std::ostream &binary_write(std::ostream &os, const uint8_t *val, size_t len);
116 GDCM_EXPORT std::ostream &binary_write(std::ostream &os, const uint16_t *val, size_t len);
117 } // end namespace gdcm
118 //-----------------------------------------------------------------------------
119 #endif