<!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>Miscellaneous Utility Functions</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="../../index.html">Main Page</a>
<a href="group__Widgets.html">Widgets</a>
<a class="qindex" href="namespaces.html"> Namespaces</a>
<a href="../../tutorial/html/index.html"> Book</a>
</center>
<hr width="100%"/>
<!-- Generated by Doxygen 1.3-rc1 -->
<h1>Miscellaneous Utility Functions</h1>Miscellaneous Utility Functions -- a selection of portable utility functions.
<a href="#_details">More...</a><table border=0 cellpadding=0 cellspacing=0>
<tr><td></td></tr>
<tr><td colspan=2><br><h2>Functions</h2></td></tr>
<tr><td nowrap align=right valign=top><a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a0">get_application_name</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Gets a human-readable name for the application, as set by <a class="el" href="group__MiscUtils.html#a1">Glib::set_application_name()</a>.</em> <a href="#a0"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a1">set_application_name</a> (const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& application_name)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets a human-readable name for the application.</em> <a href="#a1"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a2">get_prgname</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the name of the program.</em> <a href="#a2"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>void </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a3">set_prgname</a> (const std::string& prgname)</td></tr>
<tr><td> </td><td><font size=-1><em>Sets the name of the program.</em> <a href="#a3"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a4">getenv</a> (const std::string& variable, bool& found)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns an environment variable.</em> <a href="#a4"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a5">getenv</a> (const std::string& variable)</td></tr>
<tr><td> </td><td><font size=-1><em>Returns an environment variable.</em> <a href="#a5"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a6">get_user_name</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the user name of the current user.</em> <a href="#a6"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a7">get_real_name</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the real name of the user.</em> <a href="#a7"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a8">get_home_dir</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the current user's home directory.</em> <a href="#a8"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a9">get_tmp_dir</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the directory to use for temporary files.</em> <a href="#a9"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a10">get_current_dir</a> ()</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the current directory.</em> <a href="#a10"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>bool </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a11">path_is_absolute</a> (const std::string& filename)</td></tr>
<tr><td> </td><td><font size=-1><em>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.</em> <a href="#a11"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a12">path_skip_root</a> (const std::string& filename)</td></tr>
<tr><td> </td><td><font size=-1><em>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.</em> <a href="#a12"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a13">path_get_basename</a> (const std::string& filename)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the name of the file without any leading directory components.</em> <a href="#a13"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a14">path_get_dirname</a> (const std::string& filename)</td></tr>
<tr><td> </td><td><font size=-1><em>Gets the directory components of a file name.</em> <a href="#a14"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a15">build_filename</a> (const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><std::string>& elements)</td></tr>
<tr><td> </td><td><font size=-1><em>Creates a filename from a series of elements using the correct separator for filenames.</em> <a href="#a15"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a16">build_filename</a> (const std::string& elem1, const std::string& elem2)</td></tr>
<tr><td> </td><td><font size=-1><em>Creates a filename from two elements using the correct separator for filenames.</em> <a href="#a16"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a17">build_path</a> (const std::string& separator, const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><std::string>& elements)</td></tr>
<tr><td> </td><td><font size=-1><em>Creates a path from a series of elements using <em>separator</em> as the separator between elements.</em> <a href="#a17"></a><em></em></font><br><br></td></tr>
<tr><td nowrap align=right valign=top>std::string </td><td valign=bottom><a class="el" href="group__MiscUtils.html#a18">find_program_in_path</a> (const std::string& program)</td></tr>
<tr><td> </td><td><font size=-1><em>Locates the first executable named <em>program</em> in the user's path, in the same way that <code>execvp()</code> would locate it.</em> <a href="#a18"></a><em></em></font><br><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
Miscellaneous Utility Functions -- a selection of portable utility functions.
<p>
<hr><h2>Function Documentation</h2>
<a name="a16" doxytag="Glib::build_filename"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string build_filename </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname" nowrap> <em>elem1</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const std::string& </td>
<td class="mdname" nowrap> <em>elem2</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Creates a filename from two elements using the correct separator for filenames.
<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. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>elem1</em> </td><td>First path element. </td></tr>
<tr><td valign=top><em>elem2</em> </td><td>Second path element. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The resulting path. </dd></dl>
</td>
</tr>
</table>
<a name="a15" doxytag="Glib::build_filename"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string build_filename </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><std::string>& </td>
<td class="mdname1" valign="top" nowrap> <em>elements</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Creates a filename from a series of elements using the correct separator for filenames.
<p>
This function behaves identically to Glib::build_path(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. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><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>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The resulting path. </dd></dl>
</td>
</tr>
</table>
<a name="a17" doxytag="Glib::build_path"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string build_path </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname" nowrap> <em>separator</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>const <a class="el" href="classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><std::string>& </td>
<td class="mdname" nowrap> <em>elements</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Creates a path from a series of elements using <em>separator</em> as the separator between elements.
<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. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>separator</em> </td><td>A string used to separate the elements of the path. </td></tr>
<tr><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>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The resulting path. </dd></dl>
</td>
</tr>
</table>
<a name="a18" doxytag="Glib::find_program_in_path"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string find_program_in_path </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname1" valign="top" nowrap> <em>program</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<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>
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>
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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>program</em> </td><td>A program name. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>An absolute path, or <code>""</code>. </dd></dl>
</td>
</tr>
</table>
<a name="a0" doxytag="Glib::get_application_name"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a> get_application_name </td>
<td class="md" valign="top">(</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets a human-readable name for the application, as set by <a class="el" href="group__MiscUtils.html#a1">Glib::set_application_name()</a>.
<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#a2">Glib::get_prgname()</a>, which gets a non-localized name. If <a class="el" href="group__MiscUtils.html#a1">Glib::set_application_name()</a> has not been called, returns the result of <a class="el" href="group__MiscUtils.html#a2">Glib::get_prgname()</a> (which may be empty if <a class="el" href="group__MiscUtils.html#a3">Glib::set_prgname()</a> has also not been called).
<p>
<dl compact><dt><b>Returns:</b></dt><dd>Human-readable application name. May return <code>""</code>. </dd></dl>
</td>
</tr>
</table>
<a name="a10" doxytag="Glib::get_current_dir"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string get_current_dir </td>
<td class="md" valign="top">(</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the current directory.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>The current directory. </dd></dl>
</td>
</tr>
</table>
<a name="a8" doxytag="Glib::get_home_dir"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string get_home_dir </td>
<td class="md" valign="top">(</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the current user's home directory.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>The current user's home directory. </dd></dl>
</td>
</tr>
</table>
<a name="a2" doxytag="Glib::get_prgname"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string get_prgname </td>
<td class="md" valign="top">(</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the name of the program.
<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>. <dl compact><dt><b>Returns:</b></dt><dd>The name of the program. </dd></dl>
</td>
</tr>
</table>
<a name="a7" doxytag="Glib::get_real_name"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string get_real_name </td>
<td class="md" valign="top">(</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the real name of the user.
<p>
This usually comes from the user's entry in the <code>passwd</code> file. <dl compact><dt><b>Returns:</b></dt><dd>The user's real name. </dd></dl>
</td>
</tr>
</table>
<a name="a9" doxytag="Glib::get_tmp_dir"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string get_tmp_dir </td>
<td class="md" valign="top">(</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the directory to use for temporary files.
<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. <dl compact><dt><b>Returns:</b></dt><dd>The directory to use for temporary files. </dd></dl>
</td>
</tr>
</table>
<a name="a6" doxytag="Glib::get_user_name"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string get_user_name </td>
<td class="md" valign="top">(</td>
<td class="mdname1" valign="top" nowrap> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the user name of the current user.
<p>
<dl compact><dt><b>Returns:</b></dt><dd>The name of the current user. </dd></dl>
</td>
</tr>
</table>
<a name="a5" doxytag="Glib::getenv"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string getenv </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname1" valign="top" nowrap> <em>variable</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns an environment variable.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>variable</em> </td><td>The environment variable to get. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The value of the environment variable, or <code>""</code> if not found. </dd></dl>
</td>
</tr>
</table>
<a name="a4" doxytag="Glib::getenv"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string getenv </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname" nowrap> <em>variable</em>, </td>
</tr>
<tr>
<td></td>
<td></td>
<td class="md" nowrap>bool& </td>
<td class="mdname" nowrap> <em>found</em></td>
</tr>
<tr>
<td></td>
<td class="md">) </td>
<td class="md" colspan="2"></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Returns an environment variable.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>variable</em> </td><td>The environment variable to get. </td></tr>
</table>
</dl>
<dl compact><dt><b>Return values:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>found</em> </td><td><code>true</code> if the environment variable has been found. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The value of the environment variable, or <code>""</code> if not found. </dd></dl>
</td>
</tr>
</table>
<a name="a13" doxytag="Glib::path_get_basename"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string path_get_basename </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname1" valign="top" nowrap> <em>filename</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the name of the file without any leading directory components.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>filename</em> </td><td>The name of the file. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The name of the file without any leading directory components. </dd></dl>
</td>
</tr>
</table>
<a name="a14" doxytag="Glib::path_get_dirname"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string path_get_dirname </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname1" valign="top" nowrap> <em>filename</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Gets the directory components of a file name.
<p>
If the file name has no directory components <code>"."</code> is returned. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>filename</em> </td><td>The name of the file. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The directory components of the file. </dd></dl>
</td>
</tr>
</table>
<a name="a11" doxytag="Glib::path_is_absolute"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> bool path_is_absolute </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname1" valign="top" nowrap> <em>filename</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>filename</em> </td><td>A file name. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Whether <em>filename</em> is an absolute path. </dd></dl>
</td>
</tr>
</table>
<a name="a12" doxytag="Glib::path_skip_root"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> std::string path_skip_root </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname1" valign="top" nowrap> <em>filename</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<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>
If <em>filename</em> is not an absolute path, <code>""</code> will be returned. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>filename</em> </td><td>A file name. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The file name without the root component, or <code>""</code>. </dd></dl>
</td>
</tr>
</table>
<a name="a1" doxytag="Glib::set_application_name"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void set_application_name </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td>
<td class="mdname1" valign="top" nowrap> <em>application_name</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets a human-readable name for the application.
<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#a3">Glib::set_prgname()</a>, which sets a non-localized name. <a class="el" href="group__MiscUtils.html#a3">Glib::set_prgname()</a> will be called automatically by <code>gtk_init()</code>, but <a class="el" href="group__MiscUtils.html#a1">Glib::set_application_name()</a> will not.
<p>
Note that for thread safety reasons, this function can only be called once.
<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 compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>application_name</em> </td><td>Localized name of the application. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<a name="a3" doxytag="Glib::set_prgname"></a><p>
<table width="100%" cellpadding="2" cellspacing="0" border="0">
<tr>
<td class="md">
<table cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="md" nowrap valign="top"> void set_prgname </td>
<td class="md" valign="top">(</td>
<td class="md" nowrap valign="top">const std::string& </td>
<td class="mdname1" valign="top" nowrap> <em>prgname</em> </td>
<td class="md" valign="top">) </td>
<td class="md" nowrap></td>
</tr>
</table>
</td>
</tr>
</table>
<table cellspacing=5 cellpadding=0 border=0>
<tr>
<td>
</td>
<td>
<p>
Sets the name of the program.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign=top><em>prgname</em> </td><td>The name of the program. </td></tr>
</table>
</dl>
</td>
</tr>
</table>
<hr><address><small>
Generated for gtkmm by <a href="http://www.doxygen.org/index.html">
Doxygen</a> 1.3-rc1 © 1997-2001</small></address>
</body>
</html>
