X-Git-Url: https://git.creatis.insa-lyon.fr/pubgit/?a=blobdiff_plain;f=src%2FgdcmUtil.cxx;h=44b894d409f3cdaee5064374a857d5efe0fc69f4;hb=3ba8c03aa6cb08add6599a1ec7b2b693a967db62;hp=0760f383b929f3daf3ffcdc140a614310baf572a;hpb=1a11accd11061d63d3c09db7b1445637207e81e4;p=gdcm.git diff --git a/src/gdcmUtil.cxx b/src/gdcmUtil.cxx index 0760f383..44b894d4 100644 --- a/src/gdcmUtil.cxx +++ b/src/gdcmUtil.cxx @@ -1,279 +1,404 @@ -// gdcmUtil.cxx -//----------------------------------------------------------------------------- -#include "gdcmUtil.h" - -#include -#include // For isspace -#include +/*========================================================================= + + Program: gdcm + Module: $RCSfile: gdcmUtil.cxx,v $ + Language: C++ + Date: $Date: 2004/11/16 16:49:01 $ + Version: $Revision: 1.67 $ + + Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de + l'Image). All rights reserved. See Doc/License.txt or + http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details. + + This software is distributed WITHOUT ANY WARRANTY; without even + the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR + PURPOSE. See the above copyright notices for more information. + +=========================================================================*/ -//----------------------------------------------------------------------------- -// Library globals. -gdcmDebug dbg; +#include "gdcmUtil.h" +#include "gdcmDebug.h" + +// For GetCurrentDate, GetCurrentTime +#include +#include +#include + +#include //only included in implementation file +#include //only included in implementation file + +#if defined _MSC_VER || defined(__BORLANDC__) + #include // for gethostname & gethostbyname + #undef GetCurrentTime +#else + #include // for gethostname + #include // for gethostbyname +#endif -//----------------------------------------------------------------------------- +namespace gdcm +{ /** - * \ingroup gdcmDebug - * \brief constructor - * @param level debug level - */ + * \ingroup Globals + * \brief Provide a better 'c++' approach for sprintf + * For example c code is: + * sprintf(trash, "%04x|%04x", group , element); + * + * c++ is + * std::ostringstream buf; + * buf << std::right << std::setw(4) << std::setfill('0') << std::hex + * << group << "|" << std::right << std::setw(4) << std::setfill('0') + * << std::hex << element; + * buf.str(); + */ -gdcmDebug::gdcmDebug(int level) { - DebugLevel = level; +std::string Util::Format(const char* format, ...) +{ + char buffer[2048]; + va_list args; + va_start(args, format); + vsprintf(buffer, format, args); //might be a security flaw + va_end(args); // Each invocation of va_start should be matched + // by a corresponding invocation of va_end + // args is then 'undefined' + return buffer; } -/** - * \ingroup gdcmDebug - * \brief Verbose - * @param Level level - * @param Msg1 first message part - * @param Msg2 second message part - */ -void gdcmDebug::Verbose(int Level, const char * Msg1, const char * Msg2) { - if (Level > DebugLevel) - return ; - std::cerr << Msg1 << ' ' << Msg2 << std::endl; -} /** - * \ingroup gdcmDebug - * \brief Error - * @param Test test - * @param Msg1 first message part - * @param Msg2 second message part + * \ingroup Globals + * \brief Because not available in C++ (?) */ -void gdcmDebug::Error( bool Test, const char * Msg1, const char * Msg2) { - if (!Test) - return; - std::cerr << Msg1 << ' ' << Msg2 << std::endl; - Exit(1); +void Util::Tokenize (const std::string& str, + std::vector& tokens, + const std::string& delimiters) +{ + std::string::size_type lastPos = str.find_first_not_of(delimiters,0); + std::string::size_type pos = str.find_first_of (delimiters,lastPos); + while (std::string::npos != pos || std::string::npos != lastPos) + { + tokens.push_back(str.substr(lastPos, pos - lastPos)); + lastPos = str.find_first_not_of(delimiters, pos); + pos = str.find_first_of (delimiters, lastPos); + } } /** - * \ingroup gdcmDebug - * \brief Error - * @param Msg1 first message part - * @param Msg2 second message part - * @param Msg3 Third message part + * \ingroup Globals + * \brief Because not available in C++ (?) + * Counts the number of occurences of a substring within a string */ -void gdcmDebug::Error(const char* Msg1, const char* Msg2, - const char* Msg3) { - std::cerr << Msg1 << ' ' << Msg2 << ' ' << Msg3 << std::endl; - Exit(1); -} + +int Util::CountSubstring (const std::string& str, + const std::string& subStr) +{ + int count = 0; // counts how many times it appears + unsigned int x = 0; // The index position in the string -/** - * \ingroup gdcmDebug - * \brief Assert - * @param Level level - * @param Test test - * @param Msg1 first message part - * @param Msg2 second message part - */ - void gdcmDebug::Assert(int Level, bool Test, - const char * Msg1, const char * Msg2) { - if (Level > DebugLevel) - return ; - if (!Test) - std::cerr << Msg1 << ' ' << Msg2 << std::endl; + do + { + x = str.find(subStr,x); // Find the substring + if (x != std::string::npos) // If present + { + count++; // increase the count + x += subStr.length(); // Skip this word + } + } + while (x != std::string::npos); // Carry on until not present + + return count; } /** - * \ingroup gdcmDebug - * \brief Exit - * @param a return code + * \ingroup Globals + * \brief Weed out a string from the non-printable characters (in order + * to avoid corrupting the terminal of invocation when printing) + * @param s string to remove non printable characters from */ -void gdcmDebug::Exit(int a) { -#ifdef __GNUC__ - std::exit(a); -#endif -#ifdef _MSC_VER - exit(a); // Found in #include -#endif -} +std::string Util::CreateCleanString(std::string const & s) +{ + std::string str = s; -//----------------------------------------------------------------------------- -/// Pointer to a container, holding *all* the Dicom Dictionaries -gdcmDictSet *gdcmGlobal::Dicts = (gdcmDictSet *)0; -/// Pointer to a H table containing the 'Value Representations' -gdcmVR *gdcmGlobal::VR = (gdcmVR *)0; -/// Pointer to a H table containing the Transfer Syntax codes and their english description -gdcmTS *gdcmGlobal::TS = (gdcmTS *)0; -/// Pointer to a H table containing the Dicom Elements necessary to describe each part of a DICOMDIR -gdcmDicomDirElement *gdcmGlobal::ddElem = (gdcmDicomDirElement *)0; -/// gdcm Glob -gdcmGlobal gdcmGlob; + for(unsigned int i=0; i 0) + { + if(!isprint((unsigned char)s[str.size()-1])) + { + if(s[str.size()-1] == 0) + { + str[str.size()-1] = ' '; + } + } + } -/** - * \ingroup gdcmGlobal - * \brief constructor : populates the - */ -gdcmGlobal::gdcmGlobal(void) { - if (VR || TS || Dicts || ddElem) - dbg.Verbose(0, "gdcmGlobal::gdcmGlobal : VR or TS or Dicts already allocated"); - Dicts = new gdcmDictSet(); - VR = new gdcmVR(); - TS = new gdcmTS(); - ddElem = new gdcmDicomDirElement(); + return str; } /** - * \ingroup gdcmGlobal - * \brief canonical destructor + * \ingroup Globals + * \brief Add a SEPARATOR to the end of the name is necessary + * @param pathname file/directory name to normalize */ -gdcmGlobal::~gdcmGlobal() { - delete Dicts; - delete VR; - delete TS; - delete ddElem; -} +std::string Util::NormalizePath(std::string const & pathname) +{ + const char SEPARATOR_X = '/'; + const char SEPARATOR_WIN = '\\'; + const std::string SEPARATOR = "/"; + std::string name = pathname; + int size = name.size(); -gdcmVR *gdcmGlobal::GetVR(void) { - return VR; + if( name[size-1] != SEPARATOR_X && name[size-1] != SEPARATOR_WIN ) + { + name += SEPARATOR; + } + return name; } -gdcmTS *gdcmGlobal::GetTS(void) { - return TS; -} +/** + * \ingroup Globals + * \brief Get the (directory) path from a full path file name + * @param fullName file/directory name to extract Path from + */ +std::string Util::GetPath(std::string const & fullName) +{ + std::string res = fullName; + int pos1 = res.rfind("/"); + int pos2 = res.rfind("\\"); + if( pos1 > pos2) + { + res.resize(pos1); + } + else + { + res.resize(pos2); + } -gdcmDictSet *gdcmGlobal::GetDicts(void) { - return Dicts; + return res; } -gdcmDicomDirElement *gdcmGlobal::GetDicomDirElements(void) { - return ddElem; -} +/** + * \ingroup Util + * \brief Get the (last) name of a full path file name + * @param fullName file/directory name to extract end name from + */ +std::string Util::GetName(std::string const & fullName) +{ + std::string filename = fullName; + + std::string::size_type slash_pos = filename.rfind("/"); + std::string::size_type backslash_pos = filename.rfind("\\"); + slash_pos = slash_pos > backslash_pos ? slash_pos : backslash_pos; + if(slash_pos != std::string::npos) + { + return filename.substr(slash_pos + 1); + } + else + { + return filename; + } +} -//----------------------------------------------------------------------------- -// Here are some usefull functions, belonging to NO class, -// dealing with strings, file names, etc -// that can be called from anywhere -// by whomsoever they can help. -//----------------------------------------------------------------------------- - -// Because is not yet available in g++2.96 -std::istream& eatwhite(std::istream& is) { - char c; - while (is.get(c)) { - if (!isspace(c)) { - is.putback(c); - break; - } - } - return is; +/** + * \ingroup Util + * \brief Get the current date of the system in a dicom string + */ +std::string Util::GetCurrentDate() +{ + char tmp[512]; + time_t tloc; + time (&tloc); + strftime(tmp,512,"%Y%m%d", localtime(&tloc) ); + return tmp; } -/////////////////////////////////////////////////////////////////////////// -// Because is not available in C++ (?) -void Tokenize (const std::string& str, - std::vector& tokens, - const std::string& delimiters) { - std::string::size_type lastPos = str.find_first_not_of(delimiters,0); - std::string::size_type pos = str.find_first_of (delimiters,lastPos); - while (std::string::npos != pos || std::string::npos != lastPos) { - tokens.push_back(str.substr(lastPos, pos - lastPos)); - lastPos = str.find_first_not_of(delimiters, pos); - pos = str.find_first_of (delimiters, lastPos); - } +/** + * \ingroup Util + * \brief Get the current time of the system in a dicom string + */ +std::string Util::GetCurrentTime() +{ + char tmp[512]; + time_t tloc; + time (&tloc); + strftime(tmp,512,"%H%M%S", localtime(&tloc) ); + return tmp; } - -/////////////////////////////////////////////////////////////////////////// /** - * \brief to prevent a flashing screen when non-printable character - * @param v characters array to remove non printable characters from + * \brief Create a /DICOM/ string: + * It should a of even length (no odd length ever) + * It can contain as many (if you are reading this from your + * editor the following character is is backslash followed by zero + * that needed to be escaped with an extra backslash for doxygen) \\0 + * as you want. */ -char *_cleanString(char *v) { - char *d; - int i, l; - l = strlen(v); - for (i=0,d=v; - i0) - if(!isprint(s[str.size()-1])) - if(s[str.size()-1]==0) - str[str.size()-1]=' '; - - return(str); + std::string r(s, s+l); + assert( !(r.size() % 2) ); + return r; } -/////////////////////////////////////////////////////////////////////////// /** - * \brief Add a SEPARATOR to the end of the name is necessary - * @param name file/directory name to normalize + * \ingroup Util + * \brief Safely compare two Dicom String: + * - Both string should be of even lenght + * - We allow padding of even lenght string by either a null + * character of a space */ -void NormalizePath(std::string &name) +bool Util::DicomStringEqual(const std::string& s1, const char *s2) { -const char SEPARATOR_X = '/'; -const char SEPARATOR_WIN = '\\'; -const std::string SEPARATOR = "/"; - int size=name.size(); - if((name[size-1]!=SEPARATOR_X)&&(name[size-1]!=SEPARATOR_WIN)) - { - name+=SEPARATOR; - } + // s2 is the string from the DICOM reference: 'MONOCHROME1' + std::string s1_even = s1; //Never change input parameter + std::string s2_even = DicomString( s2 ); + if( s1_even[s1_even.size()-1] == ' ') + { + s1_even[s1_even.size()-1] = '\0'; //replace space character by null + } + return s1_even == s2_even; } -/////////////////////////////////////////////////////////////////////////// /** - * \brief Get the (directory) path from a full path file name - * @param fullName file/directory name to extract Path from + * \ingroup Util + * \brief Return the IP adress of the machine writting the DICOM image */ -std::string GetPath(std::string &fullName) +std::string Util::GetIPAddress() { - int pos1=fullName.rfind("/"); - int pos2=fullName.rfind("\\"); - if(pos1>pos2) - fullName.resize(pos1); - else - fullName.resize(pos2); - return(fullName); + // This is a rip from http://www.codeguru.com/Cpp/I-N/internet/network/article.php/c3445/ +#ifndef HOST_NAME_MAX + // SUSv2 guarantees that `Host names are limited to 255 bytes'. + // POSIX 1003.1-2001 guarantees that `Host names (not including the + // terminating NUL) are limited to HOST_NAME_MAX bytes'. +# define HOST_NAME_MAX 255 + // In this case we should maybe check the string was not truncated. + // But I don't known how to check that... +#endif //HOST_NAME_MAX + + std::string str; + char szHostName[HOST_NAME_MAX+1]; + int r = gethostname(szHostName, HOST_NAME_MAX); + + if( r == 0 ) + { + // Get host adresses + struct hostent * pHost = gethostbyname(szHostName); + + for( int i = 0; pHost!= NULL && pHost->h_addr_list[i]!= NULL; i++ ) + { + for( int j = 0; jh_length; j++ ) + { + if( j > 0 ) str += "."; + + str += Util::Format("%u", + (unsigned int)((unsigned char*)pHost->h_addr_list[i])[j]); + } + // str now contains one local IP address + } + } + // If an error occur r == -1 + // Most of the time it will return 127.0.0.1... + return str; } -/////////////////////////////////////////////////////////////////////////// /** - * \brief Get the (last) name of a full path file name - * @param fullName file/directory name to extract end name from + * \ingroup Util + * \brief Creates a new UID. As stipulate in the DICOM ref + * each time a DICOM image is create it should have + * a unique identifier (URI) */ -std::string GetName(std::string &fullName) -{ - int fin=fullName.length()-1; - char a =fullName.c_str()[fin]; - if (a == '/' || a == '\\') { - fin--; +std::string Util::CreateUniqueUID(const std::string& root) +{ + // The code works as follow: + // echo "gdcm" | od -b + // 0000000 147 144 143 155 012 + // Therefore we return + // radical + 147.144.143.155 + IP + time() + std::string radical = root; + if( !root.size() ) //anything better ? + { + radical = "0.0."; // Is this really usefull ? } - int deb; - for (int i=fin;i!=0;i--) { - if (fullName.c_str()[i] == '/' || fullName.c_str()[i] == '\\') - break; - deb = i; - } - - std::string lastName; - for (int j=deb;j +std::ostream& binary_write(std::ostream& os, const T& val) +{ + return os.write(reinterpret_cast(&val), sizeof val); +} + +std::ostream& binary_write(std::ostream& os, const uint16_t& val) +{ +#ifdef GDCM_WORDS_BIGENDIAN + uint16_t swap; + swap = ((( val << 8 ) & 0x0ff00 ) | (( val >> 8 ) & 0x00ff ) ); + return os.write(reinterpret_cast(&swap), 2); +#else + return os.write(reinterpret_cast(&val), 2); +#endif //GDCM_WORDS_BIGENDIAN +} + +std::ostream& binary_write(std::ostream& os, const uint32_t& val) +{ +#ifdef GDCM_WORDS_BIGENDIAN + uint32_t swap; + swap = ( ((val<<24) & 0xff000000) | ((val<<8) & 0x00ff0000) | + ((val>>8) & 0x0000ff00) | ((val>>24) & 0x000000ff) ); + return os.write(reinterpret_cast(&swap), 4); +#else + return os.write(reinterpret_cast(&val), 4); +#endif //GDCM_WORDS_BIGENDIAN +} + +std::ostream& binary_write(std::ostream& os, const char* val) +{ + return os.write(val, strlen(val)); +} + +std::ostream& binary_write(std::ostream& os, std::string const & val) +{ + return os.write(val.c_str(), val.size()); +} + +} // end namespace gdcm +