cnfCref - Create a temporary FORTRAN CHARACTER string and return a pointer to it.

Description:

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

Invocation:

string_f = cnfCref( string_f_len )

Arguments:

int string_f_len (Given)

The required length of the FORTRAN string.

Returned Value:

F77_CHARACTER_ARG_TYPE $*$cnfCref

A pointer to the storage that has been allocated by this routine. Note that this is not necessarily the location of the string 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 macro which will also provide a pointer to the actual string of characters.