_udump_allocated_delta -- Get Information about Allocated Memory in Heap

Format

#include <umalloc.h>
void _udump_allocated_delta(Heap_t heap, int nbytes);

Language Level: Extension
For the heap you specify, _udump_allocated_delta prints information to stderr about each memory block allocated by a debug memory management function (_debug_umalloc and so on) since the last call to _udump_allocated_delta or _udump_allocated.

_udump_allocated_delta and _udump_allocated print the same type of information to stderr, but _udump_allocated displays information about all blocks that have been allocated since the start of your program.

_udump_allocated_delta works just like _dump_allocated_delta, except that you specify the heap to use; _dump_allocated_delta always displays information about the default heap.

Use nbytes to specify how many bytes of each memory block are to be printed. If nbytes is:

Negative value Prints all bytes of each block.
0 Prints no bytes.
Positive value Prints the specified number of bytes or the entire block, whichever is smaller.

_udump_allocated_delta prints the information to stderr by default. You can change the destination with the _set_crt_msg_handle function.

To use _udump_allocated_delta and the debug versions of the memory management functions, specify the debug memory (/Tm) compiler option.

Note: The /Tm option maps all calls to memory management functions (including heap-specific versions) to their debug counterparts. To prevent a call from being mapped, parenthesize the function name.

Return Value
There is no return value. Passing _udump_allocated_delta a heap that is not valid results in undefined behavior.

Example



Managing Memory with Multiple Heaps
Memory Management


_debug_ucalloc -- Allocate and Initialize Memory from User Heap
_debug_umalloc -- Reserve Memory Blocks from User Heap
_debug_realloc -- Reallocte Memory Block
_debug_free -- Release Memory
_dump_allocated -- Get Information about Allocated Memory
_set_crt_msg_handle -- Change Runtime Message Output Destination
_udump_allocated -- Get Information about Allocated Memory in Heap
_tdump_allocated_delta -- Get Information about Allocated Tiled Memory
<umalloc.h>
/Tm compiler option