next up previous
Next: GdomeDOMString Up: API Conventions Previous: Naming Conventions

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 method3. 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)


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

Paolo Casarini 2001-04-01