Package org.javagi.base

Class GErrorException

java.lang.Object

java.lang.Throwable

java.lang.Exception

org.javagi.base.GErrorException

All Implemented Interfaces:

Serializable

@NullMarked
public class GErrorException
extends Exception

A GErrorException is thrown when a GError is returned by native code. See the Gtk documentation on error reporting for details about GError.

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
GErrorException(MemorySegment gerrorPtr)	Create a GErrorException from a GError memory segment that was returned by a native function.
GErrorException(Quark domain, int code, @Nullable String message, @Nullable Object... args)	Create a GErrorException that can be used to return a GError from a Java callback function to native code.

Method Summary

Modifier and Type	Method	Description
int	getCode()	Get the error code.
Quark	getDomain()	Get the error domain.
static boolean	isErrorSet(MemorySegment gerrorPtr)	Check if an error is set.
GError	toGError()	Create a new GError instance with the domain, code and message of this GErrorException.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

GErrorException

public GErrorException(MemorySegment gerrorPtr)

Create a GErrorException from a GError memory segment that was returned by a native function.

Parameters:

gerrorPtr - pointer to a GError in native memory

GErrorException

public GErrorException(Quark domain,
 int code,
 @Nullable String message,
 @Nullable Object... args)

Create a GErrorException that can be used to return a GError from a Java callback function to native code. See the Gtk documentation on error reporting for details.

Parameters:

domain - the GError error domain

code - the GError error code

message - the error message, printf-style formatted

args - varargs parameters for message format

Method Details

isErrorSet

public static boolean isErrorSet(MemorySegment gerrorPtr)

Check if an error is set.

Parameters:

gerrorPtr - pointer to a GError in native memory

Returns:

true when an error was set on this pointer

getCode

public int getCode()

Get the error code.

Returns:

the code of the GError

getDomain

public Quark getDomain()

Get the error domain.

Returns:

The domain of the GError

toGError

public GError toGError()

Create a new GError instance with the domain, code and message of this GErrorException.

Returns:

a newly created GError instance