cnfFptr - Convert a C pointer to a FORTRAN pointer

Description:

Given a C pointer, this function returns the equivalent FORTRAN pointer of type F77_POINTER_TYPE. Note that this conversion is only performed if the C pointer has originally been registered (using cnfRegp) for use from both C and FORTRAN. All pointers to space allocated by cnfCalloc and cnfMalloc are automatically registered in this way.

Invocation:

fpointer = cnfFptr( cpointer )

Arguments:

void *cpointer (Given)

The C pointer.

Returned Value:

F77_POINTER_TYPE cnfCptr

The equivalent FORTRAN pointer value.

Notes:

• A value of zero will be returned if the C pointer has not previously been registered for use from both C and FORTRAN, or if a NULL pointer is supplied.