libgnome-gnome-util.html

来自「最新gtk中文资料集」· HTML 代码 · 共 850 行 · 第 1/3 页

><code class="literal">TRUE</code></a>, overwrite the existing <em class="parameter"><code>name</code></em> variable in the
environment.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td> <code class="literal">0</code> on success, <code class="literal">-1</code> on error

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823311"></a><h3>
<a name="gnome-unsetenv"></a>gnome_unsetenv ()</h3>
<a class="indexterm" name="id2823324"></a><pre class="programlisting">void        gnome_unsetenv                  (const char *name);</pre>
<p>
Removes <em class="parameter"><code>name</code></em> from the environment.
In case there is no native implementation of unsetenv,
this could cause leaks depending on the implementation of
environment.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em>&#160;:</span></td>
<td> The environment variable to unset.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823382"></a><h3>
<a name="gnome-clearenv"></a>gnome_clearenv ()</h3>
<a class="indexterm" name="id2823395"></a><pre class="programlisting">void        gnome_clearenv                  (void);</pre>
<p>
Clears out the environment completely.
In case there is no native implementation of clearenv,
this could cause leaks depending on the implementation
of environment.</p>
<p>

</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823422"></a><h3>
<a name="g-concat-dir-and-file"></a>g_concat_dir_and_file()</h3>
<a class="indexterm" name="id2823438"></a><pre class="programlisting">#define     g_concat_dir_and_file(dir,file)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_concat_dir_and_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-build-filename"
><code class="function">g_build_filename()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>dir</code></em>&#160;:</span></td>
<td>Directory name.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>file</code></em>&#160;:</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>A newly allocated string that is the concatenation of <em class="parameter"><code>dir</code></em> and <em class="parameter"><code>file</code></em>,
with seperators appropriate for the filesystem automatically taken care of.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823535"></a><h3>
<a name="g-file-exists"></a>g_file_exists()</h3>
<a class="indexterm" name="id2823550"></a><pre class="programlisting">#define     g_file_exists(filename)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_file_exists</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use g_file_test(<em class="parameter"><code>filename</code></em>, G_FILE_TEST_EXISTS) instead of this
function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>filename</code></em>&#160;:</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>Returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if <em class="parameter"><code>filename</code></em> exists, <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"
><code class="literal">FALSE</code></a> otherwise.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823640"></a><h3>
<a name="g-unix-error-string"></a>g_unix_error_string()</h3>
<a class="indexterm" name="id2823656"></a><pre class="programlisting">#define     g_unix_error_string(error_num)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_unix_error_string</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strerror"
><code class="function">g_strerror()</code></a> instead of this function. Also, note that the
returned string is only valid until the next call to <a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strerror"
><code class="function">g_strerror()</code></a> or
<a href="libgnome-gnome-util.html#g-unix-error-string"><code class="function">g_unix_error_string()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>error_num</code></em>&#160;:</span></td>
<td>A system error number (see C <span class="type">errno</span> documentation for more info).
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>A string describing the error code.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823756"></a><h3>
<a name="gnome-util-user-home"></a>gnome_util_user_home()</h3>
<a class="indexterm" name="id2823771"></a><pre class="programlisting">#define     gnome_util_user_home()</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_util_user_home</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a
href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-home-dir"
><code class="function">g_get_home_dir()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>The current user's home directory.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823827"></a><h3>
<a name="g-copy-vector"></a>g_copy_vector()</h3>
<a class="indexterm" name="id2823842"></a><pre class="programlisting">#define     g_copy_vector(vec)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">g_copy_vector</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Use <a
href="/usr/share/gtk-doc/html/glib/glib-String-Utility-Functions.html#g-strdupv"
><code class="function">g_strdupv()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>vec</code></em>&#160;:</span></td>
<td>An array of strings. <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a> terminated.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>A copy of the <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>-terminated string array.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2823931"></a><h3>
<a name="gnome-libdir-file"></a>gnome_libdir_file()</h3>
<a class="indexterm" name="id2823946"></a><pre class="programlisting">#define     gnome_libdir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_libdir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em>&#160;:</span></td>
<td>Filename.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>A full path to the file <em class="parameter"><code>f</code></em> that is stored in the system's GNOME
library directory (not the application's directory).


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2824022"></a><h3>
<a name="gnome-datadir-file"></a>gnome_datadir_file()</h3>
<a class="indexterm" name="id2824037"></a><pre class="programlisting">#define     gnome_datadir_file(f)</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gnome_datadir_file</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Programs should use <a href="libgnome-gnome-program.html#gnome-program-locate-file"><code class="function">gnome_program_locate_file()</code></a> instead of this function.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>f</code></em>&#160;:</span></td>
<td>Filename.
</td>