Platform

Win32

Purpose

To get a block of storage of size N bytes from the storage heap.

Syntax

SUBROUTINE GET_STORAGE@(ADDR,N)
INTEGER (KIND=7) ADDR
INTEGER N

Description

ADDR is returned as the address of the first byte of the block. A returned value of -1 indicates that there is insufficient contiguous storage to create the block.

Notes

The heap used by GET_STORAGE@, RETURN_STORAGE@ and SHRINK_STORAGE@ is fully virtual. Pages are provided by the runtime system to satisfy the program's page demands. The program may fail if it uses too much of the address space allocated or if the physical resources on the system are not sufficient to satisfy the program's demands.
Memory allocated using GET_STORAGE@ should be returned using RETURN_STORAGE@. The C function free and the C++ operator delete can not be used for this purpose.

See also

GET_GSTORAGE@