mxRealloc (External Interfaces/API Reference)

Reallocate memory

C Syntax

#include "matrix.h"
#include <stdlib.h>
void *mxRealloc(void *ptr, size_t size);

Arguments

ptr
Pointer to a block of memory allocated by mxCalloc, or by a previous call to mxRealloc.

size
New size of allocated memory, in bytes.

Returns

A pointer to the reallocated block of memory on success, and 0 on failure.

Description

mxRealloc reallocates the memory routine for the managed list. If mxRealloc fails to allocate a block, you must free the block since the ANSI definition of realloc states that the block remains allocated. mxRealloc returns NULL in this case, and in subsequent calls to mxRealloc of the form:

```
x = mxRealloc(x, size);
```

Note Failure to reallocate memory with mxRealloc can result in memory leaks.

Examples

See mxsetnzmax.c in the mx subdirectory of the examples directory.

mxMalloc mxRemoveField