NAG Fortran Compiler, Release 7.2: f90_stat

Navigation: Previous Up Next

## 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'