/*
* Copyright 1993-1996 University Corporation for Atmospheric Research/Unidata
*
* Portions of this software were developed by the Unidata Program at the
* University Corporation for Atmospheric Research.
*
* Access and use of this software shall impose the following obligations
* and understandings on the user. The user is granted the right, without
* any fee or cost, to use, copy, modify, alter, enhance and distribute
* this software, and any derivative works thereof, and its supporting
* documentation for any purpose whatsoever, provided that this entire
* notice appears in all copies of the software, derivative works and
* supporting documentation. Further, UCAR requests that the user credit
* UCAR/Unidata in any publications that result from the use of this
* software or in any product that includes this software. The names UCAR
* and/or Unidata, however, may not be used in any advertising or publicity
* to endorse or promote any products or commercial entity unless specific
* written permission is obtained from UCAR/Unidata. The user also
* understands that UCAR/Unidata is not obligated to provide the user with
* any support, consulting, training or assistance of any kind with regard
* to the use, operation and performance of this software nor to provide
* the user with any updates, revisions, new versions or "bug fixes."
*
* THIS SOFTWARE IS PROVIDED BY UCAR/UNIDATA "AS IS" AND ANY EXPRESS OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL UCAR/UNIDATA BE LIABLE FOR ANY SPECIAL,
* INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
* FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
* NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
* WITH THE ACCESS, USE OR PERFORMANCE OF THIS SOFTWARE.
*/
/* "$Id: netcdf.h,v 1.1.1.1 2005/06/14 04:38:31 svitak Exp $" */
#ifndef _NETCDF_
#define _NETCDF_
#include <stddef.h> /* size_t, ptrdiff_t */
#include <errno.h> /* netcdf functions sometimes return system errors */
#if defined(__cplusplus)
extern "C" {
#endif
/*
* The netcdf external data types
*/
typedef enum {
NC_BYTE = 1, /* signed 1 byte integer */
NC_CHAR = 2, /* ISO/ASCII character */
NC_SHORT = 3, /* signed 2 byte integer */
NC_INT = 4, /* signed 4 byte integer */
NC_FLOAT = 5, /* single precision floating point number */
NC_DOUBLE = 6 /* double precision floating point number */
} nc_type;
/*
* Default fill values, used unless _FillValue attribute is set.
* These values are stuffed into newly allocated space as appropriate.
* The hope is that one might use these to notice that a particular datum
* has not been set.
*/
#define NC_FILL_BYTE ((signed char)-127)
#define NC_FILL_CHAR ((char)0)
#define NC_FILL_SHORT ((short)-32767)
#define NC_FILL_INT (-2147483647L)
#define NC_FILL_FLOAT (9.9692099683868690e+36f) /* near 15 * 2^119 */
#define NC_FILL_DOUBLE (9.9692099683868690e+36)
/*
* The above values are defaults.
* If you wish a variable to use a different value than the above
* defaults, create an attribute with the same type as the variable
* and the following reserved name. The value you give the attribute
* will be used as the fill value for that variable.
*/
#define _FillValue "_FillValue"
/*
* 'mode' flags for nccreate and ncopen
*/
#define NC_NOWRITE 0 /* default is read only */
#define NC_WRITE 0x1 /* read & write */
#define NC_CLOBBER 0
#define NC_NOCLOBBER 0x4 /* Don't destroy existing file on create */
#define NC_FILL 0 /* argument to ncsetfill to clear NC_NOFILL */
#define NC_NOFILL 0x100 /* Don't fill data section an records */
#define NC_LOCK 0x0400 /* Use locking if available */
#define NC_SHARE 0x0800 /* Share updates, limit cacheing */
/*
* Let nc__create() or nc__open() figure out
* as suitable chunk size.
*/
#define NC_SIZEHINT_DEFAULT 0
/*
* In nc__enddef(), align to the chunk size.
*/
#define NC_ALIGN_CHUNK ((size_t)(-1))
/*
* 'size' argument to ncdimdef for an unlimited dimension
*/
#define NC_UNLIMITED 0L
/*
* attribute id to put/get a global attribute
*/
#define NC_GLOBAL -1
/*
* These maximums are enforced by the interface, to facilitate writing
* applications and utilities. However, nothing is statically allocated to
* these sizes internally.
*/
#define NC_MAX_DIMS 100 /* max dimensions per file */
#define NC_MAX_ATTRS 2000 /* max global or per variable attributes */
#define NC_MAX_VARS 2000 /* max variables per file */
#define NC_MAX_NAME 128 /* max length of a name */
#define NC_MAX_VAR_DIMS NC_MAX_DIMS /* max per variable dimensions */
/*
* The netcdf version 3 functions all return integer error status.
* These are the possible values, in addition to certain
* values from the system errno.h.
*/
#define NC_ISSYSERR(err) ((err) > 0)
#define NC_NOERR 0 /* No Error */
#define NC_EBADID (-33) /* Not a netcdf id */
#define NC_ENFILE (-34) /* Too many netcdfs open */
#define NC_EEXIST (-35) /* netcdf file exists && NC_NOCLOBBER */
#define NC_EINVAL (-36) /* Invalid Argument */
#define NC_EPERM (-37) /* Write to read only */
#define NC_ENOTINDEFINE (-38) /* Operation not allowed in data mode */
#define NC_EINDEFINE (-39) /* Operation not allowed in define mode */
#define NC_EINVALCOORDS (-40) /* Index exceeds dimension bound */
#define NC_EMAXDIMS (-41) /* NC_MAX_DIMS exceeded */
#define NC_ENAMEINUSE (-42) /* String match to name in use */
#define NC_ENOTATT (-43) /* Attribute not found */
#define NC_EMAXATTS (-44) /* NC_MAX_ATTRS exceeded */
#define NC_EBADTYPE (-45) /* Not a netcdf data type */
#define NC_EBADDIM (-46) /* Invalid dimension id or name */
#define NC_EUNLIMPOS (-47) /* NC_UNLIMITED in the wrong index */
#define NC_EMAXVARS (-48) /* NC_MAX_VARS exceeded */
#define NC_ENOTVAR (-49) /* Variable not found */
#define NC_EGLOBAL (-50) /* Action prohibited on NC_GLOBAL varid */
#define NC_ENOTNC (-51) /* Not a netcdf file */
#define NC_ESTS (-52) /* In Fortran, string too short */
#define NC_EMAXNAME (-53) /* NC_MAX_NAME exceeded */
#define NC_EUNLIMIT (-54) /* NC_UNLIMITED size already in use */
#define NC_ENORECVARS (-55) /* nc_rec op when there are no record vars */
#define NC_ECHAR (-56) /* Attempt to convert between text & numbers */
#define NC_EEDGE (-57) /* Edge+start exceeds dimension bound */
#define NC_ESTRIDE (-58) /* Illegal stride */
#define NC_EBADNAME (-59) /* Attribute or variable name
contains illegal characters */
/* N.B. must match value in ncx.h */
#define NC_ERANGE (-60) /* Math result not representable */
#define NC_ENOMEM (-61) /* Memory allocation (malloc) failure */
/*
* The Interface
*/
/* Declaration modifiers for DLL support (MSC et al) */
#if defined(DLL_NETCDF) /* define when library is a DLL */
# if defined(DLL_EXPORT) /* define when building the library */
# define MSC_EXTRA __declspec(dllexport)
# else
# define MSC_EXTRA __declspec(dllimport)
# endif
#else
#define MSC_EXTRA
#endif /* defined(DLL_NETCDF) */
# define EXTERNL extern MSC_EXTRA
EXTERNL const char *
nc_inq_libvers(void);
EXTERNL const char *
nc_strerror(int ncerr);
EXTERNL int
nc__create(const char *path, int cmode, size_t initialsz,
size_t *chunksizehintp, int *ncidp);
EXTERNL int
nc_create(const char *path, int cmode, int *ncidp);
EXTERNL int
nc__open(const char *path, int mode,
size_t *chunksizehintp, int *ncidp);
EXTERNL int
nc_open(const char *path, int mode, int *ncidp);
EXTERNL int
nc_set_fill(int ncid, int fillmode, int *old_modep);
EXTERNL int
nc_redef(int ncid);
EXTERNL int
nc__enddef(int ncid, size_t h_minfree, size_t v_align,
size_t v_minfree, size_t r_align);
EXTERNL int
nc_enddef(int ncid);
EXTERNL int
nc_sync(int ncid);
EXTERNL int
nc_abort(int ncid);
EXTERNL int
nc_close(int ncid);
EXTERNL int
nc_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp);
EXTERNL int
nc_inq_ndims(int ncid, int *ndimsp);
EXTERNL int
nc_inq_nvars(int ncid, int *nvarsp);
EXTERNL int
nc_inq_natts(int ncid, int *nattsp);
EXTERNL int
nc_inq_unlimdim(int ncid, int *unlimdimidp);
/* Begin _dim */
EXTERNL int
nc_def_dim(int ncid, const char *name, size_t len, int *idp);
EXTERNL int
nc_inq_dimid(int ncid, const char *name, int *idp);
EXTERNL int
nc_inq_dim(int ncid, int dimid, char *name, size_t *lenp);
EXTERNL int
nc_inq_dimname(int ncid, int dimid, char *name);
EXTERNL int
nc_inq_dimlen(int ncid, int dimid, size_t *lenp);
EXTERNL int
nc_rename_dim(int ncid, int dimid, const char *name);
/* End _dim */
/* Begin _att */
EXTERNL int
nc_inq_att(int ncid, int varid, const char *name,
nc_type *xtypep, size_t *lenp);
EXTERNL int
nc_inq_attid(int ncid, int varid, const char *name, int *idp);
EXTERNL int
nc_inq_atttype(int ncid, int varid, const char *name, nc_type *xtypep);
EXTERNL int
nc_inq_attlen(int ncid, int varid, const char *name, size_t *lenp);
EXTERNL int
nc_inq_attname(int ncid, int varid, int attnum, char *name);
EXTERNL int
nc_copy_att(int ncid_in, int varid_in, const char *name, int ncid_out, int varid_out);
EXTERNL int
nc_rename_att(int ncid, int varid, const char *name, const char *newname);
EXTERNL int
nc_del_att(int ncid, int varid, const char *name);
/* End _att */
/* Begin {put,get}_att */
EXTERNL int
nc_put_att_text(int ncid, int varid, const char *name,
size_t len, const char *op);
EXTERNL int
nc_get_att_text(int ncid, int varid, const char *name, char *ip);
EXTERNL int
nc_put_att_uchar(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const unsigned char *op);
EXTERNL int
nc_get_att_uchar(int ncid, int varid, const char *name, unsigned char *ip);
EXTERNL int
nc_put_att_schar(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const signed char *op);
EXTERNL int
nc_get_att_schar(int ncid, int varid, const char *name, signed char *ip);
EXTERNL int
nc_put_att_short(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const short *op);
EXTERNL int
nc_get_att_short(int ncid, int varid, const char *name, short *ip);
EXTERNL int
nc_put_att_int(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const int *op);
EXTERNL int
nc_get_att_int(int ncid, int varid, const char *name, int *ip);
EXTERNL int
nc_put_att_long(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const long *op);
EXTERNL int
nc_get_att_long(int ncid, int varid, const char *name, long *ip);
EXTERNL int
nc_put_att_float(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const float *op);
EXTERNL int
nc_get_att_float(int ncid, int varid, const char *name, float *ip);
EXTERNL int
nc_put_att_double(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const double *op);
EXTERNL int
nc_get_att_double(int ncid, int varid, const char *name, double *ip);
/* End {put,get}_att */
/* Begin _var */
EXTERNL int
nc_def_var(int ncid, const char *name,
nc_type xtype, int ndims, const int *dimidsp, int *varidp);
EXTERNL int
nc_inq_var(int ncid, int varid, char *name,
nc_type *xtypep, int *ndimsp, int *dimidsp, int *nattsp);
EXTERNL int
nc_inq_varid(int ncid, const char *name, int *varidp);
EXTERNL int
nc_inq_varname(int ncid, int varid, char *name);
EXTERNL int
nc_inq_vartype(int ncid, int varid, nc_type *xtypep);
EXTERNL int
nc_inq_varndims(int ncid, int varid, int *ndimsp);
EXTERNL int
nc_inq_vardimid(int ncid, int varid, int *dimidsp);
EXTERNL int
nc_inq_varnatts(int ncid, int varid, int *nattsp);
EXTERNL int
nc_rename_var(int ncid, int varid, const char *name);
EXTERNL int
nc_copy_var(int ncid_in, int varid, int ncid_out);
#ifndef ncvarcpy
/* support the old name for now */
#define ncvarcpy(ncid_in, varid, ncid_out) ncvarcopy((ncid_in), (varid), (ncid_out))
#endif
/* End _var */
/* Begin {put,get}_var1 */
EXTERNL int
nc_put_var1_text(int ncid, int varid, const size_t *indexp, const char *op);
EXTERNL int
nc_get_var1_text(int ncid, int varid, const size_t *indexp, char *ip);
EXTERNL int
nc_put_var1_uchar(int ncid, int varid, const size_t *indexp,
const unsigned char *op);
EXTERNL int
nc_get_var1_uchar(int ncid, int varid, const size_t *indexp,
unsigned char *ip);
EXTERNL int
nc_put_var1_schar(int ncid, int varid, const size_t *indexp,
const signed char *op);
EXTERNL int
nc_get_var1_schar(int ncid, int varid, const size_t *indexp,
signed char *ip);
EXTERNL int
nc_put_var1_short(int ncid, int varid, const size_t *indexp,
const short *op);
EXTERNL int
nc_get_var1_short(int ncid, int varid, const size_t *indexp,
short *ip);
EXTERNL int
nc_put_var1_int(int ncid, int varid, const size_t *indexp, const int *op);
EXTERNL int
nc_get_var1_int(int ncid, int varid, const size_t *indexp, int *ip);
EXTERNL int
nc_put_var1_long(int ncid, int varid, const size_t *indexp, const long *op);
EXTERNL int
nc_get_var1_long(int ncid, int varid, const size_t *indexp, long *ip);
EXTERNL int
nc_put_var1_float(int ncid, int varid, const size_t *indexp, const float *op);
EXTERNL int
nc_get_var1_float(int ncid, int varid, const size_t *indexp, float *ip);
EXTERNL int
nc_put_var1_double(int ncid, int varid, const size_t *indexp, const double *op);
EXTERNL int
nc_get_var1_double(int ncid, int varid, const size_t *indexp, double *ip);
/* End {put,get}_var1 */
/* Begin {put,get}_vara */
EXTERNL int
nc_put_vara_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const char *op);
EXTERNL int
nc_get_vara_text(int ncid, int varid,
const size_t *startp, const size_t *countp, char *ip);
EXTERNL int
nc_put_vara_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, const unsigned char *op);
EXTERNL int
nc_get_vara_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, unsigned char *ip);
EXTERNL int
nc_put_vara_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, const signed char *op);
EXTERNL int
nc_get_vara_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, signed char *ip);
EXTERNL int
nc_put_vara_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const short *op);
EXTERNL int
nc_get_vara_short(int ncid, int varid,
const size_t *startp, const size_t *countp, short *ip);
EXTERNL int
nc_put_vara_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const int *op);
EXTERNL int
nc_get_vara_int(int ncid, int varid,
const size_t *startp, const size_t *countp, int *ip);
EXTERNL int
nc_put_vara_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const long *op);
EXTERNL int
nc_get_vara_long(int ncid, int varid,
const size_t *startp, const size_t *countp, long *ip);
EXTERNL int
nc_put_vara_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const float *op);
EXTERNL int
nc_get_vara_float(int ncid, int varid,
const size_t *startp, const size_t *countp, float *ip);
EXTERNL int
nc_put_vara_double(int ncid, int varid,
const size_t *startp, const size_t *countp, const double *op);
EXTERNL int
nc_get_vara_double(int ncid, int varid,
const size_t *startp, const size_t *countp, double *ip);
/* End {put,get}_vara */
/* Begin {put,get}_vars */
EXTERNL int
nc_put_vars_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const char *op);
EXTERNL int
nc_get_vars_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
char *ip);
EXTERNL int
nc_put_vars_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const unsigned char *op);
EXTERNL int
nc_get_vars_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
unsigned char *ip);
EXTERNL int
nc_put_vars_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const signed char *op);
EXTERNL int
nc_get_vars_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
signed char *ip);
EXTERNL int
nc_put_vars_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const short *op);
EXTERNL int
nc_get_vars_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
short *ip);
EXTERNL int
nc_put_vars_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const int *op);
EXTERNL int
nc_get_vars_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
int *ip);
EXTERNL int
nc_put_vars_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const long *op);
EXTERNL int
nc_get_vars_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
long *ip);
EXTERNL int
nc_put_vars_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const float *op);
EXTERNL int
nc_get_vars_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
float *ip);
EXTERNL int
nc_put_vars_double(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const double *op);
EXTERNL int
nc_get_vars_double(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
double *ip);
/* End {put,get}_vars */
/* Begin {put,get}_varm */
EXTERNL int
nc_put_varm_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const char *op);
EXTERNL int
nc_get_varm_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
char *ip);
EXTERNL int
nc_put_varm_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const unsigned char *op);
EXTERNL int
nc_get_varm_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
unsigned char *ip);
EXTERNL int
nc_put_varm_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const signed char *op);
EXTERNL int
nc_get_varm_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
signed char *ip);
EXTERNL int
nc_put_varm_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const short *op);
EXTERNL int
nc_get_varm_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
short *ip);
EXTERNL int
nc_put_varm_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const int *op);
EXTERNL int
nc_get_varm_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
int *ip);
EXTERNL int
nc_put_varm_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const long *op);
EXTERNL int
nc_get_varm_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
long *ip);
EXTERNL int
nc_put_varm_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const float *op);
EXTERNL int
nc_get_varm_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
float *ip);
EXTERNL int
nc_put_varm_double(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp,
const double *op);
EXTERNL int
nc_get_varm_double(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t * imap,
double *ip);
/* End {put,get}_varm */
/* Begin {put,get}_var */
EXTERNL int
nc_put_var_text(int ncid, int varid, const char *op);
EXTERNL int
nc_get_var_text(int ncid, int varid, char *ip);
EXTERNL int
nc_put_var_uchar(int ncid, int varid, const unsigned char *op);
EXTERNL int
nc_get_var_uchar(int ncid, int varid, unsigned char *ip);
EXTERNL int
nc_put_var_schar(int ncid, int varid, const signed char *op);
EXTERNL int
nc_get_var_schar(int ncid, int varid, signed char *ip);
EXTERNL int
nc_put_var_short(int ncid, int varid, const short *op);
EXTERNL int
nc_get_var_short(int ncid, int varid, short *ip);
EXTERNL int
nc_put_var_int(int ncid, int varid, const int *op);
EXTERNL int
nc_get_var_int(int ncid, int varid, int *ip);
EXTERNL int
nc_put_var_long(int ncid, int varid, const long *op);
EXTERNL int
nc_get_var_long(int ncid, int varid, long *ip);
EXTERNL int
nc_put_var_float(int ncid, int varid, const float *op);
EXTERNL int
nc_get_var_float(int ncid, int varid, float *ip);
EXTERNL int
nc_put_var_double(int ncid, int varid, const double *op);
EXTERNL int
nc_get_var_double(int ncid, int varid, double *ip);
/* End {put,get}_var */
/* Begin v2.4 backward compatiblity */
/*
* defining NO_NETCDF_2 to the preprocessor
* turns off backward compatiblity declarations.
*/
#ifndef NO_NETCDF_2
/*
* Backward compatible aliases
*/
#define FILL_BYTE NC_FILL_BYTE
#define FILL_CHAR NC_FILL_CHAR
#define FILL_SHORT NC_FILL_SHORT
#define FILL_LONG NC_FILL_INT
#define FILL_FLOAT NC_FILL_FLOAT
#define FILL_DOUBLE NC_FILL_DOUBLE
#define MAX_NC_DIMS NC_MAX_DIMS
#define MAX_NC_ATTRS NC_MAX_ATTRS
#define MAX_NC_VARS NC_MAX_VARS
#define MAX_NC_NAME NC_MAX_NAME
#define MAX_VAR_DIMS NC_MAX_VAR_DIMS
/*
* If and when 64 integer types become ubiquitous,
* we would like to use NC_LONG for that.
* For now, define for backward compatibility.
*/
#define NC_LONG NC_INT
/*
* Global error status
*/
EXTERNL int ncerr;
#define NC_ENTOOL NC_EMAXNAME /* Backward compatibility */
#define NC_EXDR (-32) /* */
#define NC_SYSERR (-31)
/*
* Avoid use of this meaningless macro
* Use sysconf(_SC_OPEN_MAX).
*/
#ifndef MAX_NC_OPEN
#define MAX_NC_OPEN 32
#endif
/*
* Global options variable.
* Used to determine behavior of error handler.
*/
#define NC_FATAL 1
#define NC_VERBOSE 2
EXTERNL int ncopts; /* default is (NC_FATAL | NC_VERBOSE) */
EXTERNL void
nc_advise(const char *cdf_routine_name, int err, const char *fmt,...);
/*
* C data type corresponding to a netCDF NC_LONG argument,
* a signed 32 bit object.
*
* This is the only thing in this file which architecture dependent.
*/
typedef int nclong;
EXTERNL int
nctypelen(nc_type datatype);
EXTERNL int
nccreate(const char* path, int cmode);
EXTERNL int
ncopen(const char* path, int mode);
EXTERNL int
ncsetfill(int ncid, int fillmode);
EXTERNL int
ncredef(int ncid);
EXTERNL int
ncendef(int ncid);
EXTERNL int
ncsync(int ncid);
EXTERNL int
ncabort(int ncid);
EXTERNL int
ncclose(int ncid);
EXTERNL int
ncinquire(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimp);
EXTERNL int
ncdimdef(int ncid, const char *name, long len);
EXTERNL int
ncdimid(int ncid, const char *name);
EXTERNL int
ncdiminq(int ncid, int dimid, char *name, long *lenp);
EXTERNL int
ncdimrename(int ncid, int dimid, const char *name);
EXTERNL int
ncattput(int ncid, int varid, const char *name, nc_type xtype,
int len, const void *op);
EXTERNL int
ncattinq(int ncid, int varid, const char *name, nc_type *xtypep, int *lenp);
EXTERNL int
ncattget(int ncid, int varid, const char *name, void *ip);
EXTERNL int
ncattcopy(int ncid_in, int varid_in, const char *name, int ncid_out,
int varid_out);
EXTERNL int
ncattname(int ncid, int varid, int attnum, char *name);
EXTERNL int
ncattrename(int ncid, int varid, const char *name, const char *newname);
EXTERNL int
ncattdel(int ncid, int varid, const char *name);
EXTERNL int
ncvardef(int ncid, const char *name, nc_type xtype,
int ndims, const int *dimidsp);
EXTERNL int
ncvarid(int ncid, const char *name);
EXTERNL int
ncvarinq(int ncid, int varid, char *name, nc_type *xtypep,
int *ndimsp, int *dimidsp, int *nattsp);
EXTERNL int
ncvarput1(int ncid, int varid, const long *indexp, const void *op);
EXTERNL int
ncvarget1(int ncid, int varid, const long *indexp, void *ip);
EXTERNL int
ncvarput(int ncid, int varid, const long *startp, const long *countp,
const void *op);
EXTERNL int
ncvarget(int ncid, int varid, const long *startp, const long *countp,
void *ip);
EXTERNL int
ncvarputs(int ncid, int varid, const long *startp, const long *countp,
const long *stridep, const void *op);
EXTERNL int
ncvargets(int ncid, int varid, const long *startp, const long *countp,
const long *stridep, void *ip);
EXTERNL int
ncvarputg(int ncid, int varid, const long *startp, const long *countp,
const long *stridep, const long *imapp, const void *op);
EXTERNL int
ncvargetg(int ncid, int varid, const long *startp, const long *countp,
const long *stridep, const long *imapp, void *ip);
EXTERNL int
ncvarrename(int ncid, int varid, const char *name);
EXTERNL int
ncrecinq(int ncid, int *nrecvarsp, int *recvaridsp, long *recsizesp);
EXTERNL int
ncrecget(int ncid, long recnum, void **datap);
EXTERNL int
ncrecput(int ncid, long recnum, void *const *datap);
/* End v2.4 backward compatiblity */
#endif /*!NO_NETCDF_2*/
#if defined(__cplusplus)
}
#endif
#endif /* _NETCDF_ */