6.6 f90_stat

This module contains definitions of integer parameters for all the STAT= values that can be returned as a result of use of an ALLOCATE or DEALLOCATE statement.

6.6.1 Parameters

  INTEGER,PARAMETER :: STAT_ALREADY_ALLOCATED
An allocatable variable in an ALLOCATE statement is already currently allocated.

  INTEGER,PARAMETER :: STAT_MEMORY_LIMIT_EXCEEDED
An allocation in an ALLOCATE statement requested more memory than the limit in this version of the NAG Fortran compiler.

  INTEGER,PARAMETER :: STAT_NO_MEMORY
Insufficient free memory available to satisfy the requested allocation.

  INTEGER,PARAMETER :: STAT_NOT_ALLOCATED
An allocatable variable in a DEALLOCATE statement is not currently allocated.

  INTEGER,PARAMETER :: STAT_NOT_ASSOCIATED
A pointer in a DEALLOCATE statement is disassociated.

  INTEGER,PARAMETER :: STAT_PART_OF_A_LARGER_OBJECT
A pointer in a DEALLOCATE statement refers to part of a larger object.

  INTEGER,PARAMETER :: STAT_POINTER_UNDEFINED
A pointer in a DEALLOCATE statement is undefined. (This value is never returned to the user program, which is always immediately terminated if the use of an undefined pointer is detected.)

  INTEGER,PARAMETER :: STAT_WRONG_COLOUR
A pointer in a DEALLOCATE statement is associated with a target that was not created by pointer allocation.

6.6.2 Example

USE f90_stat
REAL,ALLOCATABLE :: big(:,:,:)
INTEGER :: status
ALLOCATE(big(100,1024,1024),STAT=status)
IF (status==STAT_NO_MEMORY) PRINT *,'Out of memory'