2
0
mirror of https://github.com/boostorg/nowide.git synced 2026-02-15 13:12:21 +00:00
Files
nowide/doc/html/cenv_8hpp_source.html
Peter Dimov 36794503ce Add doc/html
2019-12-04 16:32:38 +02:00

176 lines
21 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.7"/>
<title>Boost.Nowide: boost/nowide/cenv.hpp Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Boost.Nowide
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.7 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main&#160;Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="files.html"><span>File&#160;List</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_c8984f1860c11f62f47abb6761e46c1e.html">boost</a></li><li class="navelem"><a class="el" href="dir_cba7cd329d8f45cf06543cd3b730d485.html">nowide</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle">
<div class="title">cenv.hpp</div> </div>
</div><!--header-->
<div class="contents">
<div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span>&#160;<span class="comment">//</span></div>
<div class="line"><a name="l00002"></a><span class="lineno"> 2</span>&#160;<span class="comment">// Copyright (c) 2012 Artyom Beilis (Tonkikh)</span></div>
<div class="line"><a name="l00003"></a><span class="lineno"> 3</span>&#160;<span class="comment">//</span></div>
<div class="line"><a name="l00004"></a><span class="lineno"> 4</span>&#160;<span class="comment">// Distributed under the Boost Software License, Version 1.0. (See</span></div>
<div class="line"><a name="l00005"></a><span class="lineno"> 5</span>&#160;<span class="comment">// accompanying file LICENSE_1_0.txt or copy at</span></div>
<div class="line"><a name="l00006"></a><span class="lineno"> 6</span>&#160;<span class="comment">// http://www.boost.org/LICENSE_1_0.txt)</span></div>
<div class="line"><a name="l00007"></a><span class="lineno"> 7</span>&#160;<span class="comment">//</span></div>
<div class="line"><a name="l00008"></a><span class="lineno"> 8</span>&#160;<span class="preprocessor">#ifndef BOOST_NOWIDE_CENV_H_INCLUDED</span></div>
<div class="line"><a name="l00009"></a><span class="lineno"> 9</span>&#160;<span class="preprocessor">#define BOOST_NOWIDE_CENV_H_INCLUDED</span></div>
<div class="line"><a name="l00010"></a><span class="lineno"> 10</span>&#160;</div>
<div class="line"><a name="l00011"></a><span class="lineno"> 11</span>&#160;<span class="preprocessor">#include &lt;string&gt;</span></div>
<div class="line"><a name="l00012"></a><span class="lineno"> 12</span>&#160;<span class="preprocessor">#include &lt;stdexcept&gt;</span></div>
<div class="line"><a name="l00013"></a><span class="lineno"> 13</span>&#160;<span class="preprocessor">#include &lt;stdlib.h&gt;</span></div>
<div class="line"><a name="l00014"></a><span class="lineno"> 14</span>&#160;<span class="preprocessor">#include &lt;boost/config.hpp&gt;</span></div>
<div class="line"><a name="l00015"></a><span class="lineno"> 15</span>&#160;<span class="preprocessor">#include &lt;boost/nowide/stackstring.hpp&gt;</span></div>
<div class="line"><a name="l00016"></a><span class="lineno"> 16</span>&#160;<span class="preprocessor">#include &lt;vector&gt;</span></div>
<div class="line"><a name="l00017"></a><span class="lineno"> 17</span>&#160;</div>
<div class="line"><a name="l00018"></a><span class="lineno"> 18</span>&#160;<span class="preprocessor">#ifdef BOOST_WINDOWS</span></div>
<div class="line"><a name="l00019"></a><span class="lineno"> 19</span>&#160;<span class="preprocessor">#include &lt;boost/nowide/windows.hpp&gt;</span></div>
<div class="line"><a name="l00020"></a><span class="lineno"> 20</span>&#160;<span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00021"></a><span class="lineno"> 21</span>&#160;</div>
<div class="line"><a name="l00022"></a><span class="lineno"> 22</span>&#160;<span class="keyword">namespace </span>boost {</div>
<div class="line"><a name="l00023"></a><span class="lineno"> 23</span>&#160;<span class="keyword">namespace </span>nowide {</div>
<div class="line"><a name="l00024"></a><span class="lineno"> 24</span>&#160;<span class="preprocessor"> #if !defined(BOOST_WINDOWS) &amp;&amp; !defined(BOOST_NOWIDE_DOXYGEN)</span></div>
<div class="line"><a name="l00025"></a><span class="lineno"> 25</span>&#160; using ::getenv;</div>
<div class="line"><a name="l00026"></a><span class="lineno"> 26</span>&#160; using ::setenv;</div>
<div class="line"><a name="l00027"></a><span class="lineno"> 27</span>&#160; using ::unsetenv;</div>
<div class="line"><a name="l00028"></a><span class="lineno"> 28</span>&#160; using ::putenv;</div>
<div class="line"><a name="l00029"></a><span class="lineno"> 29</span>&#160;<span class="preprocessor"> #else</span></div>
<div class="line"><a name="l00030"></a><span class="lineno"> 30</span>&#160; <span class="keyword">inline</span> <span class="keywordtype">char</span> *<a class="code" href="namespaceboost_1_1nowide.html#a6644397c539754076b11e95c535be192">getenv</a>(<span class="keywordtype">char</span> <span class="keyword">const</span> *key)</div>
<div class="line"><a name="l00036"></a><span class="lineno"> 36</span>&#160; {</div>
<div class="line"><a name="l00037"></a><span class="lineno"> 37</span>&#160; <span class="keyword">static</span> <a class="code" href="namespaceboost_1_1nowide.html#acd4c19d4e98ae3e50b08ef2ef5056a12">stackstring</a> value;</div>
<div class="line"><a name="l00038"></a><span class="lineno"> 38</span>&#160; </div>
<div class="line"><a name="l00039"></a><span class="lineno"> 39</span>&#160; <a class="code" href="namespaceboost_1_1nowide.html#a8369c10c0df6e36cd10cb9f9beb3149d">wshort_stackstring</a> name;</div>
<div class="line"><a name="l00040"></a><span class="lineno"> 40</span>&#160; <span class="keywordflow">if</span>(!name.convert(key))</div>
<div class="line"><a name="l00041"></a><span class="lineno"> 41</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00042"></a><span class="lineno"> 42</span>&#160;</div>
<div class="line"><a name="l00043"></a><span class="lineno"> 43</span>&#160; <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">size_t</span> buf_size = 64;</div>
<div class="line"><a name="l00044"></a><span class="lineno"> 44</span>&#160; <span class="keywordtype">wchar_t</span> buf[buf_size];</div>
<div class="line"><a name="l00045"></a><span class="lineno"> 45</span>&#160; std::vector&lt;wchar_t&gt; tmp;</div>
<div class="line"><a name="l00046"></a><span class="lineno"> 46</span>&#160; <span class="keywordtype">wchar_t</span> *ptr = buf;</div>
<div class="line"><a name="l00047"></a><span class="lineno"> 47</span>&#160; <span class="keywordtype">size_t</span> n = GetEnvironmentVariableW(name.c_str(),buf,buf_size);</div>
<div class="line"><a name="l00048"></a><span class="lineno"> 48</span>&#160; <span class="keywordflow">if</span>(n == 0 &amp;&amp; GetLastError() == 203) <span class="comment">// ERROR_ENVVAR_NOT_FOUND</span></div>
<div class="line"><a name="l00049"></a><span class="lineno"> 49</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00050"></a><span class="lineno"> 50</span>&#160; <span class="keywordflow">if</span>(n &gt;= buf_size) {</div>
<div class="line"><a name="l00051"></a><span class="lineno"> 51</span>&#160; tmp.resize(n+1,L<span class="charliteral">&#39;\0&#39;</span>);</div>
<div class="line"><a name="l00052"></a><span class="lineno"> 52</span>&#160; n = GetEnvironmentVariableW(name.c_str(),&amp;tmp[0],<span class="keyword">static_cast&lt;</span><span class="keywordtype">unsigned</span><span class="keyword">&gt;</span>(tmp.size() - 1));</div>
<div class="line"><a name="l00053"></a><span class="lineno"> 53</span>&#160; <span class="comment">// The size may have changed</span></div>
<div class="line"><a name="l00054"></a><span class="lineno"> 54</span>&#160; <span class="keywordflow">if</span>(n &gt;= tmp.size() - 1)</div>
<div class="line"><a name="l00055"></a><span class="lineno"> 55</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00056"></a><span class="lineno"> 56</span>&#160; ptr = &amp;tmp[0];</div>
<div class="line"><a name="l00057"></a><span class="lineno"> 57</span>&#160; }</div>
<div class="line"><a name="l00058"></a><span class="lineno"> 58</span>&#160; <span class="keywordflow">if</span>(!value.convert(ptr))</div>
<div class="line"><a name="l00059"></a><span class="lineno"> 59</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00060"></a><span class="lineno"> 60</span>&#160; <span class="keywordflow">return</span> value.c_str();</div>
<div class="line"><a name="l00061"></a><span class="lineno"> 61</span>&#160; }</div>
<div class="line"><a name="l00068"></a><span class="lineno"><a class="line" href="namespaceboost_1_1nowide.html#a19d4925ea2c77e0b2abd8f5d045a8af2"> 68</a></span>&#160; <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="namespaceboost_1_1nowide.html#a19d4925ea2c77e0b2abd8f5d045a8af2">setenv</a>(<span class="keywordtype">char</span> <span class="keyword">const</span> *key,<span class="keywordtype">char</span> <span class="keyword">const</span> *value,<span class="keywordtype">int</span> <span class="keyword">override</span>)</div>
<div class="line"><a name="l00069"></a><span class="lineno"> 69</span>&#160; {</div>
<div class="line"><a name="l00070"></a><span class="lineno"> 70</span>&#160; <a class="code" href="classboost_1_1nowide_1_1basic__stackstring.html">wshort_stackstring</a> name;</div>
<div class="line"><a name="l00071"></a><span class="lineno"> 71</span>&#160; <span class="keywordflow">if</span>(!name.convert(key))</div>
<div class="line"><a name="l00072"></a><span class="lineno"> 72</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00073"></a><span class="lineno"> 73</span>&#160; <span class="keywordflow">if</span>(!<span class="keyword">override</span>) {</div>
<div class="line"><a name="l00074"></a><span class="lineno"> 74</span>&#160; <span class="keywordtype">wchar_t</span> unused[2];</div>
<div class="line"><a name="l00075"></a><span class="lineno"> 75</span>&#160; <span class="keywordflow">if</span>(!(GetEnvironmentVariableW(name.c_str(),unused,2)==0 &amp;&amp; GetLastError() == 203)) <span class="comment">// ERROR_ENVVAR_NOT_FOUND</span></div>
<div class="line"><a name="l00076"></a><span class="lineno"> 76</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00077"></a><span class="lineno"> 77</span>&#160; }</div>
<div class="line"><a name="l00078"></a><span class="lineno"> 78</span>&#160; <a class="code" href="classboost_1_1nowide_1_1basic__stackstring.html">wstackstring</a> wval;</div>
<div class="line"><a name="l00079"></a><span class="lineno"> 79</span>&#160; <span class="keywordflow">if</span>(!wval.convert(value))</div>
<div class="line"><a name="l00080"></a><span class="lineno"> 80</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00081"></a><span class="lineno"> 81</span>&#160; <span class="keywordflow">if</span>(SetEnvironmentVariableW(name.c_str(),wval.c_str()))</div>
<div class="line"><a name="l00082"></a><span class="lineno"> 82</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00083"></a><span class="lineno"> 83</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00084"></a><span class="lineno"> 84</span>&#160; }</div>
<div class="line"><a name="l00088"></a><span class="lineno"><a class="line" href="namespaceboost_1_1nowide.html#a61c3e97d5b8fd9c9a1812e2004ef7db6"> 88</a></span>&#160; <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="namespaceboost_1_1nowide.html#a61c3e97d5b8fd9c9a1812e2004ef7db6">unsetenv</a>(<span class="keywordtype">char</span> <span class="keyword">const</span> *key)</div>
<div class="line"><a name="l00089"></a><span class="lineno"> 89</span>&#160; {</div>
<div class="line"><a name="l00090"></a><span class="lineno"> 90</span>&#160; <a class="code" href="classboost_1_1nowide_1_1basic__stackstring.html">wshort_stackstring</a> name;</div>
<div class="line"><a name="l00091"></a><span class="lineno"> 91</span>&#160; <span class="keywordflow">if</span>(!name.convert(key))</div>
<div class="line"><a name="l00092"></a><span class="lineno"> 92</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00093"></a><span class="lineno"> 93</span>&#160; <span class="keywordflow">if</span>(SetEnvironmentVariableW(name.c_str(),0))</div>
<div class="line"><a name="l00094"></a><span class="lineno"> 94</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00095"></a><span class="lineno"> 95</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00096"></a><span class="lineno"> 96</span>&#160; }</div>
<div class="line"><a name="l00100"></a><span class="lineno"><a class="line" href="namespaceboost_1_1nowide.html#ad42e1fc3dd7ac556a551fbac3fa553e3"> 100</a></span>&#160; <span class="keyword">inline</span> <span class="keywordtype">int</span> <a class="code" href="namespaceboost_1_1nowide.html#ad42e1fc3dd7ac556a551fbac3fa553e3">putenv</a>(<span class="keywordtype">char</span> *<span class="keywordtype">string</span>)</div>
<div class="line"><a name="l00101"></a><span class="lineno"> 101</span>&#160; {</div>
<div class="line"><a name="l00102"></a><span class="lineno"> 102</span>&#160; <span class="keywordtype">char</span> <span class="keyword">const</span> *key = string;</div>
<div class="line"><a name="l00103"></a><span class="lineno"> 103</span>&#160; <span class="keywordtype">char</span> <span class="keyword">const</span> *key_end = string;</div>
<div class="line"><a name="l00104"></a><span class="lineno"> 104</span>&#160; <span class="keywordflow">while</span>(*key_end!=<span class="charliteral">&#39;=&#39;</span> &amp;&amp; key_end!=<span class="charliteral">&#39;\0&#39;</span>)</div>
<div class="line"><a name="l00105"></a><span class="lineno"> 105</span>&#160; key_end++;</div>
<div class="line"><a name="l00106"></a><span class="lineno"> 106</span>&#160; <span class="keywordflow">if</span>(*key_end == <span class="charliteral">&#39;\0&#39;</span>)</div>
<div class="line"><a name="l00107"></a><span class="lineno"> 107</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00108"></a><span class="lineno"> 108</span>&#160; <a class="code" href="classboost_1_1nowide_1_1basic__stackstring.html">wshort_stackstring</a> wkey;</div>
<div class="line"><a name="l00109"></a><span class="lineno"> 109</span>&#160; <span class="keywordflow">if</span>(!wkey.convert(key,key_end))</div>
<div class="line"><a name="l00110"></a><span class="lineno"> 110</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00111"></a><span class="lineno"> 111</span>&#160; </div>
<div class="line"><a name="l00112"></a><span class="lineno"> 112</span>&#160; <a class="code" href="classboost_1_1nowide_1_1basic__stackstring.html">wstackstring</a> wvalue;</div>
<div class="line"><a name="l00113"></a><span class="lineno"> 113</span>&#160; <span class="keywordflow">if</span>(!wvalue.convert(key_end+1))</div>
<div class="line"><a name="l00114"></a><span class="lineno"> 114</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00115"></a><span class="lineno"> 115</span>&#160;</div>
<div class="line"><a name="l00116"></a><span class="lineno"> 116</span>&#160; <span class="keywordflow">if</span>(SetEnvironmentVariableW(wkey.c_str(),wvalue.c_str()))</div>
<div class="line"><a name="l00117"></a><span class="lineno"> 117</span>&#160; <span class="keywordflow">return</span> 0;</div>
<div class="line"><a name="l00118"></a><span class="lineno"> 118</span>&#160; <span class="keywordflow">return</span> -1;</div>
<div class="line"><a name="l00119"></a><span class="lineno"> 119</span>&#160; }</div>
<div class="line"><a name="l00120"></a><span class="lineno"> 120</span>&#160;<span class="preprocessor"> #endif</span></div>
<div class="line"><a name="l00121"></a><span class="lineno"> 121</span>&#160;} <span class="comment">// nowide</span></div>
<div class="line"><a name="l00122"></a><span class="lineno"> 122</span>&#160;} <span class="comment">// namespace boost</span></div>
<div class="line"><a name="l00123"></a><span class="lineno"> 123</span>&#160;</div>
<div class="line"><a name="l00124"></a><span class="lineno"> 124</span>&#160;<span class="preprocessor">#endif</span></div>
<div class="line"><a name="l00125"></a><span class="lineno"> 125</span>&#160;<span class="comment">// vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4</span></div>
<div class="ttc" id="namespaceboost_1_1nowide_html_a8369c10c0df6e36cd10cb9f9beb3149d"><div class="ttname"><a href="namespaceboost_1_1nowide.html#a8369c10c0df6e36cd10cb9f9beb3149d">boost::nowide::wshort_stackstring</a></div><div class="ttdeci">basic_stackstring&lt; wchar_t, char, 16 &gt; wshort_stackstring</div><div class="ttdef"><b>Definition:</b> stackstring.hpp:142</div></div>
<div class="ttc" id="namespaceboost_1_1nowide_html_a19d4925ea2c77e0b2abd8f5d045a8af2"><div class="ttname"><a href="namespaceboost_1_1nowide.html#a19d4925ea2c77e0b2abd8f5d045a8af2">boost::nowide::setenv</a></div><div class="ttdeci">int setenv(char const *key, char const *value, int override)</div><div class="ttdoc">UTF-8 aware setenv, key - the variable name, value is a new UTF-8 value,. </div><div class="ttdef"><b>Definition:</b> cenv.hpp:68</div></div>
<div class="ttc" id="namespaceboost_1_1nowide_html_ad42e1fc3dd7ac556a551fbac3fa553e3"><div class="ttname"><a href="namespaceboost_1_1nowide.html#ad42e1fc3dd7ac556a551fbac3fa553e3">boost::nowide::putenv</a></div><div class="ttdeci">int putenv(char *string)</div><div class="ttdoc">UTF-8 aware putenv implementation, expects string in format KEY=VALUE. </div><div class="ttdef"><b>Definition:</b> cenv.hpp:100</div></div>
<div class="ttc" id="namespaceboost_1_1nowide_html_a61c3e97d5b8fd9c9a1812e2004ef7db6"><div class="ttname"><a href="namespaceboost_1_1nowide.html#a61c3e97d5b8fd9c9a1812e2004ef7db6">boost::nowide::unsetenv</a></div><div class="ttdeci">int unsetenv(char const *key)</div><div class="ttdoc">Remove enviroment variable key. </div><div class="ttdef"><b>Definition:</b> cenv.hpp:88</div></div>
<div class="ttc" id="namespaceboost_1_1nowide_html_a6644397c539754076b11e95c535be192"><div class="ttname"><a href="namespaceboost_1_1nowide.html#a6644397c539754076b11e95c535be192">boost::nowide::getenv</a></div><div class="ttdeci">char * getenv(char const *key)</div><div class="ttdoc">UTF-8 aware getenv. Returns 0 if the variable is not set. </div><div class="ttdef"><b>Definition:</b> cenv.hpp:35</div></div>
<div class="ttc" id="namespaceboost_1_1nowide_html_acd4c19d4e98ae3e50b08ef2ef5056a12"><div class="ttname"><a href="namespaceboost_1_1nowide.html#acd4c19d4e98ae3e50b08ef2ef5056a12">boost::nowide::stackstring</a></div><div class="ttdeci">basic_stackstring&lt; char, wchar_t, 256 &gt; stackstring</div><div class="ttdef"><b>Definition:</b> stackstring.hpp:138</div></div>
<div class="ttc" id="classboost_1_1nowide_1_1basic__stackstring_html"><div class="ttname"><a href="classboost_1_1nowide_1_1basic__stackstring.html">boost::nowide::basic_stackstring</a></div><div class="ttdoc">A class that allows to create a temporary wide or narrow UTF strings from wide or narrow UTF source...</div><div class="ttdef"><b>Definition:</b> stackstring.hpp:25</div></div>
</div><!-- fragment --></div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by &#160;<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.7
</small></address>
</body>
</html>