MAN page from Mandrake 7.X tcl-8.0.5-13mdk.i586.rpm

Tcl_Alloc

Section: Tcl Library Procedures (3)
Updated: 7.5
Index

NAME

Tcl_Alloc, Tcl_Free, Tcl_Realloc - allocate or free heap memory

SYNOPSIS

#include <tcl.h>char *Tcl_Alloc(size)Tcl_Free(ptr)char *Tcl_Realloc(ptr, size)

ARGUMENTS

int size (in)
Size in bytes of the memory block to allocate.

char *ptr (in)
Pointer to memory block to free or realloc.

DESCRIPTION

These procedures provide a platform and compiler independent interfacefor memory allocation. Programs that need to transfer ownership ofmemory blocks between Tcl and other modules should use these routinesrather than the native malloc() and free() routinesprovided by the C run-time library.

Tcl_Alloc returns a pointer to a block of at least sizebytes suitably aligned for any use.

Tcl_Free makes the space referred to by ptr available forfurther allocation.

Tcl_Realloc changes the size of the block pointed to byptr to size bytes and returns a pointer to the new block.The contents will be unchanged up to the lesser of the new and oldsizes. The returned location may be different from ptr.

KEYWORDS

alloc, allocation, free, malloc, memory, realloc

This document was created byman2html,using the manual pages.