Go to the previous, next section.

NetCDF Library Interface Descriptions

Each interface description for a particular netCDF function in this and later chapters contains:

• A description of the purpose of the function;

• A list of possible error conditions;

• A C function prototype that presents the type and order of the formal parameters to the function;

• A description of each formal parameter in the C interface;

• An example of a C program fragment calling the netCDF function and perhaps other netCDF functions to do something useful;

• A FORTRAN function prototype that presents the type and order of the formal parameters to the FORTRAN function or functions that provide the same functionality as the C function;

• A description of each formal parameter in the FORTRAN interface; and

• An example of a FORTRAN program fragment that duplicates the function of the example C fragment.

The C function prototypes specify the order and type of each formal parameter and conform to the ANSI C standard. FORTRAN does not have function prototypes, but a similar syntax is used to concisely present the order and types of FORTRAN formal parameters. In the few cases in which a single C function corresponds to two FORTRAN functions, the FORTRAN functions prototypes are presented together.

The FORTRAN examples use two nonstandard notations: INCLUDE statements and in-line comments. In each case, we use the VMS FORTRAN notation, as in the following example:

      INCLUDE 'netcdf.inc'
      INTEGER NCID       ! this is an in-line comment

Go to the previous, next section.