ErrorG

The GError structure contains information about an error that has occurred.

class ErrorG {

GError* gError;

bool ownedRef;

GError* getErrorGStruct(bool transferOwnership);

void* getStruct();

this(GError* gError, bool ownedRef);

this(GQuark domain, int code, string message);

this(GQuark domain, int code, string format, void* args);

ErrorG copy();

bool matches(GQuark domain, int code);

static GQuark domainRegister(string errorTypeName, size_t errorTypePrivateSize, GErrorInitFunc errorTypeInit, GErrorCopyFunc errorTypeCopy, GErrorClearFunc errorTypeClear);

static GQuark domainRegisterStatic(string errorTypeName, size_t errorTypePrivateSize, GErrorInitFunc errorTypeInit, GErrorCopyFunc errorTypeCopy, GErrorClearFunc errorTypeClear);

static void propagateError(ErrorG dest, ErrorG src);

static void setErrorLiteral(ErrorG err, GQuark domain, int code, string message);

}

Constructors

this this(GError* gError, bool ownedRef): Sets our main struct and passes it to the parent class.
this this(GQuark domain, int code, string message): Creates a new #GError; unlike g_error_new(), @message is not a printf()-style format string. Use this function if @message contains text you don't have control over, that could include printf() escape sequences.
this this(GQuark domain, int code, string format, void* args): Creates a new #GError with the given @domain and @code, and a message formatted with @format.

Destructor

~this ~this(): Undocumented in source.

Members

Functions

copy ErrorG copy(): Makes a copy of @error.
free void free(): Frees a #GError and associated resources.
getErrorGStruct GError* getErrorGStruct(bool transferOwnership): Get the main Gtk struct
getStruct void* getStruct(): the main Gtk struct as a void*
matches bool matches(GQuark domain, int code): Returns %TRUE if @error matches @domain and @code, %FALSE otherwise. In particular, when @error is %NULL, %FALSE will be returned.

Static functions

domainRegister GQuark domainRegister(string errorTypeName, size_t errorTypePrivateSize, GErrorInitFunc errorTypeInit, GErrorCopyFunc errorTypeCopy, GErrorClearFunc errorTypeClear): This function registers an extended #GError domain. @error_type_name will be duplicated. Otherwise does the same as g_error_domain_register_static().
domainRegisterStatic GQuark domainRegisterStatic(string errorTypeName, size_t errorTypePrivateSize, GErrorInitFunc errorTypeInit, GErrorCopyFunc errorTypeCopy, GErrorClearFunc errorTypeClear): This function registers an extended #GError domain.
propagateError void propagateError(ErrorG dest, ErrorG src): If @dest is %NULL, free @src; otherwise, moves @src into *@dest. The error variable @dest points to must be %NULL.
setErrorLiteral void setErrorLiteral(ErrorG err, GQuark domain, int code, string message): Does nothing if @err is %NULL; if @err is non-%NULL, then *@err must be %NULL. A new #GError is created and assigned to *@err. Unlike g_set_error(), @message is not a printf()-style format string. Use this function if @message contains text you don't have control over, that could include printf() escape sequences.

Variables

gError GError* gError;: the main Gtk struct
ownedRef bool ownedRef;: Undocumented in source.

Meta

Source

See Implementation

glib ErrorG classes

ErrorG