1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
3
<title>glibmm 2.4: miscutils.h File Reference</title>
4
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
<body bgcolor="#ffffff">
7
<table border="0" width="100%">
9
<td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td>
10
<td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td>
14
<a class="qindex" href="http://www.gtkmm.org/documentation.shtml">Main Page</a>
15
<a class="qindex" href="namespaces.html">glibmm Namespaces</a>
16
<a href="../../../../gtkmm-2.4/docs/tutorial/html/index.html"> Book</a>
20
<!-- begin main content -->
22
<!-- Generated by Doxygen 1.5.9 -->
23
<div class="contents">
24
<h1>miscutils.h File Reference</h1><table border="0" cellpadding="0" cellspacing="0">
26
<tr><td colspan="2"><br><h2>Namespaces</h2></td></tr>
27
<tr><td class="memItemLeft" nowrap align="right" valign="top">namespace </td><td class="memItemRight" valign="bottom"><a class="el" href="namespaceGlib.html">Glib</a></td></tr>
29
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
30
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g9c2f67828083d74925b23c59ab868698">Glib::get_application_name</a> ()</td></tr>
32
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets a human-readable name for the application, as set by <a class="el" href="group__MiscUtils.html#g40e45835b7b461cba0f7a10fbb63c0d3" title="Sets a human-readable name for the application.">Glib::set_application_name()</a>. <a href="group__MiscUtils.html#g9c2f67828083d74925b23c59ab868698"></a><br></td></tr>
33
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g40e45835b7b461cba0f7a10fbb63c0d3">Glib::set_application_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& application_name)</td></tr>
35
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets a human-readable name for the application. <a href="group__MiscUtils.html#g40e45835b7b461cba0f7a10fbb63c0d3"></a><br></td></tr>
36
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g391655dededb496010eee2e92d0f1fdf">Glib::get_prgname</a> ()</td></tr>
38
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the name of the program. <a href="group__MiscUtils.html#g391655dededb496010eee2e92d0f1fdf"></a><br></td></tr>
39
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g7d5c429822c09048892c4dee9c8e08c1">Glib::set_prgname</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& prgname)</td></tr>
41
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the name of the program. <a href="group__MiscUtils.html#g7d5c429822c09048892c4dee9c8e08c1"></a><br></td></tr>
42
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g5e186fdb08835342a5866b11fe787ebb">Glib::getenv</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& variable, bool& found)</td></tr>
44
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of an environment variable. <a href="group__MiscUtils.html#g5e186fdb08835342a5866b11fe787ebb"></a><br></td></tr>
45
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g8e2c8f250aa7f059956737851ace08f6">Glib::getenv</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& variable)</td></tr>
47
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of an environment variable. <a href="group__MiscUtils.html#g8e2c8f250aa7f059956737851ace08f6"></a><br></td></tr>
48
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g862657f21e5a930541d048a920204f59">Glib::setenv</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& variable, const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& value, bool overwrite=true)</td></tr>
50
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets an environment variable. <a href="group__MiscUtils.html#g862657f21e5a930541d048a920204f59"></a><br></td></tr>
51
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g6fb89001630714ec9ee5244cab56343e">Glib::unsetenv</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& variable)</td></tr>
53
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes an environment variable from the environment. <a href="group__MiscUtils.html#g6fb89001630714ec9ee5244cab56343e"></a><br></td></tr>
54
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g52964bfd712e8c9e688f668da51f3ed9">Glib::get_user_name</a> ()</td></tr>
56
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the user name of the current user. <a href="group__MiscUtils.html#g52964bfd712e8c9e688f668da51f3ed9"></a><br></td></tr>
57
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g30692e3263e66868878f535e0b7c9722">Glib::get_real_name</a> ()</td></tr>
59
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the real name of the user. <a href="group__MiscUtils.html#g30692e3263e66868878f535e0b7c9722"></a><br></td></tr>
60
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g9412ea70c7fea058c03211dac318f8e6">Glib::get_home_dir</a> ()</td></tr>
62
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current user's home directory. <a href="group__MiscUtils.html#g9412ea70c7fea058c03211dac318f8e6"></a><br></td></tr>
63
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gc42272146fd9320958132f1591d28991">Glib::get_tmp_dir</a> ()</td></tr>
65
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the directory to use for temporary files. <a href="group__MiscUtils.html#gc42272146fd9320958132f1591d28991"></a><br></td></tr>
66
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g06d93c95572d6a382b8cc4e09dd5a339">Glib::get_current_dir</a> ()</td></tr>
68
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current directory. <a href="group__MiscUtils.html#g06d93c95572d6a382b8cc4e09dd5a339"></a><br></td></tr>
69
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gbc928a4e477df53f90e221a854cc73cb">Glib::get_user_special_dir</a> (GUserDirectory directory)</td></tr>
71
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the full path of a special directory using its logical id. <a href="group__MiscUtils.html#gbc928a4e477df53f90e221a854cc73cb"></a><br></td></tr>
72
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g821b704b5ede1583e4057990976d394b">Glib::get_user_data_dir</a> ()</td></tr>
74
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a base directory in which to access application data such as icons that is customized for a particular user. <a href="group__MiscUtils.html#g821b704b5ede1583e4057990976d394b"></a><br></td></tr>
75
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ge517b931f4753abcd48adb2769a8fc48">Glib::get_user_config_dir</a> ()</td></tr>
77
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a base directory in which to store user-specific application configuration information such as user preferences and settings. <a href="group__MiscUtils.html#ge517b931f4753abcd48adb2769a8fc48"></a><br></td></tr>
78
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga68121f26e82df1c293c82b89c8998e5">Glib::get_user_cache_dir</a> ()</td></tr>
80
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns a base directory in which to store non-essential, cached data specific to particular user. <a href="group__MiscUtils.html#ga68121f26e82df1c293c82b89c8998e5"></a><br></td></tr>
81
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gd82525f39f7408f97f2c096c4f721b3b">Glib::path_is_absolute</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& filename)</td></tr>
83
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns <code>true</code> if the given <em>filename</em> is an absolute file name, i.e. it contains a full path from the root directory such as <code>"/usr/local"</code> on UNIX or <code>"C:\\windows"</code> on Windows systems. <a href="group__MiscUtils.html#gd82525f39f7408f97f2c096c4f721b3b"></a><br></td></tr>
84
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g306eee64abc3d28993895b826f4dd533">Glib::path_skip_root</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& filename)</td></tr>
86
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the remaining part of <em>filename</em> after the root component, i.e. after the <code>"/"</code> on UNIX or <code>"C:\\"</code> on Windows. <a href="group__MiscUtils.html#g306eee64abc3d28993895b826f4dd533"></a><br></td></tr>
87
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g20ebf2917a7fce5d1901568017b95a35">Glib::path_get_basename</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& filename)</td></tr>
89
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the name of the file without any leading directory components. <a href="group__MiscUtils.html#g20ebf2917a7fce5d1901568017b95a35"></a><br></td></tr>
90
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ge03457226c4239a74b83486739521434">Glib::path_get_dirname</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& filename)</td></tr>
92
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the directory components of a file name. <a href="group__MiscUtils.html#ge03457226c4239a74b83486739521434"></a><br></td></tr>
93
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga4a70bf050b3f318f87049ed30206a9a">Glib::build_filename</a> (const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><<a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>>& elements)</td></tr>
95
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a filename from a series of elements using the correct separator for filenames. <a href="group__MiscUtils.html#ga4a70bf050b3f318f87049ed30206a9a"></a><br></td></tr>
96
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gda06023cc39be3a44eb68e38d6cbea6c">Glib::build_filename</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& elem1, const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& elem2)</td></tr>
98
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a filename from two elements using the correct separator for filenames. <a href="group__MiscUtils.html#gda06023cc39be3a44eb68e38d6cbea6c"></a><br></td></tr>
99
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g6afc89d45cc34f3cfce4a55f3f5e7afa">Glib::build_path</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& separator, const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><<a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>>& elements)</td></tr>
101
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a path from a series of elements using <em>separator</em> as the separator between elements. <a href="group__MiscUtils.html#g6afc89d45cc34f3cfce4a55f3f5e7afa"></a><br></td></tr>
102
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga4c4ecb9a3eb803ae6d9dee51e1e5b14">Glib::find_program_in_path</a> (const <a class="elRef" doxygen="libstdc++.tag.xml:http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/namespacestd.html#a48">std::string</a>& program)</td></tr>
104
<tr><td class="mdescLeft"> </td><td class="mdescRight">Locates the first executable named <em>program</em> in the user's path, in the same way that <code>execvp()</code> would locate it. <a href="group__MiscUtils.html#ga4c4ecb9a3eb803ae6d9dee51e1e5b14"></a><br></td></tr>
107
</div> <!-- end main content -->
110
Generated for glibmm 2.4 by <a href="http://www.doxygen.org/index.html">
111
Doxygen</a> 1.5.9 © 1997-2001</small></address>