[ < ] | [ > ] | [ << ] | [ Up ] | [ >> ] | [Top] | [Contents] | [Index] | [ ? ] |
4.1 Main functions
These functions are essential to the correct functioning of
libgimpprint. All or most other functions in the library depend
absolutely upon them. In the case of stp_init
, this function
must be called before any of the other functions in the library.
- Function: int stp_init (void)
This function initialises the libgimpprint library. It must be called before any of the other libgimpprint functions are called. It is responsible for setting up message catalogues (for internationalisation). This function may be called more than once, at any stage during the execution of a program.
It returns zero on success, nonzero on failure.
stp_init
might be used as follows:
int main (int argc, char **argv) { stp_init(); … } |
- Function: void * stp_malloc (size_t size)
Where size is the amount of memory to allocate (in bytes).
This function allocates memory. It will always return a pointer to the allocated memory. It will not return on failure.
It returns a pointer to the allocated memory.