Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

17    stdlib.h

Palm OS® Protein C/C++ Compiler Language & Library Reference

Palm OS® Developer Suite

The <stdlib.h> header defines several general operation functions and macros. Most of the functions defined in this header are standard libc functions; only inplace_realloc() is specific to Palm OS®.


NOTE: Functions that convert from strings to numbers are not multi-byte character aware, and do not take into account locale-sensitive settings such as the character used for decimals. Use the Palm OS specific equivalent functions if you need to be internationally safe.

Functions and Macros ^TOP^

inplace_realloc Function ^TOP^

Purpose

Attempts to resize the memory block without moving it.

Declared In

posix/stdlib.h

Prototype

void *inplace_realloc (
   void *ptr,
   size_t size
)

Parameters

ptr
The previously allocated memory.
size
The size, in bytes, to change to.

Returns

Returns a pointer, possibly identical to ptr, to the allocated memory upon successful completion. Otherwise, a NULL pointer is returned, in which case the memory referenced by ptr is still available and intact.

Compatibility

This function is a Palm OS extension (not present in C99 or Unix).