xmlmemory

Gnome XML Library Reference Manual
<<< Previous Page	Home	Up

Details

DEBUG_MEMORY

#define DEBUG_MEMORY

DEBUG_MEMORY replaces the allocator with a collect and debug shell to the libc allocator. DEBUG_MEMORY should only be activated when debugging libxml i.e. if libxml has been configured with --with-debug-mem too.

xmlFreeFunc ()

void        (*xmlFreeFunc)                  (void *mem);

Signature for a free() implementation.

mem : an already allocated block of memory

xmlMallocFunc ()

void*       (*xmlMallocFunc)                (size_t size);

Signature for a malloc() implementation.

size : the size requested in bytes

xmlReallocFunc ()

void*       (*xmlReallocFunc)               (void *mem,
                                             size_t size);

Signature for a realloc() implementation.

`mem` :	an already allocated block of memory
`size` :	the new size requested in bytes

xmlStrdupFunc ()

char*       (*xmlStrdupFunc)                (const char *str);

Signature for an strdup() implementation.

`str` :	a zero terminated string
Returns :	the copy of the string or NULL in case of error.

xmlMemSetup ()

int         xmlMemSetup                     (xmlFreeFunc freeFunc,
                                             xmlMallocFunc mallocFunc,
                                             xmlReallocFunc reallocFunc,
                                             xmlStrdupFunc strdupFunc);

Override the default memory access functions with a new set This has to be called before any other libxml routines !

Should this be blocked if there was already some allocations done ?

`freeFunc` :	the free() function to use
`mallocFunc` :	the malloc() function to use
`reallocFunc` :	the realloc() function to use
`strdupFunc` :	the strdup() function to use
Returns :	0 on success

xmlMemGet ()

int         xmlMemGet                       (xmlFreeFunc *freeFunc,
                                             xmlMallocFunc *mallocFunc,
                                             xmlReallocFunc *reallocFunc,
                                             xmlStrdupFunc *strdupFunc);

Return the memory access functions set currently in use

`freeFunc` :	the free() function in use
`mallocFunc` :	the malloc() function in use
`reallocFunc` :	the realloc() function in use
`strdupFunc` :	the strdup() function in use
Returns :	0 on success

xmlInitMemory ()

int         xmlInitMemory                   (void);

Initialize the memory layer.

Returns :

0 on success

xmlMemUsed ()

int         xmlMemUsed                      (void);

returns the amount of memory currently allocated

Returns :

an int representing the amount of memory allocated.

xmlMemDisplay ()

void        xmlMemDisplay                   (FILE *fp);

show in-extenso the memory blocks allocated

fp : a FILE descriptor used as the output file, if NULL, the result is written to the file .memorylist

xmlMemShow ()

void        xmlMemShow                      (FILE *fp,
                                             int nr);

show a show display of the memory allocated, and dump the nr last allocated areas which were not freed

`fp` :	a FILE descriptor used as the output file
`nr` :	number of entries to dump

xmlMemoryDump ()

void        xmlMemoryDump                   (void);

Dump in-extenso the memory blocks allocated to the file .memorylist

xmlMalloc()

#define     xmlMalloc(size)

Wrapper for the malloc() function used in the XML library.

size : number of bytes to allocate

xmlRealloc()

#define     xmlRealloc(ptr, size)

Wrapper for the realloc() function used in the XML library.

`ptr` :	pointer to the existing allocated area
`size` :	number of bytes to allocate

xmlMemStrdup()

#define     xmlMemStrdup(str)

Wrapper for the strdup() function, xmlStrdup() is usually preferred.

str : pointer to the existing string

xmlMallocLoc ()

void*       xmlMallocLoc                    (size_t size,
                                             const char *file,
                                             int line);

a malloc() equivalent, with logging of the allocation info.

`size` :	an int specifying the size in byte to allocate.
`file` :	the file name or NULL
`line` :	the line number

xmlReallocLoc ()

void*       xmlReallocLoc                   (void *ptr,
                                             size_t size,
                                             const char *file,
                                             int line);

a realloc() equivalent, with logging of the allocation info.

`ptr` :	the initial memory block pointer
`size` :	an int specifying the size in byte to allocate.
`file` :	the file name or NULL
`line` :	the line number

xmlMemStrdupLoc ()

char*       xmlMemStrdupLoc                 (const char *str,
                                             const char *file,
                                             int line);

a strdup() equivalent, with logging of the allocation info.

`str` :	the initial string pointer
`file` :	the file name or NULL
`line` :	the line number
Returns :	a pointer to the new string or NULL if allocation error occurred.