<!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"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.11"/> <title>glibmm: String Utility Functions</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> <link href="doxygen-extra.css" rel="stylesheet" type="text/css"/> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td id="projectalign" style="padding-left: 0.5em;"> <div id="projectname">glibmm  <span id="projectnumber">2.60.0</span> </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.11 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li class="current"><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><!-- top --> <div class="header"> <div class="summary"> <a href="#func-members">Functions</a> </div> <div class="headertitle"> <div class="title">String Utility Functions</div> </div> </div><!--header--> <div class="contents"> <p>This section describes a number of utility functions for creating and manipulating strings, as well as other string-related stuff. <a href="#details">More...</a></p> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> Functions</h2></td></tr> <tr class="memitem:ga6b7e8354049756e92a97554a107618ac"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#ga6b7e8354049756e92a97554a107618ac">Glib::str_has_prefix</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& str, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& prefix)</td></tr> <tr class="memdesc:ga6b7e8354049756e92a97554a107618ac"><td class="mdescLeft"> </td><td class="mdescRight">Looks whether the string <em>str</em> begins with <em>prefix</em>. <a href="group__StringUtils.html#ga6b7e8354049756e92a97554a107618ac">More...</a><br /></td></tr> <tr class="separator:ga6b7e8354049756e92a97554a107618ac"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ga5c4e380ffc6617ac61ca92e203e45630"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#ga5c4e380ffc6617ac61ca92e203e45630">Glib::str_has_suffix</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& str, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& suffix)</td></tr> <tr class="memdesc:ga5c4e380ffc6617ac61ca92e203e45630"><td class="mdescLeft"> </td><td class="mdescRight">Looks whether the string <em>str</em> ends with <em>suffix</em>. <a href="group__StringUtils.html#ga5c4e380ffc6617ac61ca92e203e45630">More...</a><br /></td></tr> <tr class="separator:ga5c4e380ffc6617ac61ca92e203e45630"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:gaa44aba9faa6575d4881b1fe779464f6b"><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#gaa44aba9faa6575d4881b1fe779464f6b">Glib::Ascii::strtod</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& str)</td></tr> <tr class="memdesc:gaa44aba9faa6575d4881b1fe779464f6b"><td class="mdescLeft"> </td><td class="mdescRight">Converts a string to a <code>double</code> value. <a href="group__StringUtils.html#gaa44aba9faa6575d4881b1fe779464f6b">More...</a><br /></td></tr> <tr class="separator:gaa44aba9faa6575d4881b1fe779464f6b"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ga6465a8320d790115c41a2c76d1d3233c"><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#ga6465a8320d790115c41a2c76d1d3233c">Glib::Ascii::strtod</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& str, std::string::size_type& end_index, std::string::size_type start_index=0)</td></tr> <tr class="memdesc:ga6465a8320d790115c41a2c76d1d3233c"><td class="mdescLeft"> </td><td class="mdescRight">Converts a string to a <code>double</code> value. <a href="group__StringUtils.html#ga6465a8320d790115c41a2c76d1d3233c">More...</a><br /></td></tr> <tr class="separator:ga6465a8320d790115c41a2c76d1d3233c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:gac740e6c99bca5896ccbfc12b621491ac"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#gac740e6c99bca5896ccbfc12b621491ac">Glib::Ascii::dtostr</a> (double d)</td></tr> <tr class="memdesc:gac740e6c99bca5896ccbfc12b621491ac"><td class="mdescLeft"> </td><td class="mdescRight">Converts a <code>double</code> to a string, using the <code>'</code>. <a href="group__StringUtils.html#gac740e6c99bca5896ccbfc12b621491ac">More...</a><br /></td></tr> <tr class="separator:gac740e6c99bca5896ccbfc12b621491ac"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ga35e288b5ce34cb15eeec907421d2b77c"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#ga35e288b5ce34cb15eeec907421d2b77c">Glib::strescape</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& source)</td></tr> <tr class="memdesc:ga35e288b5ce34cb15eeec907421d2b77c"><td class="mdescLeft"> </td><td class="mdescRight">Escapes all special characters in the string. <a href="group__StringUtils.html#ga35e288b5ce34cb15eeec907421d2b77c">More...</a><br /></td></tr> <tr class="separator:ga35e288b5ce34cb15eeec907421d2b77c"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:gad24f3547c8d6b3ec56d7f5805a11d6ab"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#gad24f3547c8d6b3ec56d7f5805a11d6ab">Glib::strescape</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& source, const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& exceptions)</td></tr> <tr class="memdesc:gad24f3547c8d6b3ec56d7f5805a11d6ab"><td class="mdescLeft"> </td><td class="mdescRight">Escapes all special characters in the string. <a href="group__StringUtils.html#gad24f3547c8d6b3ec56d7f5805a11d6ab">More...</a><br /></td></tr> <tr class="separator:gad24f3547c8d6b3ec56d7f5805a11d6ab"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ga85cd83bd40baf0119aac3ff0a9a5e7b2"><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__StringUtils.html#ga85cd83bd40baf0119aac3ff0a9a5e7b2">Glib::strcompress</a> (const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a>& source)</td></tr> <tr class="memdesc:ga85cd83bd40baf0119aac3ff0a9a5e7b2"><td class="mdescLeft"> </td><td class="mdescRight">Replaces all escaped characters with their one byte equivalent. <a href="group__StringUtils.html#ga85cd83bd40baf0119aac3ff0a9a5e7b2">More...</a><br /></td></tr> <tr class="separator:ga85cd83bd40baf0119aac3ff0a9a5e7b2"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ga1eb869894996c91c0f69dbff96714c71"><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__StringUtils.html#ga1eb869894996c91c0f69dbff96714c71">Glib::strerror</a> (int errnum)</td></tr> <tr class="memdesc:ga1eb869894996c91c0f69dbff96714c71"><td class="mdescLeft"> </td><td class="mdescRight">Returns a string corresponding to the given error code, e.g. <code>"no such process"</code>. <a href="group__StringUtils.html#ga1eb869894996c91c0f69dbff96714c71">More...</a><br /></td></tr> <tr class="separator:ga1eb869894996c91c0f69dbff96714c71"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:ga44ce9f689aff8abe1e3073b209f360d3"><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__StringUtils.html#ga44ce9f689aff8abe1e3073b209f360d3">Glib::strsignal</a> (int signum)</td></tr> <tr class="memdesc:ga44ce9f689aff8abe1e3073b209f360d3"><td class="mdescLeft"> </td><td class="mdescRight">Returns a string describing the given signal, e.g. <code>"Segmentation fault"</code>. <a href="group__StringUtils.html#ga44ce9f689aff8abe1e3073b209f360d3">More...</a><br /></td></tr> <tr class="separator:ga44ce9f689aff8abe1e3073b209f360d3"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <p>This section describes a number of utility functions for creating and manipulating strings, as well as other string-related stuff. </p> <h2 class="groupheader">Function Documentation</h2> <a class="anchor" id="gac740e6c99bca5896ccbfc12b621491ac"></a> <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/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::Ascii::dtostr </td> <td>(</td> <td class="paramtype">double </td> <td class="paramname"><em>d</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Converts a <code>double</code> to a string, using the <code>'</code>. </p> <p>' as decimal point.</p> <p>This functions generates enough precision that converting the string back using <a class="el" href="group__StringUtils.html#gaa44aba9faa6575d4881b1fe779464f6b" title="Converts a string to a double value. ">Glib::Ascii::strtod()</a> gives the same machine-number (on machines with IEEE compatible 64bit doubles).</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">d</td><td>The <code>double</code> value to convert. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>The converted string. </dd></dl> </div> </div> <a class="anchor" id="ga6b7e8354049756e92a97554a107618ac"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool Glib::str_has_prefix </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>str</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/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>prefix</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Looks whether the string <em>str</em> begins with <em>prefix</em>. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">str</td><td>A string. </td></tr> <tr><td class="paramname">prefix</td><td>The prefix to look for. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd><code>true</code> if <em>str</em> begins with <em>prefix</em>, <code>false</code> otherwise. </dd></dl> </div> </div> <a class="anchor" id="ga5c4e380ffc6617ac61ca92e203e45630"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">bool Glib::str_has_suffix </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>str</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/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>suffix</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Looks whether the string <em>str</em> ends with <em>suffix</em>. </p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">str</td><td>A string. </td></tr> <tr><td class="paramname">suffix</td><td>The suffix to look for. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd><code>true</code> if <em>str</em> ends with <em>suffix</em>, <code>false</code> otherwise. </dd></dl> </div> </div> <a class="anchor" id="ga85cd83bd40baf0119aac3ff0a9a5e7b2"></a> <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/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::strcompress </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>source</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Replaces all escaped characters with their one byte equivalent. </p> <p>This function does the reverse conversion of <a class="el" href="group__StringUtils.html#ga35e288b5ce34cb15eeec907421d2b77c" title="Escapes all special characters in the string. ">Glib::strescape()</a>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">source</td><td>A string to compress. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>A copy of <em>source</em> with all escaped characters compressed. </dd></dl> </div> </div> <a class="anchor" id="ga1eb869894996c91c0f69dbff96714c71"></a> <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::strerror </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>errnum</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Returns a string corresponding to the given error code, e.g. <code>"no such process"</code>. </p> <p>This function is included since not all platforms support the <code>strerror()</code> function.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">errnum</td><td>The system error number. See the standard C <code>errno</code> documentation. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>A string describing the error code. If the error code is unknown, <code>"unknown error (<em><errnum></em>)"</code> is returned. </dd></dl> </div> </div> <a class="anchor" id="ga35e288b5ce34cb15eeec907421d2b77c"></a> <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/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::strescape </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>source</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Escapes all special characters in the string. </p> <p>Escapes the special characters <code>'\b'</code>, <code>'\f'</code>, <code>'\n'</code>, <code>'\r'</code>, <code>'\t'</code>, <code>'\'</code> and <code>'"'</code> in the string <em>source</em> by inserting a <code>'\'</code> before them. Additionally all characters in the range <code>0x01</code> - <code>0x1F</code> (everything below <code>SPACE</code>) and in the range <code>0x80</code> - <code>0xFF</code> (all non-ASCII chars) are replaced with a <code>'\'</code> followed by their octal representation.</p> <p><a class="el" href="group__StringUtils.html#ga85cd83bd40baf0119aac3ff0a9a5e7b2" title="Replaces all escaped characters with their one byte equivalent. ">Glib::strcompress()</a> does the reverse conversion.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">source</td><td>A string to escape. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>A copy of <em>source</em> with certain characters escaped. See above. </dd></dl> </div> </div> <a class="anchor" id="gad24f3547c8d6b3ec56d7f5805a11d6ab"></a> <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/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> Glib::strescape </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>source</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/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>exceptions</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Escapes all special characters in the string. </p> <p>Escapes the special characters <code>'\b'</code>, <code>'\f'</code>, <code>'\n'</code>, <code>'\r'</code>, <code>'\t'</code>, <code>'\'</code> and <code>'"'</code> in the string <em>source</em> by inserting a <code>'\'</code> before them. Additionally all characters in the range <code>0x01</code> - <code>0x1F</code> (everything below <code>SPACE</code>) and in the range <code>0x80</code> - <code>0xFF</code> (all non-ASCII chars) are replaced with a <code>'\'</code> followed by their octal representation. Characters supplied in <em>exceptions</em> are not escaped.</p> <p><a class="el" href="group__StringUtils.html#ga85cd83bd40baf0119aac3ff0a9a5e7b2" title="Replaces all escaped characters with their one byte equivalent. ">Glib::strcompress()</a> does the reverse conversion.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">source</td><td>A string to escape. </td></tr> <tr><td class="paramname">exceptions</td><td>A string of characters not to escape in <em>source</em>. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>A copy of <em>source</em> with certain characters escaped. See above. </dd></dl> </div> </div> <a class="anchor" id="ga44ce9f689aff8abe1e3073b209f360d3"></a> <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::strsignal </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>signum</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Returns a string describing the given signal, e.g. <code>"Segmentation fault"</code>. </p> <p>This function is included since not all platforms support the <code>strsignal()</code> function.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">signum</td><td>The signal number. See the <code>signal()</code> documentation. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>A string describing the signal. If the signal is unknown, <code>"unknown signal (<em><signum></em>)"</code> is returned. </dd></dl> </div> </div> <a class="anchor" id="gaa44aba9faa6575d4881b1fe779464f6b"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">double Glib::Ascii::strtod </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>str</em></td><td>)</td> <td></td> </tr> </table> </div><div class="memdoc"> <p>Converts a string to a <code>double</code> value. </p> <p>This function behaves like the standard <code>strtod()</code> function does in the C locale. It does this without actually changing the current locale, since that would not be thread-safe.</p> <p>This function is typically used when reading configuration files or other non-user input that should be locale independent. To handle input from the user you should normally use locale-sensitive C++ streams.</p> <p>To convert from a string to <code>double</code> in a locale-insensitive way, use <a class="el" href="group__StringUtils.html#gac740e6c99bca5896ccbfc12b621491ac" title="Converts a double to a string, using the '. ">Glib::Ascii::dtostr()</a>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramname">str</td><td>The string to convert to a numeric value. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>The <code>double</code> value. </dd></dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a02928.html">std::overflow_error</a></td><td>Thrown if the correct value would cause overflow. </td></tr> <tr><td class="paramname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a02932.html">std::underflow_error</a></td><td>Thrown if the correct value would cause underflow. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="ga6465a8320d790115c41a2c76d1d3233c"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">double Glib::Ascii::strtod </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01512.html#ga32db3d9898c44d3b3a578b560f7758cc">std::string</a> & </td> <td class="paramname"><em>str</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">std::string::size_type & </td> <td class="paramname"><em>end_index</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">std::string::size_type </td> <td class="paramname"><em>start_index</em> = <code>0</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> <p>Converts a string to a <code>double</code> value. </p> <p>This function behaves like the standard <code>strtod()</code> function does in the C locale. It does this without actually changing the current locale, since that would not be thread-safe.</p> <p>This function is typically used when reading configuration files or other non-user input that should be locale independent. To handle input from the user you should normally use locale-sensitive C++ streams.</p> <p>To convert from a string to <code>double</code> in a locale-insensitive way, use <a class="el" href="group__StringUtils.html#gac740e6c99bca5896ccbfc12b621491ac" title="Converts a double to a string, using the '. ">Glib::Ascii::dtostr()</a>.</p> <dl class="params"><dt>Parameters</dt><dd> <table class="params"> <tr><td class="paramdir"></td><td class="paramname">str</td><td>The string to convert to a numeric value. </td></tr> <tr><td class="paramdir"></td><td class="paramname">start_index</td><td>The index of the first character that should be used in the conversion. </td></tr> <tr><td class="paramdir">[out]</td><td class="paramname">end_index</td><td>The index of the character after the last character used in the conversion. </td></tr> </table> </dd> </dl> <dl class="section return"><dt>Returns</dt><dd>The <code>double</code> value. </dd></dl> <dl class="exception"><dt>Exceptions</dt><dd> <table class="exception"> <tr><td class="paramname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a02916.html">std::out_of_range</a></td><td>Thrown if <em>start_index</em> is out of range. </td></tr> <tr><td class="paramname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a02928.html">std::overflow_error</a></td><td>Thrown if the correct value would cause overflow. </td></tr> <tr><td class="paramname"><a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a02932.html">std::underflow_error</a></td><td>Thrown if the correct value would cause underflow. </td></tr> </table> </dd> </dl> </div> </div> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Tue Mar 19 2019 09:56:38 for glibmm by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.11 </small></address> </body> </html>