Error#

class Error(message: str = 'unknown error', domain: str = 'pygi-error', code: int = 0) → None#

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

Attributes#

class Error
domain#

The error domain, usually a string that you can convert to a GLib quark with quark_from_string().

code#

A numeric code that identifies a specific error within the domain.

message#

A human-readable description of the error.

Methods#

class Error
matches(domain: str | int, code: int) → bool#

Returns True if error matches domain and code, False otherwise. In particular, when error is None, False will be returned.

If domain contains a FAILED (or otherwise generic) error code, you should generally not check for it explicitly, but should instead treat any not-explicitly-recognized error code as being equivalent to the FAILED code. This way, if the domain is extended in the future to provide a more specific error code for a certain case, your code will still work.

Parameters:

  • domain – an error domain

  • code – an error code

classmethod new_literal(domain: int, message: str, code: int) → GError#
Parameters:

  • domain

  • message

  • code