IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

DXReAllocate

Function

Changes the size of a previously allocated block of storage.

Syntax

#include <dx/dx.h>

Pointer DXReAllocate(Pointer x, unsigned int n)

Functional Details

Changes the size of the previously allocated block of storage pointed to by x by n bytes. The pointer x must have been returned from either DXAllocate, DXAllocateZero, DXAllocateLocal, DXAllocateLocalZero, or a previous call to DXReAllocate. If x is NULL, a global memory block is allocated as if DXAllocate was called. The number of bytes n must be greater than 0. The user is responsible for freeing the allocated space by calling DXFree. The block is copied if necessary, invalidating any pointers to the old storage.

Return Value

Returns a pointer to the new block, or returns NULL and sets the error code to indicate an error such as out of memory or a corrupted storage area.

See Also

DXAllocate, DXAllocateZero, DXAllocateLocal, DXAllocateLocalZero, DXAllocateLocalOnly, DXAllocateLocalOnlyZero, DXFree, DXPrintAlloc

13.3 , "Memory Allocation".


[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page | Contact Data Explorer | Same document on Data Explorer Home Page ]


[IBM Home Page | Order | Search | Contact IBM | Legal ]