<!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: Glib::ConvertError Class Reference</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><a href="modules.html"><span>Modules</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> <li><a href="examples.html"><span>Examples</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="classes.html"><span>Class Index</span></a></li> <li><a href="inherits.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="namespaceGlib.html">Glib</a></li><li class="navelem"><a class="el" href="classGlib_1_1ConvertError.html">ConvertError</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="summary"> <a href="#pub-types">Public Types</a> | <a href="#pub-methods">Public Member Functions</a> | <a href="classGlib_1_1ConvertError-members.html">List of all members</a> </div> <div class="headertitle"> <div class="title">Glib::ConvertError Class Reference<div class="ingroups"><a class="el" href="group__CharsetConv.html">Character Set Conversion</a></div></div> </div> </div><!--header--> <div class="contents"> <p>Exception class for charset conversion errors. <a href="classGlib_1_1ConvertError.html#details">More...</a></p> <p><code>#include <glibmm/convert.h></code></p> <div class="dynheader"> Inheritance diagram for Glib::ConvertError:</div> <div class="dyncontent"> <div class="center"><img src="classGlib_1_1ConvertError__inherit__graph.png" border="0" usemap="#Glib_1_1ConvertError_inherit__map" alt="Inheritance graph"/></div> <map name="Glib_1_1ConvertError_inherit__map" id="Glib_1_1ConvertError_inherit__map"> <area shape="rect" id="node2" href="classGlib_1_1Error.html" title="Glib::Error" alt="" coords="31,80,118,107"/> <area shape="rect" id="node3" href="classGlib_1_1Exception.html" title="Glib::Exception" alt="" coords="15,5,135,32"/> </map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a> Public Types</h2></td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr class="memitem:a99da762bafb432b501a9adaa378e48e1"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1ConvertError.html#a99da762bafb432b501a9adaa378e48e1">ConvertError</a> (<a class="el" href="classGlib_1_1ConvertError.html#aea4b79ac3149c1fcfcab32155e3561a9">Code</a> error_code, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& error_message)</td></tr> <tr class="separator:a99da762bafb432b501a9adaa378e48e1"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a1f91f82109b547d84c67b1e6e4abc863"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1ConvertError.html#a1f91f82109b547d84c67b1e6e4abc863">ConvertError</a> (GError* gobject)</td></tr> <tr class="separator:a1f91f82109b547d84c67b1e6e4abc863"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a337140841bdec147d1e26406b566ebd1"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1ConvertError.html#aea4b79ac3149c1fcfcab32155e3561a9">Code</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1ConvertError.html#a337140841bdec147d1e26406b566ebd1">code</a> () const </td></tr> <tr class="separator:a337140841bdec147d1e26406b566ebd1"><td class="memSeparator" colspan="2"> </td></tr> <tr class="inherit_header pub_methods_classGlib_1_1Error"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_classGlib_1_1Error')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="classGlib_1_1Error.html">Glib::Error</a></td></tr> <tr class="memitem:a2639aeb2b6a6c43662cf17b8c88a122d inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a2639aeb2b6a6c43662cf17b8c88a122d">Error</a> ()</td></tr> <tr class="separator:a2639aeb2b6a6c43662cf17b8c88a122d inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a478576c835fb1d66e46076b4c2d19799 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a478576c835fb1d66e46076b4c2d19799">Error</a> (GQuark error_domain, int error_code, const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& message)</td></tr> <tr class="separator:a478576c835fb1d66e46076b4c2d19799 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a70257ceb030e4d9dd3ac9a6482830d24 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a70257ceb030e4d9dd3ac9a6482830d24">Error</a> (GError* gobject, bool take_copy=false)</td></tr> <tr class="separator:a70257ceb030e4d9dd3ac9a6482830d24 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a715ed79ccf7d2fa3a357014fc614a4a4 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a715ed79ccf7d2fa3a357014fc614a4a4">Error</a> (const <a class="el" href="classGlib_1_1Error.html">Error</a>& other)</td></tr> <tr class="separator:a715ed79ccf7d2fa3a357014fc614a4a4 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a6fd059d3c4d24c3f6a0f6999be41b138 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGlib_1_1Error.html">Error</a>& </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a6fd059d3c4d24c3f6a0f6999be41b138">operator=</a> (const <a class="el" href="classGlib_1_1Error.html">Error</a>& other)</td></tr> <tr class="separator:a6fd059d3c4d24c3f6a0f6999be41b138 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:aec934390eb92db0c3b335452363cbe5f inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#aec934390eb92db0c3b335452363cbe5f">~Error</a> () noexcept override</td></tr> <tr class="separator:aec934390eb92db0c3b335452363cbe5f inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a34e1f774a08c50c033d880a0bb59a499 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a34e1f774a08c50c033d880a0bb59a499">operator bool</a> () const </td></tr> <tr class="memdesc:a34e1f774a08c50c033d880a0bb59a499 inherit pub_methods_classGlib_1_1Error"><td class="mdescLeft"> </td><td class="mdescRight">Test whether the Error has an underlying instance. <a href="#a34e1f774a08c50c033d880a0bb59a499">More...</a><br /></td></tr> <tr class="separator:a34e1f774a08c50c033d880a0bb59a499 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a8d0366db925669aa5841f21e48f278c4 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top">GQuark </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a8d0366db925669aa5841f21e48f278c4">domain</a> () const </td></tr> <tr class="separator:a8d0366db925669aa5841f21e48f278c4 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a073623423095dc52db289bf04a146648 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a073623423095dc52db289bf04a146648">code</a> () const </td></tr> <tr class="separator:a073623423095dc52db289bf04a146648 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:af825f045a114422b6da3192627af0c7d inherit pub_methods_classGlib_1_1Error"><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="classGlib_1_1Error.html#af825f045a114422b6da3192627af0c7d">what</a> () const override</td></tr> <tr class="separator:af825f045a114422b6da3192627af0c7d inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a4a8818d3d0bb26a01a020dedd12c525d inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a4a8818d3d0bb26a01a020dedd12c525d">matches</a> (GQuark error_domain, int error_code) const </td></tr> <tr class="separator:a4a8818d3d0bb26a01a020dedd12c525d inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a69e6636c8ed726b1468ed61c07d65816 inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top">GError* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a69e6636c8ed726b1468ed61c07d65816">gobj</a> ()</td></tr> <tr class="separator:a69e6636c8ed726b1468ed61c07d65816 inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="memitem:a41b5a27b917ecb6a0176387bf357d8cc inherit pub_methods_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top">const GError* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#a41b5a27b917ecb6a0176387bf357d8cc">gobj</a> () const </td></tr> <tr class="separator:a41b5a27b917ecb6a0176387bf357d8cc inherit pub_methods_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> <tr class="inherit_header pub_methods_classGlib_1_1Exception"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_classGlib_1_1Exception')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="classGlib_1_1Exception.html">Glib::Exception</a></td></tr> <tr class="memitem:a51fb593b3bb4bf81999d00516ff0a613 inherit pub_methods_classGlib_1_1Exception"><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Exception.html#a51fb593b3bb4bf81999d00516ff0a613">~Exception</a> () noexcept=0</td></tr> <tr class="separator:a51fb593b3bb4bf81999d00516ff0a613 inherit pub_methods_classGlib_1_1Exception"><td class="memSeparator" colspan="2"> </td></tr> </table><table class="memberdecls"> <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="inherited"></a> Additional Inherited Members</h2></td></tr> <tr class="inherit_header pro_attribs_classGlib_1_1Error"><td colspan="2" onclick="javascript:toggleInherit('pro_attribs_classGlib_1_1Error')"><img src="closed.png" alt="-"/> Protected Attributes inherited from <a class="el" href="classGlib_1_1Error.html">Glib::Error</a></td></tr> <tr class="memitem:aaf45a78024403f011e31a73c1361c59a inherit pro_attribs_classGlib_1_1Error"><td class="memItemLeft" align="right" valign="top">GError* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGlib_1_1Error.html#aaf45a78024403f011e31a73c1361c59a">gobject_</a></td></tr> <tr class="separator:aaf45a78024403f011e31a73c1361c59a inherit pro_attribs_classGlib_1_1Error"><td class="memSeparator" colspan="2"> </td></tr> </table> <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> <div class="textblock"><p>Exception class for charset conversion errors. </p> <p><a class="el" href="group__CharsetConv.html#ga58f7e4556c436a96c64b186bbc8f7f4c" title="Convert from one encoding to another. ">Glib::convert()</a> and friends throw a <a class="el" href="classGlib_1_1ConvertError.html" title="Exception class for charset conversion errors. ">ConvertError</a> exception if the charset conversion failed for some reason. When writing non-trivial applications you should always catch those errors, and then try to recover, or tell the user the input was invalid. </p> </div><h2 class="groupheader">Member Enumeration Documentation</h2> <a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">enum <a class="el" href="classGlib_1_1ConvertError.html#aea4b79ac3149c1fcfcab32155e3561a9">Glib::ConvertError::Code</a></td> </tr> </table> </div><div class="memdoc"> <p>Error codes returned by character set conversion routines. </p> <table class="fieldtable"> <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9aa8709c19293fcc2268bb94f954c3270b"></a>NO_CONVERSION </td><td class="fielddoc"> <p>Conversion between the requested character sets is not supported. </p> </td></tr> <tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9a78ad26d8d7b6f5dabfd812747508275e"></a>ILLEGAL_SEQUENCE </td><td class="fielddoc"> <p>Invalid byte sequence in conversion input; or the character sequence could not be represented in the target character set. </p> </td></tr> <tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9a524094cf11090f1fb867377b610ea18c"></a>FAILED </td><td class="fielddoc"> <p>Conversion failed for some reason. </p> </td></tr> <tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9adc0c28f2874c32775af10fe17d8a759f"></a>PARTIAL_INPUT </td><td class="fielddoc"> <p>Partial character sequence at end of input. </p> </td></tr> <tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9aeb7b776a181c04ac19786f644a588a5f"></a>BAD_URI </td><td class="fielddoc"> <p>URI is invalid. </p> </td></tr> <tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9a0e75360bea5f8bd367d438f38c797272"></a>NOT_ABSOLUTE_PATH </td><td class="fielddoc"> <p>Pathname is not an absolute path. </p> </td></tr> <tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9a49b0bc3839008ac3f161b573044d0cf1"></a>NO_MEMORY </td><td class="fielddoc"> <p>No memory available. </p> <dl class="since_2_40"><dt><b><a class="el" href="since_2_40.html#_since_2_40000001">Since glibmm 2.40:</a></b></dt><dd></dd></dl> </td></tr> <tr><td class="fieldname"><a class="anchor" id="aea4b79ac3149c1fcfcab32155e3561a9a77a5242d6c4124a27c8d27ff953097c4"></a>EMBEDDED_NUL </td><td class="fielddoc"> <p>An embedded NUL character is present in conversion output where a NUL-terminated string is expected. </p> <dl class="since_2_56"><dt><b><a class="el" href="since_2_56.html#_since_2_56000001">Since glibmm 2.56:</a></b></dt><dd></dd></dl> </td></tr> </table> </div> </div> <h2 class="groupheader">Constructor & Destructor Documentation</h2> <a class="anchor" id="a99da762bafb432b501a9adaa378e48e1"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Glib::ConvertError::ConvertError </td> <td>(</td> <td class="paramtype"><a class="el" href="classGlib_1_1ConvertError.html#aea4b79ac3149c1fcfcab32155e3561a9">Code</a> </td> <td class="paramname"><em>error_code</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const <a class="el" href="classGlib_1_1ustring.html">Glib::ustring</a>& </td> <td class="paramname"><em>error_message</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div><div class="memdoc"> </div> </div> <a class="anchor" id="a1f91f82109b547d84c67b1e6e4abc863"></a> <div class="memitem"> <div class="memproto"> <table class="mlabels"> <tr> <td class="mlabels-left"> <table class="memname"> <tr> <td class="memname">Glib::ConvertError::ConvertError </td> <td>(</td> <td class="paramtype">GError * </td> <td class="paramname"><em>gobject</em></td><td>)</td> <td></td> </tr> </table> </td> <td class="mlabels-right"> <span class="mlabels"><span class="mlabel">explicit</span></span> </td> </tr> </table> </div><div class="memdoc"> </div> </div> <h2 class="groupheader">Member Function Documentation</h2> <a class="anchor" id="a337140841bdec147d1e26406b566ebd1"></a> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGlib_1_1ConvertError.html#aea4b79ac3149c1fcfcab32155e3561a9">Code</a> Glib::ConvertError::code </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div><div class="memdoc"> </div> </div> </div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated on Tue Mar 19 2019 09:56:45 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>