org.bridj

Class LastError

java.lang.Object

java.lang.Throwable

java.lang.Error

org.bridj.NativeError

org.bridj.LastError

All Implemented Interfaces:

Serializable

public class LastError
extends NativeError

Native error that correspond to the errno or GetLastError() mechanism.
Some C functions declare errors by marking an error code in errno or through SetLastError(int).
If you want their corresponding bindings to throw an exception whenever such an error was marked, simply make them throw this exception explicitly.
On Windows, BridJ will first check GetLastError(), then if no error was found it will check errno (on the other platforms only errno is available).
For instance, look at the following binding of the C-library strtoul function :

 @Library("c")
 public static native long strtoul(Pointer<Byte> str, Pointer<Pointer<Byte>> endptr, int base) throws LastError;
 

Author:

Olivier Chafik

See Also:

Serialized Form

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(Object o)
int	getCode() Native error code (as returned by errno or GetLastError()).
String	getDescription() Native error description (as returned by strerror or FormatMessage).
static LastError	getLastError()
String	getMessage()
int	hashCode()

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

getCode

public int getCode()

Native error code (as returned by errno or GetLastError()).

getDescription

public String getDescription()

Native error description (as returned by strerror or FormatMessage).

getMessage

public String getMessage()

Overrides:

getMessage in class Throwable

getLastError

public static LastError getLastError()