MUtilities.git/patch/7b01ea510b1c53b05ebcb4326b9e61d7ceead7c6

 // MuldeR's Utilities for Qt
 // Copyright (C) 2004-2019 LoRd_MuldeR <MuldeR2@GMX.de>
 //
 // This library is free software; you can redistribute it and/or
 // modify it under the terms of the GNU Lesser General Public
 // License as published by the Free Software Foundation; either
 // version 2.1 of the License, or (at your option) any later version.
 //
 // This library is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 // Lesser General Public License for more details.
 //
 // You should have received a copy of the GNU Lesser General Public
 // License along with this library; if not, write to the Free Software
 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 //
 // http://www.gnu.org/licenses/lgpl-2.1.txt

 #pragma once

 //MUtils
 #include <MUtils/Global.h>

 //Qt
 #include <QString>
 #include <QMap>
 #include <QDate>
 #include <QWidget>

 //Forward declaration
 class QFile;


 namespace MUtils
 {
     namespace OS
     {
         namespace Version
         {
             typedef enum
             {
                 OS_UNKNOWN = 0,
                 OS_WINDOWS = 1
             }
             os_type_t;

             typedef struct _os_version_t
             {
                 unsigned int type;
                 unsigned int versionMajor;
                 unsigned int versionMinor;
                 unsigned int versionBuild;
                 unsigned int versionSPack;
                 bool overrideFlag;

                 MUTILS_API bool operator== (const _os_version_t &rhs) const;
                 MUTILS_API bool operator!= (const _os_version_t &rhs) const;
                 MUTILS_API bool operator>  (const _os_version_t &rhs) const;
                 MUTILS_API bool operator>= (const _os_version_t &rhs) const;
                 MUTILS_API bool operator<  (const _os_version_t &rhs) const;
                 MUTILS_API bool operator<= (const _os_version_t &rhs) const;
             }
             os_version_t;

             //Known Windows NT versions
             MUTILS_API extern const os_version_t WINDOWS_WIN2K;
             MUTILS_API extern const os_version_t WINDOWS_WINXP;
             MUTILS_API extern const os_version_t WINDOWS_XPX64;
             MUTILS_API extern const os_version_t WINDOWS_VISTA;
             MUTILS_API extern const os_version_t WINDOWS_WIN70;
             MUTILS_API extern const os_version_t WINDOWS_WIN80;
             MUTILS_API extern const os_version_t WINDOWS_WIN81;
             MUTILS_API extern const os_version_t WINDOWS_WN100;

             //Unknown OS
             MUTILS_API extern const os_version_t UNKNOWN_OPSYS;
         }

         typedef enum
         {
             FOLDER_ROAMING_DATA = 0,
             FOLDER_LOCALAPPDATA = 1,
             FOLDER_USER_PROFILE = 2,
             FOLDER_PROGRAMFILES = 3,
             FOLDER_SYSTEMFOLDER = 4,
             FOLDER_SYSTROOT_DIR = 5
         }
         known_folder_t;

         typedef enum
         {
             NETWORK_TYPE_ERR = 0,
             NETWORK_TYPE_NON = 1,
             NETWORK_TYPE_YES = 2
         }
         network_type_t;

         typedef enum
         {
             DRIVE_TYPE_ERR = 0,
             DRIVE_TYPE_FDD = 1,
             DRIVE_TYPE_HDD = 2,
             DRIVE_TYPE_NET = 3,
             DRIVE_TYPE_OPT = 4,
             DRIVE_TYPE_RAM = 5
         }
         drive_type_t;

         //System message
         MUTILS_API void system_message_nfo(const wchar_t *const title, const wchar_t *const text);
         MUTILS_API void system_message_wrn(const wchar_t *const title, const wchar_t *const text);
         MUTILS_API void system_message_err(const wchar_t *const title, const wchar_t *const text);

         //CLI Arguments
         typedef QMap<QString,QString> ArgumentMap;
         MUTILS_API const QStringList crack_command_line(const QString &command_line = QString());
         MUTILS_API const ArgumentMap &arguments(void);

         //Copy file
         typedef bool (*progress_callback_t)(const double &progress, void *const userData);
         MUTILS_API bool copy_file(const QString &sourcePath, const QString &outputPath, const bool &overwrite = true, const progress_callback_t callback = NULL, void *const userData = NULL);

         //Get file version
         MUTILS_API bool get_file_version(const QString fileName, quint16 *const major = NULL, quint16 *const minor = NULL, quint16 *const patch = NULL, quint16 *const build = NULL);

         //Get the OS version
         MUTILS_API const Version::os_version_t &os_version(void);
         MUTILS_API const char *os_friendly_name(const MUtils::OS::Version::os_version_t &os_version);
         MUTILS_API const bool &running_on_wine(void);

         //Get known Folder
         MUTILS_API const QString &known_folder(known_folder_t folder_id);

         //Current Date & Time
         MUTILS_API QDate current_date(void);
         MUTILS_API quint64 current_file_time(void);

         //Check for process elevation
         MUTILS_API bool is_elevated(bool *bIsUacEnabled = NULL);
         MUTILS_API bool user_is_admin(void);

         MUTILS_API int network_status(void);

         //Message handler
         MUTILS_API bool handle_os_message(const void *const message, long *result);

         MUTILS_API void sleep_ms(const size_t &duration);

         //Is executable/library file?
         MUTILS_API bool is_executable_file(const QString &path);
         MUTILS_API bool is_library_file(const QString &path);

         //Shutdown & Hibernation
         MUTILS_API bool is_hibernation_supported(void);
         MUTILS_API bool shutdown_computer(const QString &message, const unsigned long timeout, const bool forceShutdown, const bool hibernate);

         //Free diskspace
         MUTILS_API bool free_diskspace(const QString &path, quint64 &freeSpace);

         MUTILS_API drive_type_t get_drive_type(const QString &path, bool *fast_seeking = NULL);

         //Shell open
         MUTILS_API bool shell_open(const QWidget *parent, const QString &url, const bool explore = false);
         MUTILS_API bool shell_open(const QWidget *parent, const QString &url, const QString &parameters, const QString &directory, const bool explore = false);

         //Open media file
         MUTILS_API bool open_media_file(const QString &mediaFilePath);

         //Process priority
         MUTILS_API bool change_process_priority(const int priority);
         MUTILS_API bool change_process_priority(const QProcess *proc, const int priority);

         //Process ID
         MUTILS_API quint32 process_id(void);
         MUTILS_API quint32 process_id(const QProcess *const proc);

         //Thread ID
         MUTILS_API quint32 thread_id(void);
         MUTILS_API quint32 thread_id(const QProcess *const proc);

         //Suspend or resume processv
         MUTILS_API bool suspend_process(const QProcess *proc, const bool suspend);

         //System timer resolution
         MUTILS_API bool setup_timer_resolution(const quint32 &interval = 1);
         MUTILS_API bool reset_timer_resolution(const quint32 &interval = 1);

         //Set file time
         MUTILS_API bool set_file_time(const QFile &file,   const QDateTime &created = QDateTime(), const QDateTime &modified = QDateTime(), const QDateTime &accessed = QDateTime());
         MUTILS_API bool set_file_time(const QString &path, const QDateTime &created = QDateTime(), const QDateTime &modified = QDateTime(), const QDateTime &accessed = QDateTime());

         //Keyboard support
         MUTILS_API bool check_key_state_esc(void);

         //Shell notification
         MUTILS_API void shell_change_notification(void);

         //Get file path from descriptor
         MUTILS_API QString get_file_path(const int &fd);

         //WOW64 redirection
         MUTILS_API bool wow64fsredir_disable(void *oldValue);
         MUTILS_API bool wow64fsredir_revert (void *oldValue);

         //Environment variables
         MUTILS_API QString get_envvar(const QString &name);
         MUTILS_API bool set_envvar(const QString &name, const QString &value);

         //NULL device
         MUTILS_API const QLatin1String &null_device(void);

         //Check if debugger is present
         MUTILS_API void check_debugger(void);

         //Error handling
         MUTILS_API void fatal_exit(const wchar_t* const errorMessage);
     }
 }

MUtils::OS::network_status
MUTILS_API int network_status(void)
Check the network status.

+Go to the documentation of this file. // MuldeR's Utilities for Qt
 // Copyright (C) 2004-2019 LoRd_MuldeR <MuldeR2@GMX.de>
 //
 // This library is free software; you can redistribute it and/or
 // modify it under the terms of the GNU Lesser General Public
 // License as published by the Free Software Foundation; either
 // version 2.1 of the License, or (at your option) any later version.
 //
 // This library is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 // Lesser General Public License for more details.
 //
 // You should have received a copy of the GNU Lesser General Public
 // License along with this library; if not, write to the Free Software
 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 //
 // http://www.gnu.org/licenses/lgpl-2.1.txt

 #pragma once

 //MUtils
 #include <MUtils/Global.h>

 //Qt
 #include <QString>
 #include <QMap>
 #include <QDate>
 #include <QWidget>

 //Forward declaration
 class QFile;


 namespace MUtils
 {
     namespace OS
     {
         namespace Version
         {
             typedef enum
             {
                 OS_UNKNOWN = 0,
                 OS_WINDOWS = 1
             }
             os_type_t;

             typedef struct _os_version_t
             {
                 unsigned int type;
                 unsigned int versionMajor;
                 unsigned int versionMinor;
                 unsigned int versionBuild;
                 unsigned int versionSPack;
                 bool overrideFlag;

                 MUTILS_API bool operator== (const _os_version_t &rhs) const;
                 MUTILS_API bool operator!= (const _os_version_t &rhs) const;
                 MUTILS_API bool operator>  (const _os_version_t &rhs) const;
                 MUTILS_API bool operator>= (const _os_version_t &rhs) const;
                 MUTILS_API bool operator<  (const _os_version_t &rhs) const;
                 MUTILS_API bool operator<= (const _os_version_t &rhs) const;
             }
             os_version_t;

             //Known Windows NT versions
             MUTILS_API extern const os_version_t WINDOWS_WIN2K;
             MUTILS_API extern const os_version_t WINDOWS_WINXP;
             MUTILS_API extern const os_version_t WINDOWS_XPX64;
             MUTILS_API extern const os_version_t WINDOWS_VISTA;
             MUTILS_API extern const os_version_t WINDOWS_WIN70;
             MUTILS_API extern const os_version_t WINDOWS_WIN80;
             MUTILS_API extern const os_version_t WINDOWS_WIN81;
             MUTILS_API extern const os_version_t WINDOWS_WN100;

             //Unknown OS
             MUTILS_API extern const os_version_t UNKNOWN_OPSYS;
         }

         typedef enum
         {
             FOLDER_ROAMING_DATA = 0,
             FOLDER_LOCALAPPDATA = 1,
             FOLDER_USER_PROFILE = 2,
             FOLDER_PROGRAMFILES = 3,
             FOLDER_SYSTEMFOLDER = 4,
             FOLDER_SYSTROOT_DIR = 5
         }
         known_folder_t;

         typedef enum
         {
             NETWORK_TYPE_ERR = 0,
             NETWORK_TYPE_NON = 1,
             NETWORK_TYPE_YES = 2
         }
         network_type_t;

         typedef enum
         {
             DRIVE_TYPE_ERR = 0,
             DRIVE_TYPE_FDD = 1,
             DRIVE_TYPE_HDD = 2,
             DRIVE_TYPE_NET = 3,
             DRIVE_TYPE_OPT = 4,
             DRIVE_TYPE_RAM = 5
         }
         drive_type_t;

         //System message
         MUTILS_API void system_message_nfo(const wchar_t *const title, const wchar_t *const text);
         MUTILS_API void system_message_wrn(const wchar_t *const title, const wchar_t *const text);
         MUTILS_API void system_message_err(const wchar_t *const title, const wchar_t *const text);

         //CLI Arguments
         typedef QMap<QString,QString> ArgumentMap;
         MUTILS_API const QStringList crack_command_line(const QString &command_line = QString());
         MUTILS_API const ArgumentMap &arguments(void);

         //Copy file
         typedef bool (*progress_callback_t)(const double &progress, void *const userData);
         MUTILS_API bool copy_file(const QString &sourcePath, const QString &outputPath, const bool &overwrite = true, const progress_callback_t callback = NULL, void *const userData = NULL);

         //Get file version
         MUTILS_API bool get_file_version(const QString fileName, quint16 *const major = NULL, quint16 *const minor = NULL, quint16 *const patch = NULL, quint16 *const build = NULL);

         //Get the OS version
         MUTILS_API const Version::os_version_t &os_version(void);
         MUTILS_API const char *os_friendly_name(const MUtils::OS::Version::os_version_t &os_version);
         MUTILS_API const bool &running_on_wine(void);

         //Get known Folder
         MUTILS_API const QString &known_folder(known_folder_t folder_id);

         //Current Date & Time
         MUTILS_API QDate current_date(void);
         MUTILS_API quint64 current_file_time(void);

         //Check for process elevation
         MUTILS_API bool is_elevated(bool *bIsUacEnabled = NULL);
         MUTILS_API bool user_is_admin(void);

         MUTILS_API int network_status(void);

         //Message handler
         MUTILS_API bool handle_os_message(const void *const message, long *result);

         MUTILS_API void sleep_ms(const size_t &duration);

         //Is executable/library file?
         MUTILS_API bool is_executable_file(const QString &path);
         MUTILS_API bool is_library_file(const QString &path);

         //Shutdown & Hibernation
         MUTILS_API bool is_hibernation_supported(void);
         MUTILS_API bool shutdown_computer(const QString &message, const unsigned long timeout, const bool forceShutdown, const bool hibernate);

         //Free diskspace
         MUTILS_API bool free_diskspace(const QString &path, quint64 &freeSpace);

         MUTILS_API drive_type_t get_drive_type(const QString &path, bool *fast_seeking = NULL);

         //Shell open
         MUTILS_API bool shell_open(const QWidget *parent, const QString &url, const bool explore = false);
         MUTILS_API bool shell_open(const QWidget *parent, const QString &url, const QString &parameters, const QString &directory, const bool explore = false);

         //Open media file
         MUTILS_API bool open_media_file(const QString &mediaFilePath);

         //Process priority
         MUTILS_API bool change_process_priority(const int priority);
         MUTILS_API bool change_process_priority(const QProcess *proc, const int priority);

         //Process ID
         MUTILS_API quint32 process_id(void);
         MUTILS_API quint32 process_id(const QProcess *const proc);

         //Thread ID
         MUTILS_API quint32 thread_id(void);
         MUTILS_API quint32 thread_id(const QProcess *const proc);

         //Suspend or resume processv
         MUTILS_API bool suspend_process(const QProcess *proc, const bool suspend);

         //System timer resolution
         MUTILS_API bool setup_timer_resolution(const quint32 &interval = 1);
         MUTILS_API bool reset_timer_resolution(const quint32 &interval = 1);

         //Set file time
         MUTILS_API bool set_file_time(const QFile &file,   const QDateTime &created = QDateTime(), const QDateTime &modified = QDateTime(), const QDateTime &accessed = QDateTime());
         MUTILS_API bool set_file_time(const QString &path, const QDateTime &created = QDateTime(), const QDateTime &modified = QDateTime(), const QDateTime &accessed = QDateTime());

         //Keyboard support
         MUTILS_API bool check_key_state_esc(void);

         //Shell notification
         MUTILS_API void shell_change_notification(void);

         //Get file path from descriptor
         MUTILS_API QString get_file_path(const int &fd);

         //WOW64 redirection
         MUTILS_API bool wow64fsredir_disable(uintptr_t &oldValue);
         MUTILS_API bool wow64fsredir_revert (const uintptr_t oldValue);

         //Environment variables
         MUTILS_API QString get_envvar(const QString &name);
         MUTILS_API bool set_envvar(const QString &name, const QString &value);

         //NULL device
         MUTILS_API const QLatin1String &null_device(void);

         //Check if debugger is present
         MUTILS_API void check_debugger(void);

         //Error handling
         MUTILS_API void fatal_exit(const wchar_t* const errorMessage);
     }
 }

MUtils::OS::network_status
MUTILS_API int network_status(void)
Check the network status.

 MUtils::OS::Version::UNKNOWN_OPSYS
MUTILS_API const os_version_t UNKNOWN_OPSYS
Operating system version constant.

 MUtils::OS::FOLDER_LOCALAPPDATA
Local application data (non-roaming)
Definition: OSSupport.h:109

 MUtils::OS::Version::_os_version_t::versionMinor
unsigned int versionMinor
The minor version of the underlaying operating system.
Definition: OSSupport.h:75

diff --git a/docs/d4/d85/_job_object_8h_source.html b/docs/d4/d85/_job_object_8h_source.html
index a299102..ea186dc 100644
--- a/docs/d4/d85/_job_object_8h_source.html
+++ b/docs/d4/d85/_job_object_8h_source.html
@@ -70,7 +70,7 @@ $(function() {
 Go to the documentation of this file. // MuldeR's Utilities for Qt
 // Copyright (C) 2004-2019 LoRd_MuldeR <MuldeR2@GMX.de>
 //
 // This library is free software; you can redistribute it and/or
 // modify it under the terms of the GNU Lesser General Public
 // License as published by the Free Software Foundation; either
 // version 2.1 of the License, or (at your option) any later version.
 //
 // This library is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 // Lesser General Public License for more details.
 //
 // You should have received a copy of the GNU Lesser General Public
 // License along with this library; if not, write to the Free Software
 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 //
 // http://www.gnu.org/licenses/lgpl-2.1.txt

 #pragma once

 #include <MUtils/Global.h>

 class QProcess;

 namespace MUtils
 {
     class MUTILS_API JobObject
     {
     public:
         JobObject(void);

         ~JobObject(void);

         bool isObjectCreated(void);

         bool addProcessToJob(const QProcess *const process);

         bool terminateJob(const quint32 &exitCode);

     private:
         uintptr_t m_jobPtr;
         MUTILS_NO_COPY(JobObject)
     };
 }
Global.h
This file contains miscellaneous functions that are generally useful for Qt-based applications...

 MUtils::JobObject
This class represents a job object.
Definition: JobObject.h:46

 MUtils
Global MUtils namespace.
Definition: CPUFeatures.h:37

-MUTILS_NO_COPY
#define MUTILS_NO_COPY(CLASS)
Disables copy constructor and assignment operator in the specified class. This macro should be used i...
Definition: Global.h:405

+MUTILS_NO_COPY
#define MUTILS_NO_COPY(CLASS)
Disables copy constructor and assignment operator in the specified class. This macro should be used i...
Definition: Global.h:416


diff --git a/docs/d5/d3b/_global_8h_source.html b/docs/d5/d3b/_global_8h_source.html
dissimilarity index 60%
index d917e0a..3d07cf2 100644
--- a/docs/d5/d3b/_global_8h_source.html
+++ b/docs/d5/d3b/_global_8h_source.html
@@ -1,100 +1,100 @@
-
-
-
-
-
-
-
-MuldeR's Utilities for Qt: include/MUtils/Global.h Source File
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-   MuldeR's Utilities for Qt
-

-   MUtilities

-

-

-
-
-
-
-
-
-

-
-
-

-
-
-
-
-
-

-
-
-
-include
MUtils

-

-

-
-
-Global.h


-

-
-Go to the documentation of this file. // MuldeR's Utilities for Qt
 // Copyright (C) 2004-2019 LoRd_MuldeR <MuldeR2@GMX.de>
 //
 // This library is free software; you can redistribute it and/or
 // modify it under the terms of the GNU Lesser General Public
 // License as published by the Free Software Foundation; either
 // version 2.1 of the License, or (at your option) any later version.
 //
 // This library is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 // Lesser General Public License for more details.
 //
 // You should have received a copy of the GNU Lesser General Public
 // License along with this library; if not, write to the Free Software
 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 //
 // http://www.gnu.org/licenses/lgpl-2.1.txt

 #pragma once

 #include <QString>

 //Forward Declarations
 class QProcess;
 class QDir;
 template<typename K, typename V> class QHash;


 //MUtils API
 #ifdef _MSC_VER
 #   ifdef MUTILS_DLL_EXPORT
 #       define MUTILS_API __declspec(dllexport)
 #   else
 #       ifndef MUTILS_STATIC_LIB
 #           define MUTILS_API __declspec(dllimport)
 #       else
 #           define MUTILS_API /*static lib*/
 #       endif
 #   endif
 #else
 #   define MUTILS_API
 #endif

 #define MUTILS_MAKE_STRING_HELPER(X) #X
 #define MUTILS_MAKE_STRING(X) MUTILS_MAKE_STRING_HELPER(X)
 #define MUTILS_COMPILER_WARNING(TXT) __pragma(message(__FILE__ "(" MUTILS_MAKE_STRING(__LINE__) ") : warning: " TXT))

 //Check Debug Flags
 #if defined(_DEBUG) || defined(DEBUG) || (!defined(NDEBUG))
 #   define MUTILS_DEBUG (1)
 #   if defined(NDEBUG) || defined(QT_NO_DEBUG) || (!defined(QT_DEBUG))
 #       error Inconsistent DEBUG flags have been detected!
 #   endif
 #else
 #   define MUTILS_DEBUG (0)
 #   if (!defined(NDEBUG)) || (!defined(QT_NO_DEBUG)) || defined(QT_DEBUG)
 #       error Inconsistent DEBUG flags have been detected!
 #   endif
 #endif

 //Check CPU options
 #if defined(_MSC_VER) && (!defined(__INTELLISENSE__)) && (!defined(_M_X64)) && defined(_M_IX86_FP)
     #if (_M_IX86_FP != 0)
         #error We should not enabled SSE or SSE2 in release builds!
     #endif
 #endif


 namespace MUtils
 {
     typedef struct _fp_parts_t { double parts[2]; } fp_parts_t;

     MUTILS_API const QString& temp_folder(void);

     MUTILS_API void init_process(QProcess &process, const QString &wokringDir, const bool bReplaceTempDir = true, const QStringList *const extraPaths = NULL, const QHash<QString, QString> *const extraEnv = NULL);

     MUTILS_API quint32 next_rand_u32(void);
     MUTILS_API quint32 next_rand_u32(const quint32 max);

     MUTILS_API quint64 next_rand_u64(void);

     MUTILS_API QString next_rand_str(const bool &bLong = false);

     MUTILS_API QString make_temp_file(const QString &basePath, const QString &extension, const bool placeholder = false);
     MUTILS_API QString make_temp_file(const QDir    &basePath, const QString &extension, const bool placeholder = false);

     MUTILS_API QString make_unique_file(const QString &basePath, const QString &baseName, const QString &extension, const bool fancy = false, const bool placeholder = false);
     MUTILS_API QString make_unique_file(const QDir    &basePath, const QString &baseName, const QString &extension, const bool fancy = false, const bool placeholder = false);

     MUTILS_API bool parity(quint32 value);

     MUTILS_API bool remove_file(const QString &fileName);

     MUTILS_API bool remove_directory(const QString &folderPath, const bool &recursive);

     MUTILS_API QString& trim_right(QString &str);

     MUTILS_API QString& trim_left(QString &str);

     MUTILS_API QString trim_right(const QString &str);

     MUTILS_API QString trim_left(const QString &str);

     MUTILS_API void natural_string_sort(QStringList &list, const bool bIgnoreCase);

     MUTILS_API QString clean_file_name(const QString &name, const bool &pretty);

     MUTILS_API QString clean_file_path(const QString &path, const bool &pretty);

     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 &value);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 &value);
     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 &value, const size_t &offset);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 &value, const size_t &offset);

     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 *values, const size_t &count);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 *values, const size_t &count);
     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 *values, const size_t &offset, const size_t &count);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 *values, const size_t &offset, const size_t &count);

     MUTILS_API QStringList available_codepages(const bool &noAliases = true);

     MUTILS_API fp_parts_t break_fp(const double value);

     //Internal
     namespace Internal
     {
         MUTILS_API int selfTest(const char *const buildKey, const bool debug);
         static const int s_selfTest = selfTest(__DATE__ "@" __TIME__, MUTILS_DEBUG);
     }
 }


 #define MUTILS_DELETE(PTR) do { if((PTR)) { delete (PTR); (PTR) = NULL; } } while(0)

 #define MUTILS_DELETE_ARRAY(PTR) do { if((PTR)) { delete [] (PTR); (PTR) = NULL; } } while(0)

 #define MUTILS_ZERO_MEMORY(PTR) memset(&(PTR), 0, sizeof((PTR)))

 #define MUTILS_WCHR(STR) (reinterpret_cast<const wchar_t*>((STR).utf16()))

 #define MUTILS_UTF8(STR) ((STR).toUtf8().constData())

 #define MUTILS_L1STR(STR) ((STR).toLatin1().constData())

 #define MUTILS_QSTR(STR) (QString::fromUtf16(reinterpret_cast<const unsigned short*>((STR))))

 #define MUTILS_BOOL2STR(X) ((X) ? "1" : "0")

 #define MUTILS_BOOLIFY(X) (!(!(X)))

 #define MUTILS_ARR2LEN(X) (sizeof((X)) / sizeof((X)[0]))

 #define MUTILS_NO_COPY(CLASS) \
     CLASS(const CLASS &) { throw "Copy constructor is disabled!"; } \
     CLASS &operator=(const CLASS &) { throw "Assignment operator is disabled!"; }
MUtils::available_codepages
MUTILS_API QStringList available_codepages(const bool &noAliases=true)
Retrieve a list of all available codepages.

-MUtils::fp_parts_t
struct MUtils::_fp_parts_t fp_parts_t
This struct containes the parts (integral and fractional part) of a floating-point number...

-MUtils::next_rand_str
MUTILS_API QString next_rand_str(const bool &bLong=false)
Generates a random string.

-MUtils::remove_file
MUTILS_API bool remove_file(const QString &fileName)
Deletes the specified file.

-MUtils::clean_file_path
MUTILS_API QString clean_file_path(const QString &path, const bool &pretty)
Clean up a file path string.

-MUtils::_fp_parts_t
This struct containes the parts (integral and fractional part) of a floating-point number...
Definition: Global.h:93

-MUtils::natural_string_sort
MUTILS_API void natural_string_sort(QStringList &list, const bool bIgnoreCase)
Sort a list of strings using "natural ordering" algorithm.

-MUtils::regexp_parse_uint32
MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 &value)
Parse regular expression results.

-MUtils::parity
MUTILS_API bool parity(quint32 value)
Computes the parity of the given unsigned 32-Bit value.

-MUtils::break_fp
MUTILS_API fp_parts_t break_fp(const double value)
Break floating-point number into fractional and integral parts.

-MUtils::next_rand_u64
MUTILS_API quint64 next_rand_u64(void)
Generates a random unsigned 64-Bit value.

-MUtils::trim_right
MUTILS_API QString & trim_right(QString &str)
Remove trailing white-space characters.

-MUtils::temp_folder
MUTILS_API const QString & temp_folder(void)
Rerieves the full path of the application&#39;s Temp folder.

-MUtils
Global MUtils namespace.
Definition: CPUFeatures.h:37

-MUtils::clean_file_name
MUTILS_API QString clean_file_name(const QString &name, const bool &pretty)
Clean up a file name string.

-MUtils::next_rand_u32
MUTILS_API quint32 next_rand_u32(void)
Generates a random unsigned 32-Bit value.

-MUtils::remove_directory
MUTILS_API bool remove_directory(const QString &folderPath, const bool &recursive)
Recursively deletes the specified directory.

-MUtils::make_temp_file
MUTILS_API QString make_temp_file(const QString &basePath, const QString &extension, const bool placeholder=false)
Generates a temporary file name.

-MUtils::init_process
MUTILS_API void init_process(QProcess &process, const QString &wokringDir, const bool bReplaceTempDir=true, const QStringList *const extraPaths=NULL, const QHash< QString, QString > *const extraEnv=NULL)
Initialize a given QProcess object.

-MUtils::trim_left
MUTILS_API QString & trim_left(QString &str)
Remove leading white-space characters.

-QHash
Definition: Global.h:34

-MUtils::make_unique_file
MUTILS_API QString make_unique_file(const QString &basePath, const QString &baseName, const QString &extension, const bool fancy=false, const bool placeholder=false)
Generates a unique file name.

-

-
-
-Generated by
-
- 1.8.12
-
-
-
+
+
+
+
+
+
+
+MuldeR's Utilities for Qt: include/MUtils/Global.h Source File
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+   MuldeR's Utilities for Qt
+

+   MUtilities

+

+

+
+
+
+
+
+
+

+
+
+

+
+
+
+
+
+

+
+
+
+include
MUtils

+

+

+
+
+Global.h


+

+
+Go to the documentation of this file. // MuldeR's Utilities for Qt
 // Copyright (C) 2004-2019 LoRd_MuldeR <MuldeR2@GMX.de>
 //
 // This library is free software; you can redistribute it and/or
 // modify it under the terms of the GNU Lesser General Public
 // License as published by the Free Software Foundation; either
 // version 2.1 of the License, or (at your option) any later version.
 //
 // This library is distributed in the hope that it will be useful,
 // but WITHOUT ANY WARRANTY; without even the implied warranty of
 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 // Lesser General Public License for more details.
 //
 // You should have received a copy of the GNU Lesser General Public
 // License along with this library; if not, write to the Free Software
 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 //
 // http://www.gnu.org/licenses/lgpl-2.1.txt

 #pragma once

 #include <QString>

 //Forward Declarations
 class QProcess;
 class QDir;
 template<typename K, typename V> class QHash;


  //Interface version
 #define MUTILS_INTERFACE 2

 //Build key
 #define MUTILS_BUILD_KEY_HELPER(X,Y) X##" "##Y
 #define MUTILS_BUILD_KEY MUTILS_BUILD_KEY_HELPER(__DATE__, __TIME__)

 //MUtils API
 #ifdef _MSC_VER
 #   ifdef MUTILS_DLL_EXPORT
 #       define MUTILS_API __declspec(dllexport)
 #   else
 #       ifndef MUTILS_STATIC_LIB
 #           define MUTILS_API __declspec(dllimport)
 #       else
 #           define MUTILS_API /*static lib*/
 #       endif
 #   endif
 #else
 #   define MUTILS_API
 #endif

 //Check Debug Flags
 #if defined(_DEBUG) || defined(DEBUG) || (!defined(NDEBUG))
 #   define MUTILS_DEBUG (1)
 #   if defined(NDEBUG) || defined(QT_NO_DEBUG) || (!defined(QT_DEBUG))
 #       error Inconsistent DEBUG flags have been detected!
 #   endif
 #else
 #   define MUTILS_DEBUG (0)
 #   if (!defined(NDEBUG)) || (!defined(QT_NO_DEBUG)) || defined(QT_DEBUG)
 #       error Inconsistent DEBUG flags have been detected!
 #   endif
 #endif

 //Check CPU options
 #if defined(_MSC_VER) && (!defined(__INTELLISENSE__)) && (!defined(_M_X64)) && defined(_M_IX86_FP)
     #if (_M_IX86_FP != 0)
         #error We should not enabled SSE or SSE2 in release builds!
     #endif
 #endif

 #define MUTILS_MAKE_STRING_HELPER(X) #X
 #define MUTILS_MAKE_STRING(X) MUTILS_MAKE_STRING_HELPER(X)
 #define MUTILS_COMPILER_WARNING(TXT) __pragma(message(__FILE__ "(" MUTILS_MAKE_STRING(__LINE__) ") : warning: " TXT))

 #define MUTILS_INIT_GLUE_HELPER(X,Y) X##Y
 #define MUTILS_INIT_GLUE(X,Y) MUTILS_INIT_GLUE_HELPER(X,Y)
 #define MUTILS_INITIALIZER MUTILS_INIT_GLUE(initialize_, MUTILS_INTERFACE)


 namespace MUtils
 {
     typedef struct _fp_parts_t { double parts[2]; } fp_parts_t;

     MUTILS_API const QString& temp_folder(void);

     MUTILS_API void init_process(QProcess &process, const QString &wokringDir, const bool bReplaceTempDir = true, const QStringList *const extraPaths = NULL, const QHash<QString, QString> *const extraEnv = NULL);

     MUTILS_API quint32 next_rand_u32(void);
     MUTILS_API quint32 next_rand_u32(const quint32 max);

     MUTILS_API quint64 next_rand_u64(void);

     MUTILS_API QString next_rand_str(const bool &bLong = false);

     MUTILS_API QString make_temp_file(const QString &basePath, const QString &extension, const bool placeholder = false);
     MUTILS_API QString make_temp_file(const QDir    &basePath, const QString &extension, const bool placeholder = false);

     MUTILS_API QString make_unique_file(const QString &basePath, const QString &baseName, const QString &extension, const bool fancy = false, const bool placeholder = false);
     MUTILS_API QString make_unique_file(const QDir    &basePath, const QString &baseName, const QString &extension, const bool fancy = false, const bool placeholder = false);

     MUTILS_API bool parity(quint32 value);

     MUTILS_API bool remove_file(const QString &fileName);

     MUTILS_API bool remove_directory(const QString &folderPath, const bool &recursive);

     MUTILS_API QString& trim_right(QString &str);

     MUTILS_API QString& trim_left(QString &str);

     MUTILS_API QString trim_right(const QString &str);

     MUTILS_API QString trim_left(const QString &str);

     MUTILS_API void natural_string_sort(QStringList &list, const bool bIgnoreCase);

     MUTILS_API QString clean_file_name(const QString &name, const bool &pretty);

     MUTILS_API QString clean_file_path(const QString &path, const bool &pretty);

     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 &value);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 &value);
     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 &value, const size_t &offset);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 &value, const size_t &offset);

     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 *values, const size_t &count);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 *values, const size_t &count);
     MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 *values, const size_t &offset, const size_t &count);
     MUTILS_API bool regexp_parse_int32(const QRegExp &regexp, qint32 *values, const size_t &offset, const size_t &count);

     MUTILS_API QStringList available_codepages(const bool &noAliases = true);

     MUTILS_API fp_parts_t break_fp(const double value);

     //Internal
     namespace Internal
     {
         MUTILS_API int MUTILS_INITIALIZER(const char *const buildKey, const bool debug);
         static const int s_initializedFlag = MUTILS_INITIALIZER(MUTILS_BUILD_KEY, MUTILS_DEBUG);
     }
 }


 #define MUTILS_DELETE(PTR) do { if((PTR)) { delete (PTR); (PTR) = NULL; } } while(0)

 #define MUTILS_DELETE_ARRAY(PTR) do { if((PTR)) { delete [] (PTR); (PTR) = NULL; } } while(0)

 #define MUTILS_ZERO_MEMORY(PTR) memset(&(PTR), 0, sizeof((PTR)))

 #define MUTILS_WCHR(STR) (reinterpret_cast<const wchar_t*>((STR).utf16()))

 #define MUTILS_UTF8(STR) ((STR).toUtf8().constData())

 #define MUTILS_L1STR(STR) ((STR).toLatin1().constData())

 #define MUTILS_QSTR(STR) (QString::fromUtf16(reinterpret_cast<const unsigned short*>((STR))))

 #define MUTILS_BOOL2STR(X) ((X) ? "1" : "0")

 #define MUTILS_BOOLIFY(X) (!(!(X)))

 #define MUTILS_ARR2LEN(X) (sizeof((X)) / sizeof((X)[0]))

 #define MUTILS_NO_COPY(CLASS) \
     CLASS(const CLASS &) { throw "Copy constructor is disabled!"; } \
     CLASS &operator=(const CLASS &) { throw "Assignment operator is disabled!"; }
MUtils::available_codepages
MUTILS_API QStringList available_codepages(const bool &noAliases=true)
Retrieve a list of all available codepages.

+MUtils::fp_parts_t
struct MUtils::_fp_parts_t fp_parts_t
This struct containes the parts (integral and fractional part) of a floating-point number...

+MUtils::next_rand_str
MUTILS_API QString next_rand_str(const bool &bLong=false)
Generates a random string.

+MUtils::remove_file
MUTILS_API bool remove_file(const QString &fileName)
Deletes the specified file.

+MUtils::clean_file_path
MUTILS_API QString clean_file_path(const QString &path, const bool &pretty)
Clean up a file path string.

+MUtils::_fp_parts_t
This struct containes the parts (integral and fractional part) of a floating-point number...
Definition: Global.h:104

+MUtils::natural_string_sort
MUTILS_API void natural_string_sort(QStringList &list, const bool bIgnoreCase)
Sort a list of strings using "natural ordering" algorithm.

+MUtils::regexp_parse_uint32
MUTILS_API bool regexp_parse_uint32(const QRegExp &regexp, quint32 &value)
Parse regular expression results.

+MUtils::parity
MUTILS_API bool parity(quint32 value)
Computes the parity of the given unsigned 32-Bit value.

+MUtils::break_fp
MUTILS_API fp_parts_t break_fp(const double value)
Break floating-point number into fractional and integral parts.

+MUtils::next_rand_u64
MUTILS_API quint64 next_rand_u64(void)
Generates a random unsigned 64-Bit value.

+MUtils::trim_right
MUTILS_API QString & trim_right(QString &str)
Remove trailing white-space characters.

+MUtils::temp_folder
MUTILS_API const QString & temp_folder(void)
Rerieves the full path of the application&#39;s Temp folder.

+MUtils
Global MUtils namespace.
Definition: CPUFeatures.h:37

+MUtils::clean_file_name
MUTILS_API QString clean_file_name(const QString &name, const bool &pretty)
Clean up a file name string.

+MUtils::next_rand_u32
MUTILS_API quint32 next_rand_u32(void)
Generates a random unsigned 32-Bit value.

+MUtils::remove_directory
MUTILS_API bool remove_directory(const QString &folderPath, const bool &recursive)
Recursively deletes the specified directory.

+MUtils::make_temp_file
MUTILS_API QString make_temp_file(const QString &basePath, const QString &extension, const bool placeholder=false)
Generates a temporary file name.

+MUtils::init_process
MUTILS_API void init_process(QProcess &process, const QString &wokringDir, const bool bReplaceTempDir=true, const QStringList *const extraPaths=NULL, const QHash< QString, QString > *const extraEnv=NULL)
Initialize a given QProcess object.

+MUtils::trim_left
MUTILS_API QString & trim_left(QString &str)
Remove leading white-space characters.

+QHash
Definition: Global.h:34

+MUtils::make_unique_file
MUTILS_API QString make_unique_file(const QString &basePath, const QString &baseName, const QString &extension, const bool fancy=false, const bool placeholder=false)
Generates a unique file name.

+

+
+
+Generated by
+
+ 1.8.12
+
+
+
diff --git a/include/MUtils/Global.h b/include/MUtils/Global.h
index 48ea302..c56d8f1 100644
--- a/include/MUtils/Global.h
+++ b/include/MUtils/Global.h
@@ -38,6 +38,13 @@ template class QHash;
 /** \cond INTERNAL
  */

+ //Interface version
+#define MUTILS_INTERFACE 2
+
+//Build key
+#define MUTILS_BUILD_KEY_HELPER(X,Y) X##" "##Y
+#define MUTILS_BUILD_KEY MUTILS_BUILD_KEY_HELPER(__DATE__, __TIME__)
+
 //MUtils API
 #ifdef _MSC_VER
 #	ifdef MUTILS_DLL_EXPORT
@@ -53,10 +60,6 @@ template class QHash;
 #	define MUTILS_API
 #endif

-#define MUTILS_MAKE_STRING_HELPER(X) #X
-#define MUTILS_MAKE_STRING(X) MUTILS_MAKE_STRING_HELPER(X)
-#define MUTILS_COMPILER_WARNING(TXT) __pragma(message(__FILE__ "(" MUTILS_MAKE_STRING(__LINE__) ") : warning: " TXT))
-
 //Check Debug Flags
 #if defined(_DEBUG) || defined(DEBUG) || (!defined(NDEBUG))
 #	define MUTILS_DEBUG (1)
@@ -77,6 +80,14 @@ template class QHash;
 	#endif
 #endif

+#define MUTILS_MAKE_STRING_HELPER(X) #X
+#define MUTILS_MAKE_STRING(X) MUTILS_MAKE_STRING_HELPER(X)
+#define MUTILS_COMPILER_WARNING(TXT) __pragma(message(__FILE__ "(" MUTILS_MAKE_STRING(__LINE__) ") : warning: " TXT))
+
+#define MUTILS_INIT_GLUE_HELPER(X,Y) X##Y
+#define MUTILS_INIT_GLUE(X,Y) MUTILS_INIT_GLUE_HELPER(X,Y)
+#define MUTILS_INITIALIZER MUTILS_INIT_GLUE(initialize_, MUTILS_INTERFACE)
+
 /** \endcond INTERNAL
  */

@@ -353,8 +364,8 @@ namespace MUtils
 	//Internal
 	namespace Internal
 	{
-		MUTILS_API int selfTest(const char *const buildKey, const bool debug);
-		static const int s_selfTest = selfTest(__DATE__ "@" __TIME__, MUTILS_DEBUG);
+		MUTILS_API int MUTILS_INITIALIZER(const char *const buildKey, const bool debug);
+		static const int s_initializedFlag = MUTILS_INITIALIZER(MUTILS_BUILD_KEY, MUTILS_DEBUG);
 	}
 }

diff --git a/src/Global.cpp b/src/Global.cpp
index 056d213..da1dc7d 100644
--- a/src/Global.cpp
+++ b/src/Global.cpp
@@ -902,19 +902,20 @@ MUtils::fp_parts_t MUtils::break_fp(const double value)
 }

 ///////////////////////////////////////////////////////////////////////////////
-// SELF-TEST
+// INITIALIZER
 ///////////////////////////////////////////////////////////////////////////////

-int MUtils::Internal::selfTest(const char *const buildKey, const bool debug)
+int MUtils::Internal::MUTILS_INITIALIZER(const char *const buildKey, const bool debug)
 {
-	static const bool MY_DEBUG_FLAG = MUTILS_DEBUG;
-	static const char *const MY_BUILD_KEY = __DATE__ "@" __TIME__;
+	static const bool INTERNAL_DEBUG_FLAG = MUTILS_DEBUG;
+	static const char *const INTERNAL_BUILD_KEY = MUTILS_BUILD_KEY;

-	if(strncmp(buildKey, MY_BUILD_KEY, 13) || (MY_DEBUG_FLAG != debug))
+	if((debug != INTERNAL_DEBUG_FLAG) || strncmp(buildKey, INTERNAL_BUILD_KEY, 11))
 	{
-		MUtils::OS::system_message_err(L"MUtils", L"FATAL ERROR: MUtils library version mismatch detected!");
-		MUtils::OS::system_message_wrn(L"MUtils", L"Perform a clean(!) re-install of the application to fix the problem!");
+		MUtils::OS::system_message_err(L"MUtils", L"FATAL ERROR: MUtils library initialization has failed");
 		abort();
 	}
-	return 0;
+
+	volatile int _result = MUTILS_INTERFACE;
+	return _result;
 }
--
2.11.4.GIT