Parameters Conventions

All Gdome2 functions implementing a DOM API have two extra parameters in comparison with the DOM specification: the first parameter is a reference to the object for which we are invoking the method³. The last parameter is a reference to a GdomeException structure used to store the exception possibly raised by the method invocation (we recall that the C programming language [6] does not have a native mechanism for handling exceptions). As an example, the method appendChild of the Node interface is implemented in Gdome2 by a function with the following prototype:

GdomeNode *gdome_n_appendChild (GdomeNode *self,
                                GdomeNode *newChild,
                                GdomeException *exc)

Footnotes

... method³

In fact, this is a quite common implementation choice for object-oriented programming languages.