<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> <title>glibmm 2.4: miscutils.h File Reference</title> <link href="doxygen.css" rel="stylesheet" type="text/css"> </head> <body bgcolor="#ffffff"> <table border="0" width="100%"> <tr> <td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td> <td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td> </tr> </table> <center> <a class="qindex" href="../../../../gtkmm-2.4/docs/index.html">Main Page</a> <a href="../../../../gtkmm-2.4/docs/reference/html/group__Widgets.html">Widgets</a> <a class="qindex" href="namespaces.html">glibmm Namespaces</a> <a href="../../../../gtkmm-2.4/docs/tutorial/html/index.html"> Book</a> </center> <hr width="100%"/> <!-- begin main content --> <div id="content"> <!-- Generated by Doxygen 1.5.3 --> <h1>miscutils.h File Reference</h1><table border="0" cellpadding="0" cellspacing="0"> <tr><td></td></tr> <tr><td colspan="2"><br><h2>Namespaces</h2></td></tr> <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> <tr><td colspan="2"><br><h2>Functions</h2></td></tr> <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> <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> <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> <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> <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/classstd_1_1basic__string.html">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g391655dededb496010eee2e92d0f1fdf">Glib::get_prgname</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the name of the program. <a href="group__MiscUtils.html#g391655dededb496010eee2e92d0f1fdf"></a><br></td></tr> <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/classstd_1_1basic__string.html">std::string</a>& prgname)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the name of the program. <a href="group__MiscUtils.html#g7d5c429822c09048892c4dee9c8e08c1"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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="group__MiscUtils.html#g5e186fdb08835342a5866b11fe787ebb"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">std::string</a>& variable)</td></tr> <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> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">std::string</a>& value, bool overwrite=true)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets an environment variable. <a href="group__MiscUtils.html#g862657f21e5a930541d048a920204f59"></a><br></td></tr> <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/classstd_1_1basic__string.html">std::string</a>& variable)</td></tr> <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> <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/classstd_1_1basic__string.html">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g52964bfd712e8c9e688f668da51f3ed9">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="group__MiscUtils.html#g52964bfd712e8c9e688f668da51f3ed9"></a><br></td></tr> <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/classstd_1_1basic__string.html">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g30692e3263e66868878f535e0b7c9722">Glib::get_real_name</a> ()</td></tr> <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> <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/classstd_1_1basic__string.html">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g9412ea70c7fea058c03211dac318f8e6">Glib::get_home_dir</a> ()</td></tr> <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> <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/classstd_1_1basic__string.html">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#gc42272146fd9320958132f1591d28991">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="group__MiscUtils.html#gc42272146fd9320958132f1591d28991"></a><br></td></tr> <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/classstd_1_1basic__string.html">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__MiscUtils.html#g06d93c95572d6a382b8cc4e09dd5a339">Glib::get_current_dir</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the current directory. <a href="group__MiscUtils.html#g06d93c95572d6a382b8cc4e09dd5a339"></a><br></td></tr> <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/classstd_1_1basic__string.html">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> <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> <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/classstd_1_1basic__string.html">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> <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> <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/classstd_1_1basic__string.html">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> <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> <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/classstd_1_1basic__string.html">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> <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> <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/classstd_1_1basic__string.html">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="group__MiscUtils.html#gd82525f39f7408f97f2c096c4f721b3b"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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="group__MiscUtils.html#g306eee64abc3d28993895b826f4dd533"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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="group__MiscUtils.html#g20ebf2917a7fce5d1901568017b95a35"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">std::string</a>& filename)</td></tr> <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> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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="group__MiscUtils.html#ga4a70bf050b3f318f87049ed30206a9a"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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="group__MiscUtils.html#gda06023cc39be3a44eb68e38d6cbea6c"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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="group__MiscUtils.html#g6afc89d45cc34f3cfce4a55f3f5e7afa"></a><br></td></tr> <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/classstd_1_1basic__string.html">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/classstd_1_1basic__string.html">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="group__MiscUtils.html#ga4c4ecb9a3eb803ae6d9dee51e1e5b14"></a><br></td></tr> </table> </div> <!-- end main content --> <hr><address><small> Generated for glibmm 2.4 by <a href="http://www.doxygen.org/index.html"> Doxygen</a> 1.5.3 © 1997-2001</small></address> </body> </html>