6777a49b1f
git-svn-id: https://swig.svn.sourceforge.net/svnroot/swig/trunk/SWIG@7550 626c5289-ae23-0410-ae9c-e8d60b6d4f22
113 lines
3.3 KiB
OpenEdge ABL
113 lines
3.3 KiB
OpenEdge ABL
/* This is a rather sophisticated example that illustrates exception handling,
|
|
templates, and shadow classes.
|
|
|
|
(i) The %exception directive is used to attach exception handlers
|
|
to specific methods.
|
|
|
|
(ii) Exception classes are automatically converted to shadow class
|
|
objects.
|
|
|
|
(iii) The %template directive is used to expand the templates
|
|
*/
|
|
|
|
%module example
|
|
|
|
%{
|
|
#include "example.h"
|
|
%}
|
|
|
|
/* Define some exception handlers for specific methods. In
|
|
the header file, the enqueue method throws FullError and
|
|
the dequeue method throws EmptyError. Since we don't
|
|
want to define an exception handler for everything, we
|
|
simply write a handler each method individually.
|
|
|
|
Note: the *::enqueue syntax means that we simply define
|
|
the handler for any class with this method defined.
|
|
*/
|
|
|
|
/*
|
|
First we need to 'disable' the default swig throw mechanism for the
|
|
FullError class. We do this by rethrowing the exception.
|
|
|
|
Note that this is necessary since the class appears in a throw
|
|
declaration:
|
|
|
|
|
|
void enqueue(T x) throw(FullError);
|
|
|
|
hence, swig recognizes it as an exception class and it will generate
|
|
the necessary code to catch it and rethrow it to the python side.
|
|
|
|
*/
|
|
%typemap(throws) FullError "throw;";
|
|
|
|
|
|
%exception *::enqueue {
|
|
try {
|
|
$action
|
|
} catch(FullError& e) {
|
|
FullError *ecopy = new FullError(e);
|
|
PyObject *err = SWIG_NewPointerObj(ecopy, SWIGTYPE_p_FullError, 1);
|
|
PyErr_SetObject((PyObject *) SWIGTYPE_p_FullError->clientdata, err);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
/* Some notes about the code above:
|
|
|
|
(0) $action gets replaced with the actual method call.
|
|
|
|
(1) We are going to return a copy of the exception object (FullError)
|
|
to pass back to the Python interpreter. This is why the copy
|
|
constructor is being called.
|
|
|
|
(2) The SWIG_NewPointerObj() call automatically wraps the exception object
|
|
into a shadow class. The SWIGTYPE_p_FullError is the type-descriptor
|
|
used for type checking. The "1" indicates that Python will have
|
|
ownership of the resulting object.
|
|
|
|
(3) The PyErr_SetObject call sets the Python exception. However,
|
|
the SWIGTYPE_p_FullError->clientdata reference may not be
|
|
obvious. This is actually the Python shadow class object
|
|
for FullError. Recall that in Python, exceptions are defined
|
|
as classes. Therefore, this works perfectly as the argument to
|
|
PyErr_SetObject()! A neat trick perhaps.
|
|
*/
|
|
|
|
/*
|
|
Now, the EmpytError doesn't appear in a throw declaration, and hence
|
|
we need to 'mark' it as an exception class. In python, classes that
|
|
are used as exception are 'special', and need to be wrapped as
|
|
'classic' ones.
|
|
|
|
This is a python issue, and if you don't mark the class, you will
|
|
see 'interesting' behaviours at the python side.
|
|
|
|
|
|
*/
|
|
%exceptionclass EmptyError;
|
|
|
|
%exception *::dequeue {
|
|
try {
|
|
$action
|
|
} catch(EmptyError& e) {
|
|
EmptyError *ecopy = new EmptyError(e);
|
|
PyObject *err = SWIG_NewPointerObj(ecopy, SWIGTYPE_p_EmptyError, 1);
|
|
PyErr_SetObject((PyObject *) SWIGTYPE_p_EmptyError->clientdata, err);
|
|
return NULL;
|
|
}
|
|
}
|
|
|
|
/* Grab the original header file */
|
|
%include "example.h"
|
|
|
|
/* Instantiate a few templates */
|
|
|
|
%template(intQueue) Queue<int>;
|
|
%template(doubleQueue) Queue<double>;
|
|
|
|
|
|
|
|
|
|
|