Next: cnfCreib - Create a temporary C string and import a FORTRAN string into it including trailing blanks
Up: CNF C Routine Descriptions
Previous: cnfCref - Create a temporary FORTRAN CHARACTER string and return a pointer to it.
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.
Next: cnfCreib - Create a temporary C string and import a FORTRAN string into it including trailing blanks
Up: CNF C Routine Descriptions
Previous: cnfCref - Create a temporary FORTRAN CHARACTER string and return a pointer to it.
CNF and F77 Mixed Language Programming -- FORTRAN and C
Starlink User Note 209
P.M. Allan
A.J. Chipperfield
R.F. Warren-Smith
19 January 2000
E-mail:ussc@star.rl.ac.uk