GNU Info

(python2.1-lib.info)Dl Objects

---

Prev: dl Up: dl

---

Enter node , (file) or (file)node

Dl Objects
----------

Dl objects, as returned by `open()' above, have the following methods:

`close()'
     Free all resources, except the memory.

`sym(name)'
     Return the pointer for the function named NAME, as a number, if it
     exists in the referenced shared object, otherwise `None'. This is
     useful in code like:

          >>> if a.sym('time'):
          ...     a.call('time')
          ... else:
          ...     time.time()

     (Note that this function will return a non-zero number, as zero is
     the `NULL' pointer)

`call(name[, arg1[, arg2...]])'
     Call the function named NAME in the referenced shared object.  The
     arguments must be either Python integers, which will be passed as
     is, Python strings, to which a pointer will be passed, or `None',
     which will be passed as `NULL'. Note that strings should only be
     passed to functions as `const char*', as Python will not like its
     string mutated.

     There must be at most 10 arguments, and arguments not given will be
     treated as `None'. The function's return value must be a C `long',
     which is a Python integer.