<nav id="TOC">
<ul>
<li><a href="#introduction"><span class="toc-section-number">1</span> Introduction</a></li>
-<li><a href="#license"><span class="toc-section-number">2</span> License</a></li>
-<li><a href="#acknowledgement"><span class="toc-section-number">3</span> Acknowledgement</a></li>
+<li><a href="#project-structure"><span class="toc-section-number">2</span> Project Structure</a></li>
+<li><a href="#api-documentation"><span class="toc-section-number">3</span> API Documentation</a></li>
+<li><a href="#license"><span class="toc-section-number">4</span> License</a></li>
+<li><a href="#acknowledgement"><span class="toc-section-number">5</span> Acknowledgement</a></li>
</ul>
</nav>
<h1 id="introduction"><span class="header-section-number">1</span> Introduction</h1>
<p>The <strong>MUtilities</strong> library is a collection of routines and classes to extend the <a href="http://qt-project.org/"><em>Qt cross-platform framework</em></a>. It contains various convenience and utility functions as well as wrappers for OS-specific functionalities. The library was originally created as a "side product" of the <a href="http://lamexp.sourceforge.net/"><strong>LameXP</strong></a> application: Over the years, a lot of code, <strong>not</strong> really specific to <em>LameXP</em>, had accumulated in the <em>LameXP</em> code base. Some of that code even had been used in other projects too, in a "copy & paste" fashion – which had lead to redundancy and much complicated maintenance. In order to clean-up the LameXP code base, to eliminate the ugly redundancy and to simplify maintenance, the code in question has finally been refactored into the <strong>MUtilities</strong> (aka "MuldeR's Utilities for Qt") library. This library now forms the foundation of <em>LameXP</em> and <a href="https://github.com/lordmulder"><em>other OpenSource projects</em></a>.</p>
-<h1 id="license"><span class="header-section-number">2</span> License</h1>
+<h1 id="project-structure"><span class="header-section-number">2</span> Project Structure</h1>
+<p>The <em>MUtilities</em> project directory is structured as follows:</p>
+<ul>
+<li><code>bin/</code> – compiled library files (static or shared), link those files in projects that use the MUtilities library</li>
+<li><code>docs/</code> – programming interface documentation, generated with Doxygen tool</li>
+<li><code>etc/</code> – miscellaneous files, everything that doesn't fit in anywhere else</li>
+<li><code>include/</code> – public header files, include this directory in projects that use the MUtilities library</li>
+<li><code>obj/</code> – object code files, intermediate files generated during the build process</li>
+<li><code>res/</code> – resouce files, required for building the MUtilities library</li>
+<li><code>src/</code> – source code files, required for building the MUtilities library (third-party code in <code>src/3rd_party/</code>)</li>
+<li><code>test/</code> – unit tests, based on Google Test framework</li>
+<li><code>tmp/</code> – temporary files, automatically generated during the build process</li>
+</ul>
+<h1 id="api-documentation"><span class="header-section-number">3</span> API Documentation</h1>
+<p>A fully-fledged documentation of the <em>MUtilities</em> programming interface (API) is available thanks to <a href="http://www.stack.nl/~dimitri/doxygen/"><em>Doxygen</em></a>. Please see <a href="docs/index.html"><strong><code>docs/index.html</code></strong></a> for details!</p>
+<h1 id="license"><span class="header-section-number">4</span> License</h1>
<p>This library is free software. It is released under the terms of the <a href="https://www.gnu.org/licenses/lgpl-2.1.html"><em>GNU Lesser General Public License (LGPL), Version 2.1</em></a>.</p>
<pre><code>MUtilities - MuldeR's Utilities for Qt
Copyright (C) 2004-2016 LoRd_MuldeR <MuldeR2@GMX.de>. Some rights reserved.
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.</code></pre>
-<h1 id="acknowledgement"><span class="header-section-number">3</span> Acknowledgement</h1>
+<h1 id="acknowledgement"><span class="header-section-number">5</span> Acknowledgement</h1>
<p>The following third-party code is used in the MUtilities library:</p>
<ul>
<li><p><strong>Keccak/SHA-3 Reference Implementation</strong><br />
The **MUtilities** library is a collection of routines and classes to extend the [*Qt cross-platform framework*](http://qt-project.org/). It contains various convenience and utility functions as well as wrappers for OS-specific functionalities. The library was originally created as a "side product" of the [**LameXP**](http://lamexp.sourceforge.net/) application: Over the years, a lot of code, **not** really specific to *LameXP*, had accumulated in the *LameXP* code base. Some of that code even had been used in other projects too, in a "copy & paste" fashion – which had lead to redundancy and much complicated maintenance. In order to clean-up the LameXP code base, to eliminate the ugly redundancy and to simplify maintenance, the code in question has finally been refactored into the **MUtilities** (aka "MuldeR's Utilities for Qt") library. This library now forms the foundation of *LameXP* and [*other OpenSource projects*](https://github.com/lordmulder).
+# Project Structure
+
+The *MUtilities* project directory is structured as follows:
+
+* `bin/` – compiled library files (static or shared), link those files in projects that use the MUtilities library
+* `docs/` – programming interface documentation, generated with Doxygen tool
+* `etc/` – miscellaneous files, everything that doesn't fit in anywhere else
+* `include/` – public header files, include this directory in projects that use the MUtilities library
+* `obj/` – object code files, intermediate files generated during the build process
+* `res/` – resouce files, required for building the MUtilities library
+* `src/` – source code files, required for building the MUtilities library (third-party code in `src/3rd_party/`)
+* `test/` – unit tests, based on Google Test framework
+* `tmp/` – temporary files, automatically generated during the build process
+
+
+# API Documentation
+
+A fully-fledged documentation of the *MUtilities* programming interface (API) is available thanks to [*Doxygen*](http://www.stack.nl/~dimitri/doxygen/). Please see [**`docs/index.html`**](docs/index.html) for details!
+
+
# License
This library is free software. It is released under the terms of the [*GNU Lesser General Public License (LGPL), Version 2.1*](https://www.gnu.org/licenses/lgpl-2.1.html).
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</table></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="comment">// MuldeR's Utilities for Qt</span></div><div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="comment">// Copyright (C) 2004-2016 LoRd_MuldeR <MuldeR2@GMX.de></span></div><div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">//</span></div><div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">// This library is free software; you can redistribute it and/or</span></div><div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment">// modify it under the terms of the GNU Lesser General Public</span></div><div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">// License as published by the Free Software Foundation; either</span></div><div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">// version 2.1 of the License, or (at your option) any later version.</span></div><div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">//</span></div><div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">// This library is distributed in the hope that it will be useful,</span></div><div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">// but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div><div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div><div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">// Lesser General Public License for more details.</span></div><div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">//</span></div><div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">// You should have received a copy of the GNU Lesser General Public</span></div><div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment">// License along with this library; if not, write to the Free Software</span></div><div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment">// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA</span></div><div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment">//</span></div><div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment">// http://www.gnu.org/licenses/lgpl-2.1.txt</span></div><div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment"></span></div><div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="preprocessor">#pragma once</span></div><div class="line"><a name="l00023"></a><span class="lineno"> 23</span> </div><div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="preprocessor">#include <stdexcept></span></div><div class="line"><a name="l00025"></a><span class="lineno"> 25</span> </div><div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="preprocessor">#define MUTILS_PRINT_ERROR(FORMAT, ...) do \</span></div><div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="preprocessor">{ \</span></div><div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="preprocessor"> fflush(stdout); \</span></div><div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="preprocessor"> fprintf(stderr, (FORMAT), __VA_ARGS__); \</span></div><div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="preprocessor"> fflush(stderr); \</span></div><div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="preprocessor">} \</span></div><div class="line"><a name="l00032"></a><span class="lineno"> 32</span> <span class="preprocessor">while(0)</span></div><div class="line"><a name="l00033"></a><span class="lineno"> 33</span> </div><div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#define MUTILS_EXCEPTION_HANDLER(COMMAND) do \</span></div><div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor">{ \</span></div><div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor"> try \</span></div><div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor"> { \</span></div><div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor"> do { COMMAND; } while(0); \</span></div><div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor"> } \</span></div><div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="preprocessor"> catch(const std::exception &error) \</span></div><div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="preprocessor"> { \</span></div><div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="preprocessor"> MUTILS_PRINT_ERROR("\nGURU MEDITATION !!!\n\nException error:\n%s\n", error.what()); \</span></div><div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="preprocessor"> MUtils::OS::fatal_exit(L"Unhandeled C++ exception error, application will exit!"); \</span></div><div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="preprocessor"> } \</span></div><div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="preprocessor"> catch(...) \</span></div><div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="preprocessor"> { \</span></div><div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="preprocessor"> MUTILS_PRINT_ERROR("\nGURU MEDITATION !!!\n\nUnknown exception error!\n"); \</span></div><div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="preprocessor"> MUtils::OS::fatal_exit(L"Unhandeled C++ exception error, application will exit!"); \</span></div><div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="preprocessor"> } \</span></div><div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="preprocessor">} \</span></div><div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="preprocessor">while(0)</span></div><div class="line"><a name="l00052"></a><span class="lineno"> 52</span> </div><div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="preprocessor">#define MUTILS_THROW(MESSAGE) do \</span></div><div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="preprocessor">{ \</span></div><div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="preprocessor"> throw std::runtime_error((MESSAGE)); \</span></div><div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="preprocessor">} \</span></div><div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="preprocessor">while(0)</span></div><div class="line"><a name="l00058"></a><span class="lineno"> 58</span> </div><div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="preprocessor">#define MUTILS_THROW_FMT(MESSAGE, ...) do \</span></div><div class="line"><a name="l00060"></a><span class="lineno"> 60</span> <span class="preprocessor">{ \</span></div><div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="preprocessor"> char _message[256]; \</span></div><div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="preprocessor"> _snprintf_s(_message, 256, _TRUNCATE, (MESSAGE), __VA_ARGS__); \</span></div><div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="preprocessor"> throw std::runtime_error(_message); \</span></div><div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="preprocessor">} \</span></div><div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="preprocessor">while(0)</span></div></div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:27 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:13 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="../../doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:15 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:15 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>
<div class="fragment"><div class="line">MUtilities - MuldeR<span class="stringliteral">'s Utilities for Qt</span></div><div class="line"><span class="stringliteral">Copyright (C) 2004-2016 LoRd_MuldeR <MuldeR2@GMX.de>. Some rights reserved.</span></div><div class="line"><span class="stringliteral"></span></div><div class="line"><span class="stringliteral">This library is free software; you can redistribute it and/or</span></div><div class="line"><span class="stringliteral">modify it under the terms of the GNU Lesser General Public</span></div><div class="line"><span class="stringliteral">License as published by the Free Software Foundation; either</span></div><div class="line"><span class="stringliteral">version 2.1 of the License, or (at your option) any later version.</span></div><div class="line"><span class="stringliteral"></span></div><div class="line"><span class="stringliteral">This library is distributed in the hope that it will be useful,</span></div><div class="line"><span class="stringliteral">but WITHOUT ANY WARRANTY; without even the implied warranty of</span></div><div class="line"><span class="stringliteral">MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span></div><div class="line"><span class="stringliteral">Lesser General Public License for more details.</span></div><div class="line"><span class="stringliteral"></span></div><div class="line"><span class="stringliteral">You should have received a copy of the GNU Lesser General Public</span></div><div class="line"><span class="stringliteral">License along with this library; if not, write to the Free Software</span></div><div class="line"><span class="stringliteral">Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</span></div></div><!-- fragment --> </div></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
-Generated on Mon Dec 19 2016 01:56:28 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
+Generated on Mon Dec 19 2016 02:43:14 for MuldeR's Utilities for Qt by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.12
</small></address>