cnfCrefa - Create a temporary FORTRAN CHARACTER array and return a pointer to it.

Description:

Memory is obtained for a FORTRAN CHARACTER array, of the specified dimensions and a pointer is returned which may be passed from C to a FORTRAN subroutine. The array is not initialised to blanks.

Invocation:

string_f = cnfCrefa( string_f_len, ndims, dims )

Arguments:

int string_f_len (Given)

The maximum length of the FORTRAN string elements of the array.

int ndims (Given)

The number of dimensions of the FORTRAN array

const int $*$dims (Given)

A 1-D array giving the dimensions of the FORTRAN array.

Returned Value:

F77_CHARACTER_ARRAY_ARG_TYPE $*$cnfCrefa

A pointer to the storage that has been allocated by this routine. Note that this is not necessarily the location of the strings of characters.

Notes:

• If the routine could not create the space, then it returns a null pointer.

• This function will usually be called via the F77 F77_CREATE_CHARACTER_ARRAY macro which will also provide a pointer to the actual strings of characters.