<!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"/>
<title>glibmm: Miscellaneous Utility Functions</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
</div>
<div class="contents">
<h1>Miscellaneous Utility Functions</h1>
<p>Miscellaneous Utility Functions -- a selection of portable utility functions. <a href="#_details">More...</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" 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#ga9c2f67828083d74925b23c59ab868698">Glib::get_application_name</a> ()</td></tr>
<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#ga40e45835b7b461cba0f7a10fbb63c0d3" title="Sets a human-readable name for the application.">Glib::set_application_name()</a>. <a href="#ga9c2f67828083d74925b23c59ab868698"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga40e45835b7b461cba0f7a10fbb63c0d3">Glib::set_application_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& application_name)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets a human-readable name for the application. <a href="#ga40e45835b7b461cba0f7a10fbb63c0d3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga391655dededb496010eee2e92d0f1fdf">Glib::get_prgname</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the name of the program. <a href="#ga391655dededb496010eee2e92d0f1fdf"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga7d5c429822c09048892c4dee9c8e08c1">Glib::set_prgname</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& prgname)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the name of the program. <a href="#ga7d5c429822c09048892c4dee9c8e08c1"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga5e186fdb08835342a5866b11fe787ebb">Glib::getenv</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& variable, bool& found)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of an environment variable. <a href="#ga5e186fdb08835342a5866b11fe787ebb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga8e2c8f250aa7f059956737851ace08f6">Glib::getenv</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& variable)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the value of an environment variable. <a href="#ga8e2c8f250aa7f059956737851ace08f6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga862657f21e5a930541d048a920204f59">Glib::setenv</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& variable, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01009.html#ga1c9e781d8d15a3814a601f471797c825">value</a>, bool overwrite=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets an environment variable. <a href="#ga862657f21e5a930541d048a920204f59"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga6fb89001630714ec9ee5244cab56343e">Glib::unsetenv</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& variable)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Removes an environment variable from the environment. <a href="#ga6fb89001630714ec9ee5244cab56343e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga52964bfd712e8c9e688f668da51f3ed9">Glib::get_user_name</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the user name of the current user. <a href="#ga52964bfd712e8c9e688f668da51f3ed9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga30692e3263e66868878f535e0b7c9722">Glib::get_real_name</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the real name of the user. <a href="#ga30692e3263e66868878f535e0b7c9722"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga9412ea70c7fea058c03211dac318f8e6">Glib::get_home_dir</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current user's home directory. <a href="#ga9412ea70c7fea058c03211dac318f8e6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gac42272146fd9320958132f1591d28991">Glib::get_tmp_dir</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the directory to use for temporary files. <a href="#gac42272146fd9320958132f1591d28991"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga06d93c95572d6a382b8cc4e09dd5a339">Glib::get_current_dir</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current directory. <a href="#ga06d93c95572d6a382b8cc4e09dd5a339"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gabc928a4e477df53f90e221a854cc73cb">Glib::get_user_special_dir</a> (GUserDirectory directory)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the full path of a special directory using its logical id. <a href="#gabc928a4e477df53f90e221a854cc73cb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga821b704b5ede1583e4057990976d394b">Glib::get_user_data_dir</a> ()</td></tr>
<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="#ga821b704b5ede1583e4057990976d394b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gae517b931f4753abcd48adb2769a8fc48">Glib::get_user_config_dir</a> ()</td></tr>
<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="#gae517b931f4753abcd48adb2769a8fc48"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gaa68121f26e82df1c293c82b89c8998e5">Glib::get_user_cache_dir</a> ()</td></tr>
<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="#gaa68121f26e82df1c293c82b89c8998e5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gad82525f39f7408f97f2c096c4f721b3b">Glib::path_is_absolute</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
<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="#gad82525f39f7408f97f2c096c4f721b3b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga306eee64abc3d28993895b826f4dd533">Glib::path_skip_root</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
<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="#ga306eee64abc3d28993895b826f4dd533"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga20ebf2917a7fce5d1901568017b95a35">Glib::path_get_basename</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the name of the file without any leading directory components. <a href="#ga20ebf2917a7fce5d1901568017b95a35"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gae03457226c4239a74b83486739521434">Glib::path_get_dirname</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& filename)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the directory components of a file name. <a href="#gae03457226c4239a74b83486739521434"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gaa4a70bf050b3f318f87049ed30206a9a">Glib::build_filename</a> (const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& elements)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a filename from a series of elements using the correct separator for filenames. <a href="#gaa4a70bf050b3f318f87049ed30206a9a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gada06023cc39be3a44eb68e38d6cbea6c">Glib::build_filename</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& elem1, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& elem2)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a filename from two elements using the correct separator for filenames. <a href="#gada06023cc39be3a44eb68e38d6cbea6c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#ga6afc89d45cc34f3cfce4a55f3f5e7afa">Glib::build_path</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& separator, const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& elements)</td></tr>
<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="#ga6afc89d45cc34f3cfce4a55f3f5e7afa"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gaa4c4ecb9a3eb803ae6d9dee51e1e5b14">Glib::find_program_in_path</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a>& program)</td></tr>
<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="#gaa4c4ecb9a3eb803ae6d9dee51e1e5b14"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Miscellaneous Utility Functions -- a selection of portable utility functions. </p>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="gada06023cc39be3a44eb68e38d6cbea6c"></a><!-- doxytag: member="Glib::build_filename" ref="gada06023cc39be3a44eb68e38d6cbea6c" args="(const std::string &elem1, const std::string &elem2)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::build_filename </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>elem1</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>elem2</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a filename from two elements using the correct separator for filenames. </p>
<p>No attempt is made to force the resulting filename to be an absolute path. If the first element is a relative path, the result will be a relative path. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>elem1</em> </td><td>First path element. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>elem2</em> </td><td>Second path element. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The resulting path. </dd></dl>
</div>
</div>
<a class="anchor" id="gaa4a70bf050b3f318f87049ed30206a9a"></a><!-- doxytag: member="Glib::build_filename" ref="gaa4a70bf050b3f318f87049ed30206a9a" args="(const Glib::ArrayHandle< std::string > &elements)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::build_filename </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& </td>
<td class="paramname"> <em>elements</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a filename from a series of elements using the correct separator for filenames. </p>
<p>This function behaves identically to <a class="el" href="group__MiscUtils.html#ga6afc89d45cc34f3cfce4a55f3f5e7afa" title="Creates a path from a series of elements using separator as the separator between...">Glib::build_path</a>(G_DIR_SEPARATOR_S, elements). No attempt is made to force the resulting filename to be an absolute path. If the first element is a relative path, the result will be a relative path. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>elements</em> </td><td>A container holding the elements of the path to build. Any STL compatible container type is accepted. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The resulting path. </dd></dl>
</div>
</div>
<a class="anchor" id="ga6afc89d45cc34f3cfce4a55f3f5e7afa"></a><!-- doxytag: member="Glib::build_path" ref="ga6afc89d45cc34f3cfce4a55f3f5e7afa" args="(const std::string &separator, const Glib::ArrayHandle< std::string > &elements)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::build_path </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>separator</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> >& </td>
<td class="paramname"> <em>elements</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a path from a series of elements using <em>separator</em> as the separator between elements. </p>
<p>At the boundary between two elements, any trailing occurrences of <em>separator</em> in the first element, or leading occurrences of <em>separator</em> in the second element are removed and exactly one copy of the separator is inserted.</p>
<p>Empty elements are ignored.</p>
<p>The number of leading copies of the separator on the result is the same as the number of leading copies of the separator on the first non-empty element.</p>
<p>The number of trailing copies of the separator on the result is the same as the number of trailing copies of the separator on the last non-empty element. (Determination of the number of trailing copies is done without stripping leading copies, so if the separator is <code>"ABA"</code>, <code>"ABABA"</code> has 1 trailing copy.)</p>
<p>However, if there is only a single non-empty element, and there are no characters in that element not part of the leading or trailing separators, then the result is exactly the original value of that element.</p>
<p>Other than for determination of the number of leading and trailing copies of the separator, elements consisting only of copies of the separator are ignored.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>separator</em> </td><td>A string used to separate the elements of the path. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>elements</em> </td><td>A container holding the elements of the path to build. Any STL compatible container type is accepted. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The resulting path. </dd></dl>
</div>
</div>
<a class="anchor" id="gaa4c4ecb9a3eb803ae6d9dee51e1e5b14"></a><!-- doxytag: member="Glib::find_program_in_path" ref="gaa4c4ecb9a3eb803ae6d9dee51e1e5b14" args="(const std::string &program)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::find_program_in_path </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>program</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Locates the first executable named <em>program</em> in the user's path, in the same way that <code>execvp()</code> would locate it. </p>
<p>Returns a string with the absolute path name, or <code>""</code> if the program is not found in the path. If <em>program</em> is already an absolute path, returns a copy of <em>program</em> if <em>program</em> exists and is executable, and <code>""</code> otherwise.</p>
<p>On Windows, if <em>program</em> does not have a file type suffix, tries to append the suffixes in the <code>PATHEXT</code> environment variable (if that doesn't exist, the suffixes .com, .exe, and .bat) in turn, and then look for the resulting file name in the same way as CreateProcess() would. This means first in the directory where the program was loaded from, then in the current directory, then in the Windows 32-bit system directory, then in the Windows directory, and finally in the directories in the <code>PATH</code> environment variable. If the program is found, the return value contains the full name including the type suffix.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>program</em> </td><td>A program name. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>An absolute path, or <code>""</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="ga9c2f67828083d74925b23c59ab868698"></a><!-- doxytag: member="Glib::get_application_name" ref="ga9c2f67828083d74925b23c59ab868698" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> Glib::get_application_name </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets a human-readable name for the application, as set by <a class="el" href="group__MiscUtils.html#ga40e45835b7b461cba0f7a10fbb63c0d3" title="Sets a human-readable name for the application.">Glib::set_application_name()</a>. </p>
<p>This name should be localized if possible, and is intended for display to the user. Contrast with <a class="el" href="group__MiscUtils.html#ga391655dededb496010eee2e92d0f1fdf" title="Gets the name of the program.">Glib::get_prgname()</a>, which gets a non-localized name. If <a class="el" href="group__MiscUtils.html#ga40e45835b7b461cba0f7a10fbb63c0d3" title="Sets a human-readable name for the application.">Glib::set_application_name()</a> has not been called, returns the result of <a class="el" href="group__MiscUtils.html#ga391655dededb496010eee2e92d0f1fdf" title="Gets the name of the program.">Glib::get_prgname()</a> (which may be empty if <a class="el" href="group__MiscUtils.html#ga7d5c429822c09048892c4dee9c8e08c1" title="Sets the name of the program.">Glib::set_prgname()</a> has also not been called).</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>Human-readable application name. May return <code>""</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="ga06d93c95572d6a382b8cc4e09dd5a339"></a><!-- doxytag: member="Glib::get_current_dir" ref="ga06d93c95572d6a382b8cc4e09dd5a339" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_current_dir </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the current directory. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The current directory. </dd></dl>
</div>
</div>
<a class="anchor" id="ga9412ea70c7fea058c03211dac318f8e6"></a><!-- doxytag: member="Glib::get_home_dir" ref="ga9412ea70c7fea058c03211dac318f8e6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_home_dir </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the current user's home directory. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The current user's home directory or an empty string if not defined. </dd></dl>
</div>
</div>
<a class="anchor" id="ga391655dededb496010eee2e92d0f1fdf"></a><!-- doxytag: member="Glib::get_prgname" ref="ga391655dededb496010eee2e92d0f1fdf" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_prgname </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the name of the program. </p>
<p>If you are using GDK or GTK+ the program name is set in <code>gdk_init()</code>, which is called by <code>gtk_init()</code>. The program name is found by taking the last component of <code>argv[0]</code>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The name of the program. </dd></dl>
</div>
</div>
<a class="anchor" id="ga30692e3263e66868878f535e0b7c9722"></a><!-- doxytag: member="Glib::get_real_name" ref="ga30692e3263e66868878f535e0b7c9722" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_real_name </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the real name of the user. </p>
<p>This usually comes from the user's entry in the <code>passwd</code> file. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The user's real name. </dd></dl>
</div>
</div>
<a class="anchor" id="gac42272146fd9320958132f1591d28991"></a><!-- doxytag: member="Glib::get_tmp_dir" ref="gac42272146fd9320958132f1591d28991" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_tmp_dir </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the directory to use for temporary files. </p>
<p>This is found from inspecting the environment variables <code>TMPDIR</code>, <code>TMP</code>, and <code>TEMP</code> in that order. If none of those are defined <code>"/tmp"</code> is returned on UNIX and <code>"C:\\"</code> on Windows. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The directory to use for temporary files. </dd></dl>
</div>
</div>
<a class="anchor" id="gaa68121f26e82df1c293c82b89c8998e5"></a><!-- doxytag: member="Glib::get_user_cache_dir" ref="gaa68121f26e82df1c293c82b89c8998e5" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_user_cache_dir </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a base directory in which to store non-essential, cached data specific to particular user. </p>
<p>On UNIX platforms this is determined using the mechanisms described in the XDG Base Directory Specification</p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000030">Since glibmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="gae517b931f4753abcd48adb2769a8fc48"></a><!-- doxytag: member="Glib::get_user_config_dir" ref="gae517b931f4753abcd48adb2769a8fc48" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_user_config_dir </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a base directory in which to store user-specific application configuration information such as user preferences and settings. </p>
<p>On UNIX platforms this is determined using the mechanisms described in the XDG Base Directory Specification</p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000029">Since glibmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga821b704b5ede1583e4057990976d394b"></a><!-- doxytag: member="Glib::get_user_data_dir" ref="ga821b704b5ede1583e4057990976d394b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_user_data_dir </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a base directory in which to access application data such as icons that is customized for a particular user. </p>
<p>On UNIX platforms this is determined using the mechanisms described in the XDG Base Directory Specification</p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000028">Since glibmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga52964bfd712e8c9e688f668da51f3ed9"></a><!-- doxytag: member="Glib::get_user_name" ref="ga52964bfd712e8c9e688f668da51f3ed9" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_user_name </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the user name of the current user. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The name of the current user. </dd></dl>
</div>
</div>
<a class="anchor" id="gabc928a4e477df53f90e221a854cc73cb"></a><!-- doxytag: member="Glib::get_user_special_dir" ref="gabc928a4e477df53f90e221a854cc73cb" args="(GUserDirectory directory)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::get_user_special_dir </td>
<td>(</td>
<td class="paramtype">GUserDirectory </td>
<td class="paramname"> <em>directory</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the full path of a special directory using its logical id. </p>
<p>On Unix this is done using the XDG special user directories.</p>
<p>Depending on the platform, the user might be able to change the path of the special directory without requiring the session to restart; GLib will not reflect any change once the special directories are loaded.</p>
<p>Return value: the path to the specified special directory. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>directory</em> </td><td>Te logical id of special directory</td></tr>
</table>
</dd>
</dl>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000027">Since glibmm 2.14:</a></b></dt><dd></dd></dl>
</div>
</div>
<a class="anchor" id="ga8e2c8f250aa7f059956737851ace08f6"></a><!-- doxytag: member="Glib::getenv" ref="ga8e2c8f250aa7f059956737851ace08f6" args="(const std::string &variable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::getenv </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>variable</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the value of an environment variable. </p>
<p>The name and value are in the GLib file name encoding. On Unix, this means the actual bytes which might or might not be in some consistent character set and encoding. On Windows, it is in UTF-8. On Windows, in case the environment variable's value contains references to other environment variables, they are expanded.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>variable</em> </td><td>The environment variable to get. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The value of the environment variable, or <code>""</code> if not found. </dd></dl>
</div>
</div>
<a class="anchor" id="ga5e186fdb08835342a5866b11fe787ebb"></a><!-- doxytag: member="Glib::getenv" ref="ga5e186fdb08835342a5866b11fe787ebb" args="(const std::string &variable, bool &found)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::getenv </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>variable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool & </td>
<td class="paramname"> <em>found</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the value of an environment variable. </p>
<p>The name and value are in the GLib file name encoding. On Unix, this means the actual bytes which might or might not be in some consistent character set and encoding. On Windows, it is in UTF-8. On Windows, in case the environment variable's value contains references to other environment variables, they are expanded.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>variable</em> </td><td>The environment variable to get. </td></tr>
</table>
</dd>
</dl>
<dl><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>found</em> </td><td><code>true</code> Whether the environment variable has been found. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The value of the environment variable, or <code>""</code> if not found. </dd></dl>
</div>
</div>
<a class="anchor" id="ga20ebf2917a7fce5d1901568017b95a35"></a><!-- doxytag: member="Glib::path_get_basename" ref="ga20ebf2917a7fce5d1901568017b95a35" args="(const std::string &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::path_get_basename </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>filename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the name of the file without any leading directory components. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>filename</em> </td><td>The name of the file. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The name of the file without any leading directory components. </dd></dl>
</div>
</div>
<a class="anchor" id="gae03457226c4239a74b83486739521434"></a><!-- doxytag: member="Glib::path_get_dirname" ref="gae03457226c4239a74b83486739521434" args="(const std::string &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::path_get_dirname </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>filename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the directory components of a file name. </p>
<p>If the file name has no directory components <code>"."</code> is returned. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>filename</em> </td><td>The name of the file. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The directory components of the file. </dd></dl>
</div>
</div>
<a class="anchor" id="gad82525f39f7408f97f2c096c4f721b3b"></a><!-- doxytag: member="Glib::path_is_absolute" ref="gad82525f39f7408f97f2c096c4f721b3b" args="(const std::string &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Glib::path_is_absolute </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>filename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>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. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>filename</em> </td><td>A file name. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Whether <em>filename</em> is an absolute path. </dd></dl>
</div>
</div>
<a class="anchor" id="ga306eee64abc3d28993895b826f4dd533"></a><!-- doxytag: member="Glib::path_skip_root" ref="ga306eee64abc3d28993895b826f4dd533" args="(const std::string &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::path_skip_root </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>filename</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>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. </p>
<p>If <em>filename</em> is not an absolute path, <code>""</code> will be returned. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>filename</em> </td><td>A file name. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The file name without the root component, or <code>""</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="ga40e45835b7b461cba0f7a10fbb63c0d3"></a><!-- doxytag: member="Glib::set_application_name" ref="ga40e45835b7b461cba0f7a10fbb63c0d3" args="(const Glib::ustring &application_name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Glib::set_application_name </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="paramname"> <em>application_name</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets a human-readable name for the application. </p>
<p>This name should be localized if possible, and is intended for display to the user. Contrast with <a class="el" href="group__MiscUtils.html#ga7d5c429822c09048892c4dee9c8e08c1" title="Sets the name of the program.">Glib::set_prgname()</a>, which sets a non-localized name. <a class="el" href="group__MiscUtils.html#ga7d5c429822c09048892c4dee9c8e08c1" title="Sets the name of the program.">Glib::set_prgname()</a> will be called automatically by <code>gtk_init()</code>, but <a class="el" href="group__MiscUtils.html#ga40e45835b7b461cba0f7a10fbb63c0d3" title="Sets a human-readable name for the application.">Glib::set_application_name()</a> will not.</p>
<p>Note that for thread safety reasons, this function can only be called once.</p>
<p>The application name will be used in contexts such as error messages, or when displaying an application's name in the task list.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>application_name</em> </td><td>Localized name of the application. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga7d5c429822c09048892c4dee9c8e08c1"></a><!-- doxytag: member="Glib::set_prgname" ref="ga7d5c429822c09048892c4dee9c8e08c1" args="(const std::string &prgname)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Glib::set_prgname </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>prgname</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the name of the program. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>prgname</em> </td><td>The name of the program. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ga862657f21e5a930541d048a920204f59"></a><!-- doxytag: member="Glib::setenv" ref="ga862657f21e5a930541d048a920204f59" args="(const std::string &variable, const std::string &value, bool overwrite=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Glib::setenv </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>variable</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>overwrite</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets an environment variable. </p>
<p>Both the variable's name and value should be in the GLib file name encoding. On Unix, this means that they can be any sequence of bytes. On Windows, they should be in UTF-8.</p>
<p>Note that on some systems, when variables are overwritten, the memory used for the previous variables and its value isn't reclaimed.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>variable</em> </td><td>The environment variable to set. It must not contain '='. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>The value to which the variable should be set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>overwrite</em> </td><td>Whether to change the variable if it already exists. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>false if the environment variable couldn't be set. </dd></dl>
</div>
</div>
<a class="anchor" id="ga6fb89001630714ec9ee5244cab56343e"></a><!-- doxytag: member="Glib::unsetenv" ref="ga6fb89001630714ec9ee5244cab56343e" args="(const std::string &variable)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Glib::unsetenv </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00971.html#a32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td>
<td class="paramname"> <em>variable</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Removes an environment variable from the environment. </p>
<p>Note that on some systems, when variables are overwritten, the memory used for the previous variables and its value isn't reclaimed. Furthermore, this function can't be guaranteed to operate in a threadsafe way.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>variable,:</em> </td><td>the environment variable to remove. It must not contain '='. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Mon Sep 21 11:07:19 2009 for glibmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
