Implements the error testing function and allocation related functionalities.

Author: Edwin Chacon-Golcher

Provides the header file that exposes the allocation, initialization and clearing macros, and other related functionalities.

The following directive will make available macros:

#include "sll_m_memory.h"

SLL_ALLOCATE
SLL_DEALLOCATE
SLL_INIT_ARRAY
SLL_CLEAR_ALLOCATE

and will provide any additional functionality included in the sll_m_memory.F90 module. This directive should be put in the 'use' section of the subprogram that wants to use the allocator.

Examples:

To allocate the simple array 'a' of 1000 elements:

sll_allocate(a(1000),err)

To allocate the 2D array 'a' with non-default indexing:

sll_allocate(a(5:55,1:20),err),

etc. The syntax comes directly from the native Fortran allocate function.

The deallocation macro also requires the integer error variable:

sll_deallocate(a, err)

To initialize an array:

sll_init_array(a,value)

To allocate and initialize an array to 0:

sll_clear_allocate(a(1:1000,4:500), err)

Any file that uses this include file will need to be compiled such that there is no upper limit to the length of a source code line. In gfortran, for instance, this behavior is obtained with the flag -ffree-line-length-none