glibmm: Glib::ConvertError Class Reference

Exception class for charset conversion errors. More...

#include <glibmm/convert.h>

Inheritance diagram for Glib::ConvertError:

Public Types

Public Member Functions

 ConvertError (Code error_code, const Glib::ustring& error_message)
 ConvertError (GError* gobject)
Code code () const
- Public Member Functions inherited from Glib::Error
 Error ()
 Error (GQuark error_domain, int error_code, const Glib::ustring& message)
 Error (GError* gobject, bool take_copy=false)
 Error (const Error& other)
Erroroperator= (const Error& other)
 ~Error () noexcept override
 operator bool () const
 Test whether the Error has an underlying instance. More...

GQuark domain () const
int code () const
const char* what () const noexcept override
bool matches (GQuark error_domain, int error_code) const
GError* gobj ()
const GError* gobj () const

Additional Inherited Members

- Protected Attributes inherited from Glib::Error
GError* gobject_

Detailed Description

Exception class for charset conversion errors.

Glib::convert() and friends throw a ConvertError 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.

Member Enumeration Documentation

Error codes returned by character set conversion routines.


Conversion between the requested character sets is not supported.


Invalid byte sequence in conversion input; or the character sequence could not be represented in the target character set.


Conversion failed for some reason.


Partial character sequence at end of input.


URI is invalid.


Pathname is not an absolute path.


No memory available.

Since glibmm 2.40:

An embedded NUL character is present in conversion output where a NUL-terminated string is expected.

Since glibmm 2.56:

Constructor & Destructor Documentation

Glib::ConvertError::ConvertError ( Code  error_code,
const Glib::ustring error_message 
Glib::ConvertError::ConvertError ( GError *  gobject)

Member Function Documentation

Code Glib::ConvertError::code ( ) const