70 <a href=
"../../d5/d3b/_global_8h.html">Go to the documentation of this file.
</a><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=
"l00027"></a><span class=
"lineno"> 27</span> <span class=
"preprocessor">#pragma once
</span></div><div class=
"line"><a name=
"l00028"></a><span class=
"lineno"> 28</span> </div><div class=
"line"><a name=
"l00029"></a><span class=
"lineno"> 29</span> <span class=
"preprocessor">#include
<QString
></span></div><div class=
"line"><a name=
"l00030"></a><span class=
"lineno"> 30</span> </div><div class=
"line"><a name=
"l00031"></a><span class=
"lineno"> 31</span> <span class=
"comment">//Forward Declarations
</span></div><div class=
"line"><a name=
"l00032"></a><span class=
"lineno"> 32</span> <span class=
"keyword">class
</span>QProcess;
</div><div class=
"line"><a name=
"l00033"></a><span class=
"lineno"> 33</span> </div><div class=
"line"><a name=
"l00035"></a><span class=
"lineno"> 35</span> </div><div class=
"line"><a name=
"l00036"></a><span class=
"lineno"> 36</span> <span class=
"comment">//MUtils API
</span></div><div class=
"line"><a name=
"l00037"></a><span class=
"lineno"> 37</span> <span class=
"preprocessor">#ifdef _MSC_VER
</span></div><div class=
"line"><a name=
"l00038"></a><span class=
"lineno"> 38</span> <span class=
"preprocessor"># ifdef MUTILS_DLL_EXPORT
</span></div><div class=
"line"><a name=
"l00039"></a><span class=
"lineno"> 39</span> <span class=
"preprocessor"># define MUTILS_API __declspec(dllexport)
</span></div><div class=
"line"><a name=
"l00040"></a><span class=
"lineno"> 40</span> <span class=
"preprocessor"># else
</span></div><div class=
"line"><a name=
"l00041"></a><span class=
"lineno"> 41</span> <span class=
"preprocessor"># ifndef MUTILS_STATIC_LIB
</span></div><div class=
"line"><a name=
"l00042"></a><span class=
"lineno"> 42</span> <span class=
"preprocessor"># define MUTILS_API __declspec(dllimport)
</span></div><div class=
"line"><a name=
"l00043"></a><span class=
"lineno"> 43</span> <span class=
"preprocessor"># else
</span></div><div class=
"line"><a name=
"l00044"></a><span class=
"lineno"> 44</span> <span class=
"preprocessor"># define MUTILS_API
</span><span class=
"comment">/*static lib*/
</span><span class=
"preprocessor"></span></div><div class=
"line"><a name=
"l00045"></a><span class=
"lineno"> 45</span> <span class=
"preprocessor"># endif
</span></div><div class=
"line"><a name=
"l00046"></a><span class=
"lineno"> 46</span> <span class=
"preprocessor"># endif
</span></div><div class=
"line"><a name=
"l00047"></a><span class=
"lineno"> 47</span> <span class=
"preprocessor">#else
</span></div><div class=
"line"><a name=
"l00048"></a><span class=
"lineno"> 48</span> <span class=
"preprocessor"># define MUTILS_API
</span></div><div class=
"line"><a name=
"l00049"></a><span class=
"lineno"> 49</span> <span class=
"preprocessor">#endif
</span></div><div class=
"line"><a name=
"l00050"></a><span class=
"lineno"> 50</span> </div><div class=
"line"><a name=
"l00051"></a><span class=
"lineno"> 51</span> <span class=
"comment">//Helper Macros
</span></div><div class=
"line"><a name=
"l00052"></a><span class=
"lineno"> 52</span> <span class=
"preprocessor">#define MUTILS_MAKE_STRING_HELPER(X) #X
</span></div><div class=
"line"><a name=
"l00053"></a><span class=
"lineno"> 53</span> <span class=
"preprocessor">#define MUTILS_MAKE_STRING(X) MUTILS_MAKE_STRING_HELPER(X)
</span></div><div class=
"line"><a name=
"l00054"></a><span class=
"lineno"> 54</span> <span class=
"preprocessor">#define MUTILS_COMPILER_WARNING(TXT) __pragma(message(__FILE__
"(
" MUTILS_MAKE_STRING(__LINE__)
") : warning:
" TXT))
</span></div><div class=
"line"><a name=
"l00055"></a><span class=
"lineno"> 55</span> </div><div class=
"line"><a name=
"l00056"></a><span class=
"lineno"> 56</span> <span class=
"comment">//Check Debug Flags
</span></div><div class=
"line"><a name=
"l00057"></a><span class=
"lineno"> 57</span> <span class=
"preprocessor">#if defined(_DEBUG) || defined(DEBUG) || (!defined(NDEBUG))
</span></div><div class=
"line"><a name=
"l00058"></a><span class=
"lineno"> 58</span> <span class=
"preprocessor"># define MUTILS_DEBUG (
1)
</span></div><div class=
"line"><a name=
"l00059"></a><span class=
"lineno"> 59</span> <span class=
"preprocessor"># if defined(NDEBUG) || defined(QT_NO_DEBUG) || (!defined(QT_DEBUG))
</span></div><div class=
"line"><a name=
"l00060"></a><span class=
"lineno"> 60</span> <span class=
"preprocessor"># error Inconsistent DEBUG flags have been detected!
</span></div><div class=
"line"><a name=
"l00061"></a><span class=
"lineno"> 61</span> <span class=
"preprocessor"># endif
</span></div><div class=
"line"><a name=
"l00062"></a><span class=
"lineno"> 62</span> <span class=
"preprocessor">#else
</span></div><div class=
"line"><a name=
"l00063"></a><span class=
"lineno"> 63</span> <span class=
"preprocessor"># define MUTILS_DEBUG (
0)
</span></div><div class=
"line"><a name=
"l00064"></a><span class=
"lineno"> 64</span> <span class=
"preprocessor"># if (!defined(NDEBUG)) || (!defined(QT_NO_DEBUG)) || defined(QT_DEBUG)
</span></div><div class=
"line"><a name=
"l00065"></a><span class=
"lineno"> 65</span> <span class=
"preprocessor"># error Inconsistent DEBUG flags have been detected!
</span></div><div class=
"line"><a name=
"l00066"></a><span class=
"lineno"> 66</span> <span class=
"preprocessor"># endif
</span></div><div class=
"line"><a name=
"l00067"></a><span class=
"lineno"> 67</span> <span class=
"preprocessor">#endif
</span></div><div class=
"line"><a name=
"l00068"></a><span class=
"lineno"> 68</span> </div><div class=
"line"><a name=
"l00069"></a><span class=
"lineno"> 69</span> <span class=
"comment">//Check CPU options
</span></div><div class=
"line"><a name=
"l00070"></a><span class=
"lineno"> 70</span> <span class=
"preprocessor">#if defined(_MSC_VER)
&& (!defined(__INTELLISENSE__))
&& (!defined(_M_X64))
&& defined(_M_IX86_FP)
</span></div><div class=
"line"><a name=
"l00071"></a><span class=
"lineno"> 71</span> <span class=
"preprocessor"> #if (_M_IX86_FP !=
0)
</span></div><div class=
"line"><a name=
"l00072"></a><span class=
"lineno"> 72</span> <span class=
"preprocessor"> #error We should not enabled SSE or SSE2 in release builds!
</span></div><div class=
"line"><a name=
"l00073"></a><span class=
"lineno"> 73</span> <span class=
"preprocessor"> #endif
</span></div><div class=
"line"><a name=
"l00074"></a><span class=
"lineno"> 74</span> <span class=
"preprocessor">#endif
</span></div><div class=
"line"><a name=
"l00075"></a><span class=
"lineno"> 75</span> </div><div class=
"line"><a name=
"l00077"></a><span class=
"lineno"> 77</span> </div><div class=
"line"><a name=
"l00114"></a><span class=
"lineno"> 114</span> <span class=
"keyword">namespace
</span><a class=
"code" href=
"../../d3/da6/namespace_m_utils.html">MUtils
</a></div><div class=
"line"><a name=
"l00115"></a><span class=
"lineno"> 115</span> {
</div><div class=
"line"><a name=
"l00123"></a><span class=
"lineno"> 123</span>  MUTILS_API
<span class=
"keyword">const
</span> QString
& <a class=
"code" href=
"../../d5/d3b/_global_8h.html#a9ddb9a2039585b1ef3429db16ea84292">temp_folder
</a>(
<span class=
"keywordtype">void
</span>);
</div><div class=
"line"><a name=
"l00124"></a><span class=
"lineno"> 124</span> </div><div class=
"line"><a name=
"l00125"></a><span class=
"lineno"> 125</span>  <span class=
"comment">//Process Utils
</span></div><div class=
"line"><a name=
"l00126"></a><span class=
"lineno"> 126</span>  MUTILS_API
<span class=
"keywordtype">void
</span> init_process(QProcess
&process,
<span class=
"keyword">const
</span> QString
&wokringDir,
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> bReplaceTempDir =
<span class=
"keyword">true
</span>,
<span class=
"keyword">const
</span> QStringList *
<span class=
"keyword">const
</span> extraPaths = NULL);
</div><div class=
"line"><a name=
"l00127"></a><span class=
"lineno"> 127</span> </div><div class=
"line"><a name=
"l00135"></a><span class=
"lineno"> 135</span>  MUTILS_API quint32
<a class=
"code" href=
"../../d5/d3b/_global_8h.html#a4dc7dccb81653ae28e0d37a7c2f62112">next_rand_u32
</a>(
<span class=
"keywordtype">void
</span>);
</div><div class=
"line"><a name=
"l00136"></a><span class=
"lineno"> 136</span>  </div><div class=
"line"><a name=
"l00144"></a><span class=
"lineno"> 144</span>  MUTILS_API quint64
<a class=
"code" href=
"../../d5/d3b/_global_8h.html#a15762bf5b0239e5f67a3815d63ed441a">next_rand_u64
</a>(
<span class=
"keywordtype">void
</span>);
</div><div class=
"line"><a name=
"l00145"></a><span class=
"lineno"> 145</span>  </div><div class=
"line"><a name=
"l00155"></a><span class=
"lineno"> 155</span>  MUTILS_API QString
<a class=
"code" href=
"../../d5/d3b/_global_8h.html#a996b60884ddf7728178e94f34ca12570">next_rand_str
</a>(
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> &bLong =
<span class=
"keyword">false
</span>);
</div><div class=
"line"><a name=
"l00156"></a><span class=
"lineno"> 156</span> </div><div class=
"line"><a name=
"l00170"></a><span class=
"lineno"> 170</span>  MUTILS_API QString
<a class=
"code" href=
"../../d5/d3b/_global_8h.html#a67cb16c62b213da5135a6fa076f3f005">make_temp_file
</a>(
<span class=
"keyword">const
</span> QString
&basePath,
<span class=
"keyword">const
</span> QString
&extension,
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> placeholder =
<span class=
"keyword">false
</span>);
</div><div class=
"line"><a name=
"l00171"></a><span class=
"lineno"> 171</span> </div><div class=
"line"><a name=
"l00187"></a><span class=
"lineno"> 187</span>  MUTILS_API QString
<a class=
"code" href=
"../../d5/d3b/_global_8h.html#a390e56e35eb9329d2e67fa9741d07536">make_unique_file
</a>(
<span class=
"keyword">const
</span> QString
&basePath,
<span class=
"keyword">const
</span> QString
&baseName,
<span class=
"keyword">const
</span> QString
&extension,
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> fancy =
<span class=
"keyword">false
</span>);
</div><div class=
"line"><a name=
"l00188"></a><span class=
"lineno"> 188</span> </div><div class=
"line"><a name=
"l00196"></a><span class=
"lineno"> 196</span>  MUTILS_API
<span class=
"keywordtype">bool
</span> <a class=
"code" href=
"../../d5/d3b/_global_8h.html#ad1bdb5e416839b1f85f6df68e58ae28c">parity
</a>(quint32 value);
</div><div class=
"line"><a name=
"l00197"></a><span class=
"lineno"> 197</span> </div><div class=
"line"><a name=
"l00198"></a><span class=
"lineno"> 198</span>  <span class=
"comment">//Remove File/Dir
</span></div><div class=
"line"><a name=
"l00199"></a><span class=
"lineno"> 199</span>  MUTILS_API
<span class=
"keywordtype">bool
</span> remove_file(
<span class=
"keyword">const
</span> QString
&fileName);
</div><div class=
"line"><a name=
"l00200"></a><span class=
"lineno"> 200</span>  MUTILS_API
<span class=
"keywordtype">bool
</span> remove_directory(
<span class=
"keyword">const
</span> QString
&folderPath,
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> &recursive);
</div><div class=
"line"><a name=
"l00201"></a><span class=
"lineno"> 201</span> </div><div class=
"line"><a name=
"l00202"></a><span class=
"lineno"> 202</span>  <span class=
"comment">//String utils
</span></div><div class=
"line"><a name=
"l00203"></a><span class=
"lineno"> 203</span>  MUTILS_API QString
& trim_right(QString
&str);
</div><div class=
"line"><a name=
"l00204"></a><span class=
"lineno"> 204</span>  MUTILS_API QString
& trim_left(QString
&str);
</div><div class=
"line"><a name=
"l00205"></a><span class=
"lineno"> 205</span>  MUTILS_API QString trim_right(
<span class=
"keyword">const
</span> QString
&str);
</div><div class=
"line"><a name=
"l00206"></a><span class=
"lineno"> 206</span>  MUTILS_API QString trim_left(
<span class=
"keyword">const
</span> QString
&str);
</div><div class=
"line"><a name=
"l00207"></a><span class=
"lineno"> 207</span> </div><div class=
"line"><a name=
"l00208"></a><span class=
"lineno"> 208</span>  <span class=
"comment">//String sorting
</span></div><div class=
"line"><a name=
"l00209"></a><span class=
"lineno"> 209</span>  MUTILS_API
<span class=
"keywordtype">void
</span> natural_string_sort(QStringList
&list,
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> bIgnoreCase);
</div><div class=
"line"><a name=
"l00210"></a><span class=
"lineno"> 210</span> </div><div class=
"line"><a name=
"l00211"></a><span class=
"lineno"> 211</span>  <span class=
"comment">//Clean file path
</span></div><div class=
"line"><a name=
"l00212"></a><span class=
"lineno"> 212</span>  MUTILS_API QString clean_file_name(
<span class=
"keyword">const
</span> QString
&name);
</div><div class=
"line"><a name=
"l00213"></a><span class=
"lineno"> 213</span>  MUTILS_API QString clean_file_path(
<span class=
"keyword">const
</span> QString
&path);
</div><div class=
"line"><a name=
"l00214"></a><span class=
"lineno"> 214</span> </div><div class=
"line"><a name=
"l00215"></a><span class=
"lineno"> 215</span>  <span class=
"comment">//Regular expressions
</span></div><div class=
"line"><a name=
"l00216"></a><span class=
"lineno"> 216</span>  MUTILS_API
<span class=
"keywordtype">bool
</span> regexp_parse_uint32(
<span class=
"keyword">const
</span> QRegExp
&regexp, quint32
&value);
</div><div class=
"line"><a name=
"l00217"></a><span class=
"lineno"> 217</span>  MUTILS_API
<span class=
"keywordtype">bool
</span> regexp_parse_uint32(
<span class=
"keyword">const
</span> QRegExp
&regexp, quint32 *values,
<span class=
"keyword">const
</span> <span class=
"keywordtype">size_t
</span> &count);
</div><div class=
"line"><a name=
"l00218"></a><span class=
"lineno"> 218</span> </div><div class=
"line"><a name=
"l00219"></a><span class=
"lineno"> 219</span>  <span class=
"comment">//Internationalization
</span></div><div class=
"line"><a name=
"l00220"></a><span class=
"lineno"> 220</span>  MUTILS_API QStringList available_codepages(
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> &noAliases =
<span class=
"keyword">true
</span>);
</div><div class=
"line"><a name=
"l00221"></a><span class=
"lineno"> 221</span> </div><div class=
"line"><a name=
"l00222"></a><span class=
"lineno"> 222</span>  <span class=
"comment">//Internal
</span></div><div class=
"line"><a name=
"l00223"></a><span class=
"lineno"> 223</span>  <span class=
"keyword">namespace
</span>Internal
</div><div class=
"line"><a name=
"l00224"></a><span class=
"lineno"> 224</span>  {
</div><div class=
"line"><a name=
"l00225"></a><span class=
"lineno"> 225</span>  MUTILS_API
<span class=
"keywordtype">int
</span> selfTest(
<span class=
"keyword">const
</span> <span class=
"keywordtype">char
</span> *
<span class=
"keyword">const
</span> buildKey,
<span class=
"keyword">const
</span> <span class=
"keywordtype">bool
</span> debug);
</div><div class=
"line"><a name=
"l00226"></a><span class=
"lineno"> 226</span>  <span class=
"keyword">static
</span> <span class=
"keyword">const
</span> <span class=
"keywordtype">int
</span> s_selfTest = selfTest(__DATE__
<span class=
"stringliteral">"@
"</span> __TIME__, MUTILS_DEBUG);
</div><div class=
"line"><a name=
"l00227"></a><span class=
"lineno"> 227</span>  }
</div><div class=
"line"><a name=
"l00228"></a><span class=
"lineno"> 228</span> }
</div><div class=
"line"><a name=
"l00229"></a><span class=
"lineno"> 229</span> </div><div class=
"line"><a name=
"l00231"></a><span class=
"lineno"> 231</span> </div><div class=
"line"><a name=
"l00232"></a><span class=
"lineno"> 232</span> <span class=
"comment">//Delete helper
</span></div><div class=
"line"><a name=
"l00233"></a><span class=
"lineno"> 233</span> <span class=
"preprocessor">#define MUTILS_DELETE(PTR) do { if((PTR)) { delete (PTR); (PTR) = NULL; } } while(
0)
</span></div><div class=
"line"><a name=
"l00234"></a><span class=
"lineno"> 234</span> <span class=
"preprocessor">#define MUTILS_DELETE_ARRAY(PTR) do { if((PTR)) { delete [] (PTR); (PTR) = NULL; } } while(
0)
</span></div><div class=
"line"><a name=
"l00235"></a><span class=
"lineno"> 235</span> </div><div class=
"line"><a name=
"l00236"></a><span class=
"lineno"> 236</span> <span class=
"comment">//Zero memory
</span></div><div class=
"line"><a name=
"l00237"></a><span class=
"lineno"> 237</span> <span class=
"preprocessor">#define MUTILS_ZERO_MEMORY(PTR) memset(
&(PTR),
0, sizeof((PTR)))
</span></div><div class=
"line"><a name=
"l00238"></a><span class=
"lineno"> 238</span> </div><div class=
"line"><a name=
"l00239"></a><span class=
"lineno"> 239</span> <span class=
"comment">//String conversion macros
</span></div><div class=
"line"><a name=
"l00240"></a><span class=
"lineno"> 240</span> <span class=
"preprocessor">#define MUTILS_WCHR(STR) (reinterpret_cast
<const wchar_t*
>((STR).utf16()))
</span></div><div class=
"line"><a name=
"l00241"></a><span class=
"lineno"> 241</span> <span class=
"preprocessor">#define MUTILS_UTF8(STR) ((STR).toUtf8().constData())
</span></div><div class=
"line"><a name=
"l00242"></a><span class=
"lineno"> 242</span> <span class=
"preprocessor">#define MUTILS_QSTR(STR) (QString::fromUtf16(reinterpret_cast
<const unsigned short*
>((STR))))
</span></div><div class=
"line"><a name=
"l00243"></a><span class=
"lineno"> 243</span> </div><div class=
"line"><a name=
"l00244"></a><span class=
"lineno"> 244</span> <span class=
"comment">//Boolean helper
</span></div><div class=
"line"><a name=
"l00245"></a><span class=
"lineno"> 245</span> <span class=
"preprocessor">#define MUTILS_BOOL2STR(X) ((X) ?
"1" :
"0")
</span></div><div class=
"ttc" id=
"_global_8h_html_a4dc7dccb81653ae28e0d37a7c2f62112"><div class=
"ttname"><a href=
"../../d5/d3b/_global_8h.html#a4dc7dccb81653ae28e0d37a7c2f62112">MUtils::next_rand_u32
</a></div><div class=
"ttdeci">quint32 next_rand_u32(void)
</div><div class=
"ttdoc">Generates a random unsigned
32-Bit value.
</div></div>