netCDF  4.2.1.1
 All Data Structures Files Functions Variables Typedefs Macros Groups Pages
Data Structures | Macros | Typedefs | Functions | Variables
netcdf.h File Reference

Main header file for the C API. More...

#include <stddef.h>
#include <errno.h>

Go to the source code of this file.

Data Structures

struct  nc_vlen_t
 This is the type of arrays of vlens. More...
 

Macros

#define NC_NAT   0
 Not A Type.
 
#define NC_BYTE   1
 signed 1 byte integer
 
#define NC_CHAR   2
 ISO/ASCII character.
 
#define NC_SHORT   3
 signed 2 byte integer
 
#define NC_INT   4
 signed 4 byte integer
 
#define NC_LONG   NC_INT
 deprecated, but required for backward compatibility.
 
#define NC_FLOAT   5
 single precision floating point number
 
#define NC_DOUBLE   6
 double precision floating point number
 
#define NC_UBYTE   7
 unsigned 1 byte int
 
#define NC_USHORT   8
 unsigned 2-byte int
 
#define NC_UINT   9
 unsigned 4-byte int
 
#define NC_INT64   10
 signed 8-byte int
 
#define NC_UINT64   11
 unsigned 8-byte int
 
#define NC_STRING   12
 string
 
#define NC_MAX_ATOMIC_TYPE   NC_STRING
 
#define NC_VLEN   13
 vlen types
 
#define NC_OPAQUE   14
 opaque types
 
#define NC_ENUM   15
 enum types
 
#define NC_COMPOUND   16
 compound types
 
#define NC_FIRSTUSERTYPEID   32
 
#define _FillValue   "_FillValue"
 Name of fill value attribute.
 
#define NC_FILL   0
 Argument to nc_set_fill() to clear NC_NOFILL.
 
#define NC_NOFILL   0x100
 Argument to nc_set_fill() to turn off filling of data.
 
#define NC_NOWRITE   0x0000
 Set read-only access for nc_open().
 
#define NC_WRITE   0x0001
 Set read-write access for nc_open().
 
#define NC_CLOBBER   0x0000
 Destroy existing file.
 
#define NC_NOCLOBBER   0x0004
 Don't destroy existing file.
 
#define NC_DISKLESS   0x0008
 Use diskless file.
 
#define NC_MMAP   0x0010
 Use diskless file with mmap.
 
#define NC_CLASSIC_MODEL   0x0100
 Enforce classic model.
 
#define NC_64BIT_OFFSET   0x0200
 Use large (64-bit) file offsets.
 
#define NC_LOCK   0x0400
 
#define NC_SHARE   0x0800
 Share updates, limit cacheing.
 
#define NC_NETCDF4   0x1000
 Use netCDF-4/HDF5 format.
 
#define NC_MPIIO   0x2000
 Turn on MPI I/O.
 
#define NC_MPIPOSIX   0x4000
 Turn on MPI POSIX I/O.
 
#define NC_PNETCDF   0x8000
 Use parallel-netcdf library.
 
#define NC_SIZEHINT_DEFAULT   0
 Let nc__create() or nc__open() figure out as suitable chunk size.
 
#define NC_ALIGN_CHUNK   ((size_t)(-1))
 In nc__enddef(), align to the chunk size.
 
#define NC_UNLIMITED   0L
 Size argument to nc_def_dim() for an unlimited dimension.
 
#define NC_GLOBAL   -1
 Attribute id to put/get a global attribute.
 
#define NC_MAX_HDF4_NAME   64
 This is the max size of an SD dataset name in HDF4 (from HDF4 documentation).
 
#define NC_ISSYSERR(err)   ((err) > 0)
 The netcdf version 3 functions all return integer error status.
 
#define NC_NOERR   0
 No Error.
 
#define NC2_ERR   (-1)
 Returned for all errors in the v2 API.
 
#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)
 Start+count exceeds dimension bound.
 
#define NC_ESTRIDE   (-58)
 Illegal stride.
 
#define NC_EBADNAME   (-59)
 Attribute or variable name contains illegal characters.
 
#define NC_ERANGE   (-60)
 Math result not representable.
 
#define NC_ENOMEM   (-61)
 Memory allocation (malloc) failure.
 
#define NC_EVARSIZE   (-62)
 One or more variable sizes violate format constraints.
 
#define NC_EDIMSIZE   (-63)
 Invalid dimension size.
 
#define NC_ETRUNC   (-64)
 File likely truncated or possibly corrupted.
 
#define NC_EAXISTYPE   (-65)
 Unknown axis type.
 
#define NC_EDAP   (-66)
 Generic DAP error.
 
#define NC_ECURL   (-67)
 Generic libcurl error.
 
#define NC_EIO   (-68)
 Generic IO error.
 
#define NC_ENODATA   (-69)
 Attempt to access variable with no data.
 
#define NC_EDAPSVC   (-70)
 DAP server error.
 
#define NC_EDAS   (-71)
 Malformed or inaccessible DAS.
 
#define NC_EDDS   (-72)
 Malformed or inaccessible DDS.
 
#define NC_EDATADDS   (-73)
 Malformed or inaccessible DATADDS.
 
#define NC_EDAPURL   (-74)
 Malformed DAP URL.
 
#define NC_EDAPCONSTRAINT   (-75)
 Malformed DAP Constraint.
 
#define NC_ETRANSLATION   (-76)
 Untranslatable construct.
 
#define NC4_FIRST_ERROR   (-100)
 
#define NC_EHDFERR   (-101)
 Error at HDF5 layer.
 
#define NC_ECANTREAD   (-102)
 Can't read.
 
#define NC_ECANTWRITE   (-103)
 Can't write.
 
#define NC_ECANTCREATE   (-104)
 Can't create.
 
#define NC_EFILEMETA   (-105)
 Problem with file metadata.
 
#define NC_EDIMMETA   (-106)
 Problem with dimension metadata.
 
#define NC_EATTMETA   (-107)
 Problem with attribute metadata.
 
#define NC_EVARMETA   (-108)
 Problem with variable metadata.
 
#define NC_ENOCOMPOUND   (-109)
 Not a compound type.
 
#define NC_EATTEXISTS   (-110)
 Attribute already exists.
 
#define NC_ENOTNC4   (-111)
 Attempting netcdf-4 operation on netcdf-3 file.
 
#define NC_ESTRICTNC3   (-112)
 Attempting netcdf-4 operation on strict nc3 netcdf-4 file.
 
#define NC_ENOTNC3   (-113)
 Attempting netcdf-3 operation on netcdf-4 file.
 
#define NC_ENOPAR   (-114)
 Parallel operation on file opened for non-parallel access.
 
#define NC_EPARINIT   (-115)
 Error initializing for parallel access.
 
#define NC_EBADGRPID   (-116)
 Bad group ID.
 
#define NC_EBADTYPID   (-117)
 Bad type ID.
 
#define NC_ETYPDEFINED   (-118)
 Type has already been defined and may not be edited.
 
#define NC_EBADFIELD   (-119)
 Bad field ID.
 
#define NC_EBADCLASS   (-120)
 Bad class.
 
#define NC_EMAPTYPE   (-121)
 Mapped access for atomic types only.
 
#define NC_ELATEFILL   (-122)
 Attempt to define fill value when data already exists.
 
#define NC_ELATEDEF   (-123)
 Attempt to define var properties, like deflate, after enddef.
 
#define NC_EDIMSCALE   (-124)
 Probem with HDF5 dimscales.
 
#define NC_ENOGRP   (-125)
 No group found.
 
#define NC_ESTORAGE   (-126)
 Can't specify both contiguous and chunking.
 
#define NC_EBADCHUNK   (-127)
 Bad chunksize.
 
#define NC_ENOTBUILT   (-128)
 Attempt to use feature that was not turned on when netCDF was built.
 
#define NC_EDISKLESS   (-129)
 Error in using diskless access.
 
#define NC4_LAST_ERROR   (-129)
 
#define DIM_WITHOUT_VARIABLE   "This is a netCDF dimension but not a netCDF variable."
 
#define NC_HAVE_NEW_CHUNKING_API   1
 
#define NC_EURL   (NC_EDAPURL) /* Malformed URL */
 
#define NC_ECONSTRAINT   (NC_EDAPCONSTRAINT) /* Malformed Constraint*/
 
#define MSC_EXTRA
 
#define EXTERNL   MSC_EXTRA extern
 
#define NC_INDEPENDENT   0
 
#define NC_COLLECTIVE   1
 
#define NC_COMPOUND_OFFSET(S, M)   (offsetof(S,M))
 Calculate an offset for creating a compound type.
 
#define ncvarcpy(ncid_in, varid, ncid_out)   ncvarcopy((ncid_in), (varid), (ncid_out))
 
#define nc_set_log_level(e)
 
#define NC_ENTOOL   NC_EMAXNAME /* Backward compatibility */
 
#define NC_EXDR   (-32) /* */
 
#define NC_SYSERR   (-31)
 
#define NC_FATAL   1
 
#define NC_VERBOSE   2
 
#define END_OF_MAIN()
 NO_NETCDF_2.
 
#define NC_FILL_BYTE   ((signed char)-127)
 Default fill value.
 
#define NC_FILL_CHAR   ((char)0)
 Default fill value.
 
#define NC_FILL_SHORT   ((short)-32767)
 Default fill value.
 
#define NC_FILL_INT   (-2147483647L)
 Default fill value.
 
#define NC_FILL_FLOAT   (9.9692099683868690e+36f) /* near 15 * 2^119 */
 Default fill value.
 
#define NC_FILL_DOUBLE   (9.9692099683868690e+36)
 Default fill value.
 
#define NC_FILL_UBYTE   (255)
 Default fill value.
 
#define NC_FILL_USHORT   (65535)
 Default fill value.
 
#define NC_FILL_UINT   (4294967295U)
 Default fill value.
 
#define NC_FILL_INT64   ((long long)-9223372036854775806LL)
 Default fill value.
 
#define NC_FILL_UINT64   ((unsigned long long)18446744073709551614ULL)
 Default fill value.
 
#define NC_FILL_STRING   ""
 Default fill value.
 
#define NC_MAX_BYTE   127
 Max or min values for a type.
 
#define NC_MIN_BYTE   (-NC_MAX_BYTE-1)
 Max or min values for a type.
 
#define NC_MAX_CHAR   255
 Max or min values for a type.
 
#define NC_MAX_SHORT   32767
 Max or min values for a type.
 
#define NC_MIN_SHORT   (-NC_MAX_SHORT - 1)
 Max or min values for a type.
 
#define NC_MAX_INT   2147483647
 Max or min values for a type.
 
#define NC_MIN_INT   (-NC_MAX_INT - 1)
 Max or min values for a type.
 
#define NC_MAX_FLOAT   3.402823466e+38f
 Max or min values for a type.
 
#define NC_MIN_FLOAT   (-NC_MAX_FLOAT)
 Max or min values for a type.
 
#define NC_MAX_DOUBLE   1.7976931348623157e+308
 Max or min values for a type.
 
#define NC_MIN_DOUBLE   (-NC_MAX_DOUBLE)
 Max or min values for a type.
 
#define NC_MAX_UBYTE   NC_MAX_CHAR
 Max or min values for a type.
 
#define NC_MAX_USHORT   65535U
 Max or min values for a type.
 
#define NC_MAX_UINT   4294967295U
 Max or min values for a type.
 
#define NC_MAX_INT64   (9223372036854775807LL)
 Max or min values for a type.
 
#define NC_MIN_INT64   (-9223372036854775807LL-1)
 Max or min values for a type.
 
#define NC_MAX_UINT64   (18446744073709551615ULL)
 Max or min values for a type.
 
#define X_INT64_MAX   (9223372036854775807LL)
 Max or min values for a type.
 
#define X_INT64_MIN   (-X_INT64_MAX - 1)
 Max or min values for a type.
 
#define X_UINT64_MAX   (18446744073709551615ULL)
 Max or min values for a type.
 
#define NC_FORMAT_CLASSIC   (1)
 Format specifier for nc_set_default_format().
 
#define NC_FORMAT_64BIT   (2)
 Format specifier for nc_set_default_format().
 
#define NC_FORMAT_NETCDF4   (3)
 Format specifier for nc_set_default_format().
 
#define NC_FORMAT_NETCDF4_CLASSIC   (4)
 Format specifier for nc_set_default_format().
 
#define NC_MAX_DIMS   1024
 Maximum for classic library.
 
#define NC_MAX_ATTRS   8192
 Maximum for classic library.
 
#define NC_MAX_VARS   8192
 Maximum for classic library.
 
#define NC_MAX_NAME   256
 Maximum for classic library.
 
#define NC_MAX_VAR_DIMS   1024
 max per variable dimensions
 
#define NC_ENDIAN_NATIVE   0
 In HDF5 files you can set the endianness of variables with nc_def_var_endian().
 
#define NC_ENDIAN_LITTLE   1
 In HDF5 files you can set the endianness of variables with nc_def_var_endian().
 
#define NC_ENDIAN_BIG   2
 In HDF5 files you can set the endianness of variables with nc_def_var_endian().
 
#define NC_CHUNKED   0
 In HDF5 files you can set storage for each variable to be either contiguous or chunked, with nc_def_var_chunking().
 
#define NC_CONTIGUOUS   1
 In HDF5 files you can set storage for each variable to be either contiguous or chunked, with nc_def_var_chunking().
 
#define NC_NOCHECKSUM   0
 In HDF5 files you can set check-summing for each variable.
 
#define NC_FLETCHER32   1
 In HDF5 files you can set check-summing for each variable.
 
#define NC_NOSHUFFLE   0
 Control the HDF5 shuffle filter.
 
#define NC_SHUFFLE   1
 Control the HDF5 shuffle filter.
 
#define FILL_BYTE   NC_FILL_BYTE
 Backward compatible alias.
 
#define FILL_CHAR   NC_FILL_CHAR
 Backward compatible alias.
 
#define FILL_SHORT   NC_FILL_SHORT
 Backward compatible alias.
 
#define FILL_LONG   NC_FILL_INT
 Backward compatible alias.
 
#define FILL_FLOAT   NC_FILL_FLOAT
 Backward compatible alias.
 
#define FILL_DOUBLE   NC_FILL_DOUBLE
 Backward compatible alias.
 
#define MAX_NC_DIMS   NC_MAX_DIMS
 Backward compatible alias.
 
#define MAX_NC_ATTRS   NC_MAX_ATTRS
 Backward compatible alias.
 
#define MAX_NC_VARS   NC_MAX_VARS
 Backward compatible alias.
 
#define MAX_NC_NAME   NC_MAX_NAME
 Backward compatible alias.
 
#define MAX_VAR_DIMS   NC_MAX_VAR_DIMS
 Backward compatible alias.
 

Typedefs

typedef int nc_type
 The nc_type type is just an int.
 
typedef int nclong
 

Functions

EXTERNL const char * nc_inq_libvers (void)
 Return the library version.
 
EXTERNL const char * nc_strerror (int ncerr)
 Given an error number, return an error message.
 
EXTERNL int nc__create (const char *path, int cmode, size_t initialsz, size_t *chunksizehintp, int *ncidp)
 Create a netCDF file with some extra parameters controlling classic file cacheing.
 
EXTERNL int nc_create (const char *path, int cmode, int *ncidp)
 Create a new netCDF file.
 
EXTERNL int nc__open (const char *path, int mode, size_t *chunksizehintp, int *ncidp)
 Open a netCDF file with extra performance parameters for the classic library.
 
EXTERNL int nc_open (const char *path, int mode, int *ncidp)
 Open an existing netCDF file.
 
EXTERNL int nc_inq_path (int ncid, size_t *pathlen, char *path)
 Get the file pathname (or the opendap URL) which was used to open/create the ncid's file.
 
EXTERNL int nc_var_par_access (int ncid, int varid, int par_access)
 
EXTERNL int nc_inq_ncid (int ncid, const char *name, int *grp_ncid)
 
EXTERNL int nc_inq_grps (int ncid, int *numgrps, int *ncids)
 
EXTERNL int nc_inq_grpname (int ncid, char *name)
 
EXTERNL int nc_inq_grpname_full (int ncid, size_t *lenp, char *full_name)
 
EXTERNL int nc_inq_grpname_len (int ncid, size_t *lenp)
 
EXTERNL int nc_inq_grp_parent (int ncid, int *parent_ncid)
 
EXTERNL int nc_inq_grp_ncid (int ncid, const char *grp_name, int *grp_ncid)
 
EXTERNL int nc_inq_grp_full_ncid (int ncid, const char *full_name, int *grp_ncid)
 
EXTERNL int nc_inq_varids (int ncid, int *nvars, int *varids)
 
EXTERNL int nc_inq_dimids (int ncid, int *ndims, int *dimids, int include_parents)
 
EXTERNL int nc_inq_typeids (int ncid, int *ntypes, int *typeids)
 
EXTERNL int nc_inq_type_equal (int ncid1, nc_type typeid1, int ncid2, nc_type typeid2, int *equal)
 
EXTERNL int nc_def_grp (int parent_ncid, const char *name, int *new_ncid)
 
EXTERNL int nc_def_compound (int ncid, size_t size, const char *name, nc_type *typeidp)
 Create a compound type.
 
EXTERNL int nc_insert_compound (int ncid, nc_type xtype, const char *name, size_t offset, nc_type field_typeid)
 Insert a named field into a compound type.
 
EXTERNL int nc_insert_array_compound (int ncid, nc_type xtype, const char *name, size_t offset, nc_type field_typeid, int ndims, const int *dim_sizes)
 Insert a named array field into a compound type.
 
EXTERNL int nc_inq_type (int ncid, nc_type xtype, char *name, size_t *size)
 Inquire about a type.
 
EXTERNL int nc_inq_typeid (int ncid, const char *name, nc_type *typeidp)
 Find a type by name.
 
EXTERNL int nc_inq_compound (int ncid, nc_type xtype, char *name, size_t *sizep, size_t *nfieldsp)
 Learn about a compound type.
 
EXTERNL int nc_inq_compound_name (int ncid, nc_type xtype, char *name)
 Learn the name of a compound type.
 
EXTERNL int nc_inq_compound_size (int ncid, nc_type xtype, size_t *sizep)
 Learn the size of a compound type.
 
EXTERNL int nc_inq_compound_nfields (int ncid, nc_type xtype, size_t *nfieldsp)
 Learn the number of fields in a compound type.
 
EXTERNL int nc_inq_compound_field (int ncid, nc_type xtype, int fieldid, char *name, size_t *offsetp, nc_type *field_typeidp, int *ndimsp, int *dim_sizesp)
 Get information about one of the fields of a compound type.
 
EXTERNL int nc_inq_compound_fieldname (int ncid, nc_type xtype, int fieldid, char *name)
 Get information about one of the fields of a compound type.
 
EXTERNL int nc_inq_compound_fieldindex (int ncid, nc_type xtype, const char *name, int *fieldidp)
 Learn the Index of a Named Field in a Compound Type.
 
EXTERNL int nc_inq_compound_fieldoffset (int ncid, nc_type xtype, int fieldid, size_t *offsetp)
 Get information about one of the fields of a compound type.
 
EXTERNL int nc_inq_compound_fieldtype (int ncid, nc_type xtype, int fieldid, nc_type *field_typeidp)
 Get information about one of the fields of a compound type.
 
EXTERNL int nc_inq_compound_fieldndims (int ncid, nc_type xtype, int fieldid, int *ndimsp)
 Get information about one of the fields of a compound type.
 
EXTERNL int nc_inq_compound_fielddim_sizes (int ncid, nc_type xtype, int fieldid, int *dim_sizes)
 Get information about one of the fields of a compound type.
 
EXTERNL int nc_def_vlen (int ncid, const char *name, nc_type base_typeid, nc_type *xtypep)
 Use this function to define a variable length array type.
 
EXTERNL int nc_inq_vlen (int ncid, nc_type xtype, char *name, size_t *datum_sizep, nc_type *base_nc_typep)
 Learn about a VLEN type.
 
EXTERNL int nc_free_vlen (nc_vlen_t *vl)
 Free memory in a VLEN object.
 
EXTERNL int nc_free_vlens (size_t len, nc_vlen_t vlens[])
 Free an array of vlens given the number of elements and an array.
 
EXTERNL int nc_put_vlen_element (int ncid, int typeid1, void *vlen_element, size_t len, const void *data)
 
EXTERNL int nc_get_vlen_element (int ncid, int typeid1, const void *vlen_element, size_t *len, void *data)
 
EXTERNL int nc_free_string (size_t len, char **data)
 Free string space allocated by the library.
 
EXTERNL int nc_inq_user_type (int ncid, nc_type xtype, char *name, size_t *size, nc_type *base_nc_typep, size_t *nfieldsp, int *classp)
 Learn about a user defined type.
 
EXTERNL int nc_put_att (int ncid, int varid, const char *name, nc_type xtype, size_t len, const void *op)
 Write an attribute.
 
EXTERNL int nc_get_att (int ncid, int varid, const char *name, void *ip)
 Get an attribute of any type.
 
EXTERNL int nc_def_enum (int ncid, nc_type base_typeid, const char *name, nc_type *typeidp)
 Create an enum type.
 
EXTERNL int nc_insert_enum (int ncid, nc_type xtype, const char *name, const void *value)
 Insert a named member into a enum type.
 
EXTERNL int nc_inq_enum (int ncid, nc_type xtype, char *name, nc_type *base_nc_typep, size_t *base_sizep, size_t *num_membersp)
 Learn about a user-define enumeration type.
 
EXTERNL int nc_inq_enum_member (int ncid, nc_type xtype, int idx, char *name, void *value)
 Learn about a about a member of an enum type.
 
EXTERNL int nc_inq_enum_ident (int ncid, nc_type xtype, long long value, char *identifier)
 Get the name which is associated with an enum member value.
 
EXTERNL int nc_def_opaque (int ncid, size_t size, const char *name, nc_type *xtypep)
 Create an opaque type.
 
EXTERNL int nc_inq_opaque (int ncid, nc_type xtype, char *name, size_t *sizep)
 Learn about an opaque type.
 
EXTERNL int nc_put_var (int ncid, int varid, const void *op)
 Write an entire variable with one call.
 
EXTERNL int nc_get_var (int ncid, int varid, void *ip)
 Read an entire variable in one call.
 
EXTERNL int nc_put_var1 (int ncid, int varid, const size_t *indexp, const void *op)
 Write one datum.
 
EXTERNL int nc_get_var1 (int ncid, int varid, const size_t *indexp, void *ip)
 Read a single datum from a variable.
 
EXTERNL int nc_put_vara (int ncid, int varid, const size_t *startp, const size_t *countp, const void *op)
 Write an array of values to a variable.
 
EXTERNL int nc_get_vara (int ncid, int varid, const size_t *startp, const size_t *countp, void *ip)
 Read an array of values from a variable.
 
EXTERNL int nc_put_vars (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const void *op)
 Write a strided array of values to a variable.
 
EXTERNL int nc_get_vars (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, void *ip)
 Read a strided array from a variable.
 
EXTERNL int nc_put_varm (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, const void *op)
 Write a mapped array of values to a variable.
 
EXTERNL int nc_get_varm (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, void *ip)
 Read a mapped array from a variable.
 
EXTERNL int nc_def_var_deflate (int ncid, int varid, int shuffle, int deflate, int deflate_level)
 
EXTERNL int nc_inq_var_deflate (int ncid, int varid, int *shufflep, int *deflatep, int *deflate_levelp)
 Learn the storage and deflate settings for a variable.
 
EXTERNL int nc_inq_var_szip (int ncid, int varid, int *options_maskp, int *pixels_per_blockp)
 Learn the szip settings of a variable.
 
EXTERNL int nc_def_var_fletcher32 (int ncid, int varid, int fletcher32)
 
EXTERNL int nc_inq_var_fletcher32 (int ncid, int varid, int *fletcher32p)
 Learn the checksum settings for a variable.
 
EXTERNL int nc_def_var_chunking (int ncid, int varid, int storage, const size_t *chunksizesp)
 
EXTERNL int nc_inq_var_chunking (int ncid, int varid, int *storagep, size_t *chunksizesp)
 This is a wrapper for nc_inq_var_all().
 
EXTERNL int nc_def_var_fill (int ncid, int varid, int no_fill, const void *fill_value)
 
EXTERNL int nc_inq_var_fill (int ncid, int varid, int *no_fill, void *fill_valuep)
 Learn the fill mode of a variable.
 
EXTERNL int nc_def_var_endian (int ncid, int varid, int endian)
 
EXTERNL int nc_inq_var_endian (int ncid, int varid, int *endianp)
 Find the endianness of a variable.
 
EXTERNL int nc_set_fill (int ncid, int fillmode, int *old_modep)
 Change the fill-value mode to improve write performance.
 
EXTERNL int nc_set_default_format (int format, int *old_formatp)
 
EXTERNL int nc_set_chunk_cache (size_t size, size_t nelems, float preemption)
 
EXTERNL int nc_get_chunk_cache (size_t *sizep, size_t *nelemsp, float *preemptionp)
 
EXTERNL int nc_set_var_chunk_cache (int ncid, int varid, size_t size, size_t nelems, float preemption)
 
EXTERNL int nc_get_var_chunk_cache (int ncid, int varid, size_t *sizep, size_t *nelemsp, float *preemptionp)
 
EXTERNL int nc_redef (int ncid)
 Put open netcdf dataset into define mode.
 
EXTERNL int nc__enddef (int ncid, size_t h_minfree, size_t v_align, size_t v_minfree, size_t r_align)
 Leave define mode with performance tuning.
 
EXTERNL int nc_enddef (int ncid)
 Leave define mode.
 
EXTERNL int nc_sync (int ncid)
 Synchronize an open netcdf dataset to disk.
 
EXTERNL int nc_abort (int ncid)
 
EXTERNL int nc_close (int ncid)
 Close an open netCDF dataset.
 
EXTERNL int nc_inq (int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp)
 Inquire about a file or group.
 
EXTERNL int nc_inq_ndims (int ncid, int *ndimsp)
 Find the number of dimensions.
 
EXTERNL int nc_inq_nvars (int ncid, int *nvarsp)
 
EXTERNL int nc_inq_natts (int ncid, int *nattsp)
 Find number of global or group attributes.
 
EXTERNL int nc_inq_unlimdim (int ncid, int *unlimdimidp)
 Find the ID of the unlimited dimension.
 
EXTERNL int nc_inq_unlimdims (int ncid, int *nunlimdimsp, int *unlimdimidsp)
 Return number and list of unlimited dimensions.
 
EXTERNL int nc_inq_format (int ncid, int *formatp)
 Inquire about the binary format of a netCDF file.
 
EXTERNL int nc_def_dim (int ncid, const char *name, size_t len, int *idp)
 Define a new dimension.
 
EXTERNL int nc_inq_dimid (int ncid, const char *name, int *idp)
 Find the ID of a dimension from the name.
 
EXTERNL int nc_inq_dim (int ncid, int dimid, char *name, size_t *lenp)
 Find the name and length of a dimension.
 
EXTERNL int nc_inq_dimname (int ncid, int dimid, char *name)
 Find out the name of a dimension.
 
EXTERNL int nc_inq_dimlen (int ncid, int dimid, size_t *lenp)
 Find the length of a dimension.
 
EXTERNL int nc_rename_dim (int ncid, int dimid, const char *name)
 Rename a dimension.
 
EXTERNL int nc_inq_att (int ncid, int varid, const char *name, nc_type *xtypep, size_t *lenp)
 Return information about a netCDF attribute.
 
EXTERNL int nc_inq_attid (int ncid, int varid, const char *name, int *idp)
 Find an attribute ID.
 
EXTERNL int nc_inq_atttype (int ncid, int varid, const char *name, nc_type *xtypep)
 Find the type of an attribute.
 
EXTERNL int nc_inq_attlen (int ncid, int varid, const char *name, size_t *lenp)
 Find the length of an attribute.
 
EXTERNL int nc_inq_attname (int ncid, int varid, int attnum, char *name)
 Find the name of an attribute.
 
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)
 Rename an attribute.
 
EXTERNL int nc_del_att (int ncid, int varid, const char *name)
 Delete an attribute.
 
EXTERNL int nc_put_att_text (int ncid, int varid, const char *name, size_t len, const char *op)
 Write a text attribute.
 
EXTERNL int nc_get_att_text (int ncid, int varid, const char *name, char *ip)
 Get an attribute.
 
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)
 
EXTERNL int nc_put_att_ushort (int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned short *op)
 
EXTERNL int nc_get_att_ushort (int ncid, int varid, const char *name, unsigned short *ip)
 
EXTERNL int nc_put_att_uint (int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned int *op)
 
EXTERNL int nc_get_att_uint (int ncid, int varid, const char *name, unsigned int *ip)
 
EXTERNL int nc_put_att_longlong (int ncid, int varid, const char *name, nc_type xtype, size_t len, const long long *op)
 
EXTERNL int nc_get_att_longlong (int ncid, int varid, const char *name, long long *ip)
 
EXTERNL int nc_put_att_ulonglong (int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned long long *op)
 
EXTERNL int nc_get_att_ulonglong (int ncid, int varid, const char *name, unsigned long long *ip)
 
EXTERNL int nc_put_att_string (int ncid, int varid, const char *name, size_t len, const char **op)
 Write a string attribute.
 
EXTERNL int nc_get_att_string (int ncid, int varid, const char *name, char **ip)
 
EXTERNL int nc_def_var (int ncid, const char *name, nc_type xtype, int ndims, const int *dimidsp, int *varidp)
 Define a new variable.
 
EXTERNL int nc_inq_var (int ncid, int varid, char *name, nc_type *xtypep, int *ndimsp, int *dimidsp, int *nattsp)
 Learn about a variable.
 
EXTERNL int nc_inq_varid (int ncid, const char *name, int *varidp)
 Find the ID of a variable, from the name.
 
EXTERNL int nc_inq_varname (int ncid, int varid, char *name)
 Learn the name of a variable.
 
EXTERNL int nc_inq_vartype (int ncid, int varid, nc_type *xtypep)
 Learn the type of a variable.
 
EXTERNL int nc_inq_varndims (int ncid, int varid, int *ndimsp)
 Learn how many dimensions are associated with a variable.
 
EXTERNL int nc_inq_vardimid (int ncid, int varid, int *dimidsp)
 Learn the dimension IDs associated with a variable.
 
EXTERNL int nc_inq_varnatts (int ncid, int varid, int *nattsp)
 Learn how many attributes are associated with a variable.
 
EXTERNL int nc_rename_var (int ncid, int varid, const char *name)
 Rename a variable.
 
EXTERNL int nc_copy_var (int ncid_in, int varid, int ncid_out)
 
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)
 
EXTERNL int nc_put_var1_ushort (int ncid, int varid, const size_t *indexp, const unsigned short *op)
 
EXTERNL int nc_get_var1_ushort (int ncid, int varid, const size_t *indexp, unsigned short *ip)
 
EXTERNL int nc_put_var1_uint (int ncid, int varid, const size_t *indexp, const unsigned int *op)
 
EXTERNL int nc_get_var1_uint (int ncid, int varid, const size_t *indexp, unsigned int *ip)
 
EXTERNL int nc_put_var1_longlong (int ncid, int varid, const size_t *indexp, const long long *op)
 
EXTERNL int nc_get_var1_longlong (int ncid, int varid, const size_t *indexp, long long *ip)
 
EXTERNL int nc_put_var1_ulonglong (int ncid, int varid, const size_t *indexp, const unsigned long long *op)
 
EXTERNL int nc_get_var1_ulonglong (int ncid, int varid, const size_t *indexp, unsigned long long *ip)
 
EXTERNL int nc_put_var1_string (int ncid, int varid, const size_t *indexp, const char **op)
 
EXTERNL int nc_get_var1_string (int ncid, int varid, const size_t *indexp, char **ip)
 
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)
 
EXTERNL int nc_put_vara_ushort (int ncid, int varid, const size_t *startp, const size_t *countp, const unsigned short *op)
 
EXTERNL int nc_get_vara_ushort (int ncid, int varid, const size_t *startp, const size_t *countp, unsigned short *ip)
 
EXTERNL int nc_put_vara_uint (int ncid, int varid, const size_t *startp, const size_t *countp, const unsigned int *op)
 
EXTERNL int nc_get_vara_uint (int ncid, int varid, const size_t *startp, const size_t *countp, unsigned int *ip)
 
EXTERNL int nc_put_vara_longlong (int ncid, int varid, const size_t *startp, const size_t *countp, const long long *op)
 
EXTERNL int nc_get_vara_longlong (int ncid, int varid, const size_t *startp, const size_t *countp, long long *ip)
 
EXTERNL int nc_put_vara_ulonglong (int ncid, int varid, const size_t *startp, const size_t *countp, const unsigned long long *op)
 
EXTERNL int nc_get_vara_ulonglong (int ncid, int varid, const size_t *startp, const size_t *countp, unsigned long long *ip)
 
EXTERNL int nc_put_vara_string (int ncid, int varid, const size_t *startp, const size_t *countp, const char **op)
 
EXTERNL int nc_get_vara_string (int ncid, int varid, const size_t *startp, const size_t *countp, char **ip)
 
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)
 
EXTERNL int nc_put_vars_ushort (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const unsigned short *op)
 
EXTERNL int nc_get_vars_ushort (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, unsigned short *ip)
 
EXTERNL int nc_put_vars_uint (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const unsigned int *op)
 
EXTERNL int nc_get_vars_uint (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, unsigned int *ip)
 
EXTERNL int nc_put_vars_longlong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const long long *op)
 
EXTERNL int nc_get_vars_longlong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, long long *ip)
 
EXTERNL int nc_put_vars_ulonglong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const unsigned long long *op)
 
EXTERNL int nc_get_vars_ulonglong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, unsigned long long *ip)
 
EXTERNL int nc_put_vars_string (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const char **op)
 
EXTERNL int nc_get_vars_string (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, char **ip)
 
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 *imapp, double *ip)
 
EXTERNL int nc_put_varm_ushort (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, const unsigned short *op)
 
EXTERNL int nc_get_varm_ushort (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, unsigned short *ip)
 
EXTERNL int nc_put_varm_uint (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, const unsigned int *op)
 
EXTERNL int nc_get_varm_uint (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, unsigned int *ip)
 
EXTERNL int nc_put_varm_longlong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, const long long *op)
 
EXTERNL int nc_get_varm_longlong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, long long *ip)
 
EXTERNL int nc_put_varm_ulonglong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, const unsigned long long *op)
 
EXTERNL int nc_get_varm_ulonglong (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, const ptrdiff_t *imapp, unsigned long long *ip)
 
EXTERNL int nc_put_varm_string (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_string (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_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)
 
EXTERNL int nc_put_var_ushort (int ncid, int varid, const unsigned short *op)
 
EXTERNL int nc_get_var_ushort (int ncid, int varid, unsigned short *ip)
 
EXTERNL int nc_put_var_uint (int ncid, int varid, const unsigned int *op)
 
EXTERNL int nc_get_var_uint (int ncid, int varid, unsigned int *ip)
 
EXTERNL int nc_put_var_longlong (int ncid, int varid, const long long *op)
 
EXTERNL int nc_get_var_longlong (int ncid, int varid, long long *ip)
 
EXTERNL int nc_put_var_ulonglong (int ncid, int varid, const unsigned long long *op)
 
EXTERNL int nc_get_var_ulonglong (int ncid, int varid, unsigned long long *ip)
 
EXTERNL int nc_put_var_string (int ncid, int varid, const char **op)
 
EXTERNL int nc_get_var_string (int ncid, int varid, char **ip)
 
EXTERNL int nc_put_att_ubyte (int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned char *op)
 
EXTERNL int nc_get_att_ubyte (int ncid, int varid, const char *name, unsigned char *ip)
 
EXTERNL int nc_put_var1_ubyte (int ncid, int varid, const size_t *indexp, const unsigned char *op)
 
EXTERNL int nc_get_var1_ubyte (int ncid, int varid, const size_t *indexp, unsigned char *ip)
 
EXTERNL int nc_put_vara_ubyte (int ncid, int varid, const size_t *startp, const size_t *countp, const unsigned char *op)
 
EXTERNL int nc_get_vara_ubyte (int ncid, int varid, const size_t *startp, const size_t *countp, unsigned char *ip)
 
EXTERNL int nc_put_vars_ubyte (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_ubyte (int ncid, int varid, const size_t *startp, const size_t *countp, const ptrdiff_t *stridep, unsigned char *ip)
 
EXTERNL int nc_put_varm_ubyte (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_ubyte (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_var_ubyte (int ncid, int varid, const unsigned char *op)
 
EXTERNL int nc_get_var_ubyte (int ncid, int varid, unsigned char *ip)
 
EXTERNL int nc_show_metadata (int ncid)
 
EXTERNL int nc__create_mp (const char *path, int cmode, size_t initialsz, int basepe, size_t *chunksizehintp, int *ncidp)
 
EXTERNL int nc__open_mp (const char *path, int mode, int basepe, size_t *chunksizehintp, int *ncidp)
 
EXTERNL int nc_delete (const char *path)
 
EXTERNL int nc_delete_mp (const char *path, int basepe)
 
EXTERNL int nc_set_base_pe (int ncid, int pe)
 
EXTERNL int nc_inq_base_pe (int ncid, int *pe)
 
EXTERNL int nctypelen (nc_type datatype)
 
EXTERNL void nc_advise (const char *cdf_routine_name, int err, const char *fmt,...)
 
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)
 

Variables

EXTERNL int ncerr
 
EXTERNL int ncopts
 

Detailed Description

Main header file for the C API.

Copyright 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 University Corporation for Atmospheric Research/Unidata. See Copyright file for more info.

Definition in file netcdf.h.

Macro Definition Documentation

#define _FillValue   "_FillValue"

Name of fill value attribute.

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 this reserved name. The value you give the attribute will be used as the fill value for that variable.

Definition at line 108 of file netcdf.h.

#define FILL_BYTE   NC_FILL_BYTE

Backward compatible alias.

Definition at line 1709 of file netcdf.h.

#define FILL_CHAR   NC_FILL_CHAR

Backward compatible alias.

Definition at line 1710 of file netcdf.h.

#define FILL_DOUBLE   NC_FILL_DOUBLE

Backward compatible alias.

Definition at line 1714 of file netcdf.h.

#define FILL_FLOAT   NC_FILL_FLOAT

Backward compatible alias.

Definition at line 1713 of file netcdf.h.

#define FILL_LONG   NC_FILL_INT

Backward compatible alias.

Definition at line 1712 of file netcdf.h.

#define FILL_SHORT   NC_FILL_SHORT

Backward compatible alias.

Definition at line 1711 of file netcdf.h.

#define MAX_NC_ATTRS   NC_MAX_ATTRS

Backward compatible alias.

Definition at line 1717 of file netcdf.h.

#define MAX_NC_DIMS   NC_MAX_DIMS

Backward compatible alias.

Definition at line 1716 of file netcdf.h.

#define MAX_NC_NAME   NC_MAX_NAME

Backward compatible alias.

Definition at line 1719 of file netcdf.h.

#define MAX_NC_VARS   NC_MAX_VARS

Backward compatible alias.

Definition at line 1718 of file netcdf.h.

#define MAX_VAR_DIMS   NC_MAX_VAR_DIMS

Backward compatible alias.

Definition at line 1720 of file netcdf.h.

#define NC2_ERR   (-1)

Returned for all errors in the v2 API.

Definition at line 243 of file netcdf.h.

#define NC_64BIT_OFFSET   0x0200

Use large (64-bit) file offsets.

Mode flag for nc_create().

Definition at line 127 of file netcdf.h.

#define NC_ALIGN_CHUNK   ((size_t)(-1))

In nc__enddef(), align to the chunk size.

Definition at line 165 of file netcdf.h.

#define NC_CHUNKED   0

In HDF5 files you can set storage for each variable to be either contiguous or chunked, with nc_def_var_chunking().

This define is used there.

Definition at line 214 of file netcdf.h.

#define NC_CLASSIC_MODEL   0x0100

Enforce classic model.

Mode flag for nc_create().

Definition at line 126 of file netcdf.h.

#define NC_CLOBBER   0x0000

Destroy existing file.

Mode flag for nc_create().

Examples:
pres_temp_4D_wr.c, sfc_pres_temp_wr.c, simple_nc4_wr.c, and simple_xy_wr.c.

Definition at line 120 of file netcdf.h.

#define NC_COMPOUND_OFFSET (   S,
 
)    (offsetof(S,M))

Calculate an offset for creating a compound type.

This calls a mysterious C macro which was found carved into one of the blocks of the Newgrange passage tomb in County Meath, Ireland. This code has been carbon dated to 3200 B.C.E.

Definition at line 597 of file netcdf.h.

#define NC_CONTIGUOUS   1

In HDF5 files you can set storage for each variable to be either contiguous or chunked, with nc_def_var_chunking().

This define is used there.

Definition at line 215 of file netcdf.h.

#define NC_DISKLESS   0x0008

Use diskless file.

Mode flag for nc_open() or nc_create().

Definition at line 123 of file netcdf.h.

#define NC_EATTEXISTS   (-110)

Attribute already exists.

Definition at line 351 of file netcdf.h.

#define NC_EATTMETA   (-107)

Problem with attribute metadata.

Definition at line 348 of file netcdf.h.

#define NC_EAXISTYPE   (-65)

Unknown axis type.

Definition at line 321 of file netcdf.h.

#define NC_EBADCHUNK   (-127)

Bad chunksize.

Definition at line 370 of file netcdf.h.

#define NC_EBADCLASS   (-120)

Bad class.

Definition at line 363 of file netcdf.h.

#define NC_EBADFIELD   (-119)

Bad field ID.

Definition at line 362 of file netcdf.h.

#define NC_EBADGRPID   (-116)

Bad group ID.

Definition at line 359 of file netcdf.h.

#define NC_EBADID   (-33)

Not a netcdf id.

The specified netCDF ID does not refer to an open netCDF dataset.

Definition at line 249 of file netcdf.h.

#define NC_EBADTYPID   (-117)

Bad type ID.

Definition at line 360 of file netcdf.h.

#define NC_ECANTCREATE   (-104)

Can't create.

Definition at line 345 of file netcdf.h.

#define NC_ECANTREAD   (-102)

Can't read.

Definition at line 343 of file netcdf.h.

#define NC_ECANTWRITE   (-103)

Can't write.

Definition at line 344 of file netcdf.h.

#define NC_EDIMMETA   (-106)

Problem with dimension metadata.

Definition at line 347 of file netcdf.h.

#define NC_EDIMSCALE   (-124)

Probem with HDF5 dimscales.

Definition at line 367 of file netcdf.h.

#define NC_EDISKLESS   (-129)

Error in using diskless access.

Definition at line 372 of file netcdf.h.

#define NC_EEDGE   (-57)

Start+count exceeds dimension bound.

The specified edge lengths added to the specified corner would have referenced data out of range for the rank of the specified variable. For example, an edge length that is larger than the corresponding dimension length minus the corner index will cause an error.

Definition at line 307 of file netcdf.h.

#define NC_EFILEMETA   (-105)

Problem with file metadata.

Definition at line 346 of file netcdf.h.

#define NC_EHDFERR   (-101)

Error at HDF5 layer.

Definition at line 342 of file netcdf.h.

#define NC_EINDEFINE   (-39)

Operation not allowed in define mode.

The specified netCDF is in define mode rather than data mode.

With netCDF-4/HDF5 files, this error will not occur, unless NC_CLASSIC_MODEL was used in nc_create().

Definition at line 267 of file netcdf.h.

#define NC_EINVALCOORDS   (-40)

Index exceeds dimension bound.

The specified corner indices were out of range for the rank of the specified variable. For example, a negative index or an index that is larger than the corresponding dimension length will cause an error.

Definition at line 274 of file netcdf.h.

#define NC_ELATEDEF   (-123)

Attempt to define var properties, like deflate, after enddef.

Definition at line 366 of file netcdf.h.

#define NC_ELATEFILL   (-122)

Attempt to define fill value when data already exists.

Definition at line 365 of file netcdf.h.

#define NC_EMAPTYPE   (-121)

Mapped access for atomic types only.

Definition at line 364 of file netcdf.h.

#define NC_EMAXVARS   (-48)

NC_MAX_VARS exceeded.

Max number of variables exceeded in a classic or 64-bit offset file, or an netCDF-4 file with NC_CLASSIC_MODEL on.

Definition at line 286 of file netcdf.h.

#define NC_ENDIAN_BIG   2

In HDF5 files you can set the endianness of variables with nc_def_var_endian().

This define is used there.

Definition at line 207 of file netcdf.h.

#define NC_ENDIAN_LITTLE   1

In HDF5 files you can set the endianness of variables with nc_def_var_endian().

This define is used there.

Definition at line 206 of file netcdf.h.

#define NC_ENDIAN_NATIVE   0

In HDF5 files you can set the endianness of variables with nc_def_var_endian().

This define is used there.

Definition at line 205 of file netcdf.h.

#define NC_ENOCOMPOUND   (-109)

Not a compound type.

Definition at line 350 of file netcdf.h.

#define NC_ENOGRP   (-125)

No group found.

Definition at line 368 of file netcdf.h.

#define NC_ENOPAR   (-114)

Parallel operation on file opened for non-parallel access.

Definition at line 357 of file netcdf.h.

#define NC_ENOTBUILT   (-128)

Attempt to use feature that was not turned on when netCDF was built.

Definition at line 371 of file netcdf.h.

#define NC_ENOTINDEFINE   (-38)

Operation not allowed in data mode.

This is returned for netCDF classic or 64-bit offset files, or for netCDF-4 files, when they were been created with NC_CLASSIC_MODEL flag in nc_create().

Definition at line 258 of file netcdf.h.

#define NC_ENOTNC3   (-113)

Attempting netcdf-3 operation on netcdf-4 file.

Definition at line 356 of file netcdf.h.

#define NC_ENOTNC4   (-111)

Attempting netcdf-4 operation on netcdf-3 file.

Definition at line 352 of file netcdf.h.

#define NC_ENOTVAR   (-49)

Variable not found.

The variable ID is invalid for the specified netCDF dataset.

Definition at line 291 of file netcdf.h.

#define NC_EPARINIT   (-115)

Error initializing for parallel access.

Definition at line 358 of file netcdf.h.

#define NC_ERANGE   (-60)

Math result not representable.

One or more of the values are out of the range of values representable by the desired type.

Definition at line 316 of file netcdf.h.

#define NC_ESTORAGE   (-126)

Can't specify both contiguous and chunking.

Definition at line 369 of file netcdf.h.

#define NC_ESTRICTNC3   (-112)

Attempting netcdf-4 operation on strict nc3 netcdf-4 file.

Definition at line 355 of file netcdf.h.

#define NC_ETYPDEFINED   (-118)

Type has already been defined and may not be edited.

Definition at line 361 of file netcdf.h.

#define NC_EVARMETA   (-108)

Problem with variable metadata.

Definition at line 349 of file netcdf.h.

#define NC_FILL_BYTE   ((signed char)-127)

Default fill value.

This is 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.

Definition at line 59 of file netcdf.h.

#define NC_FILL_CHAR   ((char)0)

Default fill value.

This is 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.

Definition at line 60 of file netcdf.h.

#define NC_FILL_DOUBLE   (9.9692099683868690e+36)

Default fill value.

This is 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.

Definition at line 64 of file netcdf.h.

#define NC_FILL_FLOAT   (9.9692099683868690e+36f) /* near 15 * 2^119 */

Default fill value.

This is 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.

Definition at line 63 of file netcdf.h.

#define NC_FILL_INT   (-2147483647L)

Default fill value.

This is 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.

Definition at line 62 of file netcdf.h.

#define NC_FILL_INT64   ((long long)-9223372036854775806LL)

Default fill value.

This is 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.

Definition at line 68 of file netcdf.h.

#define NC_FILL_SHORT   ((short)-32767)

Default fill value.

This is 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.

Definition at line 61 of file netcdf.h.

#define NC_FILL_STRING   ""

Default fill value.

This is 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.

Definition at line 70 of file netcdf.h.

#define NC_FILL_UBYTE   (255)

Default fill value.

This is 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.

Definition at line 65 of file netcdf.h.

#define NC_FILL_UINT   (4294967295U)

Default fill value.

This is 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.

Definition at line 67 of file netcdf.h.

#define NC_FILL_UINT64   ((unsigned long long)18446744073709551614ULL)

Default fill value.

This is 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.

Definition at line 69 of file netcdf.h.

#define NC_FILL_USHORT   (65535)

Default fill value.

This is 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.

Definition at line 66 of file netcdf.h.

#define NC_FLETCHER32   1

In HDF5 files you can set check-summing for each variable.

Currently the only checksum available is Fletcher-32, which can be set with the function nc_def_var_fletcher32. These defines are used there.

Definition at line 224 of file netcdf.h.

#define NC_FORMAT_64BIT   (2)

Format specifier for nc_set_default_format().

Starting with version 3.6, there are different format netCDF files. 4.0 introduces the third one.

See Also
netcdf_format

Definition at line 155 of file netcdf.h.

#define NC_FORMAT_CLASSIC   (1)

Format specifier for nc_set_default_format().

Starting with version 3.6, there are different format netCDF files. 4.0 introduces the third one.

See Also
netcdf_format

Definition at line 154 of file netcdf.h.

#define NC_FORMAT_NETCDF4   (3)

Format specifier for nc_set_default_format().

Starting with version 3.6, there are different format netCDF files. 4.0 introduces the third one.

See Also
netcdf_format

Definition at line 156 of file netcdf.h.

#define NC_FORMAT_NETCDF4_CLASSIC   (4)

Format specifier for nc_set_default_format().

Starting with version 3.6, there are different format netCDF files. 4.0 introduces the third one.

See Also
netcdf_format

Definition at line 157 of file netcdf.h.

#define NC_GLOBAL   -1

Attribute id to put/get a global attribute.

Definition at line 171 of file netcdf.h.

#define NC_ISSYSERR (   err)    ((err) > 0)

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.

Definition at line 240 of file netcdf.h.

#define NC_LOCK   0x0400
Deprecated:
The following flag currently is ignored, but use in nc_open() or nc_create() may someday support use of advisory locking to prevent multiple writers from clobbering a file

Definition at line 133 of file netcdf.h.

#define NC_LONG   NC_INT

deprecated, but required for backward compatibility.

Definition at line 32 of file netcdf.h.

#define NC_MAX_ATTRS   8192

Maximum for classic library.

In the classic netCDF model there are maximum values for the number of dimensions in the file (NC_MAX_DIMS), the number of global or per variable attributes (NC_MAX_ATTRS), the number of variables in the file (NC_MAX_VARS), and the length of a name (NC_MAX_NAME).

This maximum is enforced by the interface, to facilitate writing applications and utilities. However, nothing is statically allocated to this size internally.

This maximum is not used for netCDF-4/HDF5 files unless they were created with the NC_CLASSIC_MODEL flag.

As a rule, NC_MAX_VAR_DIMS <= NC_MAX_DIMS.

Definition at line 193 of file netcdf.h.

#define NC_MAX_BYTE   127

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 81 of file netcdf.h.

#define NC_MAX_CHAR   255

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 83 of file netcdf.h.

#define NC_MAX_DIMS   1024

Maximum for classic library.

In the classic netCDF model there are maximum values for the number of dimensions in the file (NC_MAX_DIMS), the number of global or per variable attributes (NC_MAX_ATTRS), the number of variables in the file (NC_MAX_VARS), and the length of a name (NC_MAX_NAME).

This maximum is enforced by the interface, to facilitate writing applications and utilities. However, nothing is statically allocated to this size internally.

This maximum is not used for netCDF-4/HDF5 files unless they were created with the NC_CLASSIC_MODEL flag.

As a rule, NC_MAX_VAR_DIMS <= NC_MAX_DIMS.

Definition at line 192 of file netcdf.h.

#define NC_MAX_DOUBLE   1.7976931348623157e+308

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 90 of file netcdf.h.

#define NC_MAX_FLOAT   3.402823466e+38f

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 88 of file netcdf.h.

#define NC_MAX_HDF4_NAME   64

This is the max size of an SD dataset name in HDF4 (from HDF4 documentation).

Definition at line 200 of file netcdf.h.

#define NC_MAX_INT   2147483647

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 86 of file netcdf.h.

#define NC_MAX_INT64   (9223372036854775807LL)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 95 of file netcdf.h.

#define NC_MAX_NAME   256

Maximum for classic library.

In the classic netCDF model there are maximum values for the number of dimensions in the file (NC_MAX_DIMS), the number of global or per variable attributes (NC_MAX_ATTRS), the number of variables in the file (NC_MAX_VARS), and the length of a name (NC_MAX_NAME).

This maximum is enforced by the interface, to facilitate writing applications and utilities. However, nothing is statically allocated to this size internally.

This maximum is not used for netCDF-4/HDF5 files unless they were created with the NC_CLASSIC_MODEL flag.

As a rule, NC_MAX_VAR_DIMS <= NC_MAX_DIMS.

Definition at line 195 of file netcdf.h.

#define NC_MAX_SHORT   32767

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 84 of file netcdf.h.

#define NC_MAX_UBYTE   NC_MAX_CHAR

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 92 of file netcdf.h.

#define NC_MAX_UINT   4294967295U

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 94 of file netcdf.h.

#define NC_MAX_UINT64   (18446744073709551615ULL)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 97 of file netcdf.h.

#define NC_MAX_USHORT   65535U

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 93 of file netcdf.h.

#define NC_MAX_VARS   8192

Maximum for classic library.

In the classic netCDF model there are maximum values for the number of dimensions in the file (NC_MAX_DIMS), the number of global or per variable attributes (NC_MAX_ATTRS), the number of variables in the file (NC_MAX_VARS), and the length of a name (NC_MAX_NAME).

This maximum is enforced by the interface, to facilitate writing applications and utilities. However, nothing is statically allocated to this size internally.

This maximum is not used for netCDF-4/HDF5 files unless they were created with the NC_CLASSIC_MODEL flag.

As a rule, NC_MAX_VAR_DIMS <= NC_MAX_DIMS.

Definition at line 194 of file netcdf.h.

#define NC_MIN_BYTE   (-NC_MAX_BYTE-1)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 82 of file netcdf.h.

#define NC_MIN_DOUBLE   (-NC_MAX_DOUBLE)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 91 of file netcdf.h.

#define NC_MIN_FLOAT   (-NC_MAX_FLOAT)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 89 of file netcdf.h.

#define NC_MIN_INT   (-NC_MAX_INT - 1)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 87 of file netcdf.h.

#define NC_MIN_INT64   (-9223372036854775807LL-1)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 96 of file netcdf.h.

#define NC_MIN_SHORT   (-NC_MAX_SHORT - 1)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 85 of file netcdf.h.

#define NC_MMAP   0x0010

Use diskless file with mmap.

Mode flag for nc_open() or nc_create().

Definition at line 124 of file netcdf.h.

#define NC_MPIIO   0x2000

Turn on MPI I/O.

Use this in mode flags for both nc_create() and nc_open().

Definition at line 143 of file netcdf.h.

#define NC_MPIPOSIX   0x4000

Turn on MPI POSIX I/O.

Use this in mode flags for both nc_create() and nc_open().

Definition at line 146 of file netcdf.h.

#define NC_NETCDF4   0x1000

Use netCDF-4/HDF5 format.

Mode flag for nc_create().

Examples:
simple_nc4_wr.c, and simple_xy_nc4_wr.c.

Definition at line 139 of file netcdf.h.

#define NC_NOCHECKSUM   0

In HDF5 files you can set check-summing for each variable.

Currently the only checksum available is Fletcher-32, which can be set with the function nc_def_var_fletcher32. These defines are used there.

Definition at line 223 of file netcdf.h.

#define NC_NOCLOBBER   0x0004

Don't destroy existing file.

Mode flag for nc_create().

Definition at line 121 of file netcdf.h.

#define NC_NOFILL   0x100

Argument to nc_set_fill() to turn off filling of data.

Definition at line 110 of file netcdf.h.

#define NC_NOSHUFFLE   0

Control the HDF5 shuffle filter.

In HDF5 files you can specify that a shuffle filter should be used on each chunk of a variable to improve compression for that variable. This per-variable shuffle property can be set with the function nc_def_var_deflate().

Definition at line 232 of file netcdf.h.

#define NC_NOWRITE   0x0000

Set read-only access for nc_open().

Examples:
pres_temp_4D_rd.c, sfc_pres_temp_rd.c, simple_nc4_rd.c, simple_xy_nc4_rd.c, and simple_xy_rd.c.

Definition at line 117 of file netcdf.h.

#define NC_PNETCDF   0x8000

Use parallel-netcdf library.

Mode flag for nc_open().

Definition at line 147 of file netcdf.h.

#define NC_SHARE   0x0800

Share updates, limit cacheing.

Use this in mode flags for both nc_create() and nc_open().

Definition at line 137 of file netcdf.h.

#define NC_SHUFFLE   1

Control the HDF5 shuffle filter.

In HDF5 files you can specify that a shuffle filter should be used on each chunk of a variable to improve compression for that variable. This per-variable shuffle property can be set with the function nc_def_var_deflate().

Examples:
simple_xy_nc4_wr.c.

Definition at line 233 of file netcdf.h.

#define NC_SIZEHINT_DEFAULT   0

Let nc__create() or nc__open() figure out as suitable chunk size.

Definition at line 162 of file netcdf.h.

#define NC_UNLIMITED   0L

Size argument to nc_def_dim() for an unlimited dimension.

Examples:
pres_temp_4D_wr.c.

Definition at line 168 of file netcdf.h.

#define NC_WRITE   0x0001

Set read-write access for nc_open().

Definition at line 118 of file netcdf.h.

#define X_INT64_MAX   (9223372036854775807LL)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 98 of file netcdf.h.

#define X_INT64_MIN   (-X_INT64_MAX - 1)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 99 of file netcdf.h.

#define X_UINT64_MAX   (18446744073709551615ULL)

Max or min values for a type.

Nothing greater/smaller can be stored in a netCDF file for their associated types. Recall that a C compiler may define int to be any length it wants, but a NC_INT is always a 4 byte signed int. On a platform with 64 bit ints, there will be many ints which are outside the range supported by NC_INT. But since NC_INT is an external format, it has to mean the same thing everywhere.

Definition at line 100 of file netcdf.h.

Typedef Documentation

typedef int nc_type

The nc_type type is just an int.

Definition at line 18 of file netcdf.h.

Function Documentation

EXTERNL int nc_inq_unlimdims ( int  ncid,
int *  nunlimdimsp,
int *  unlimdimidsp 
)

Return number and list of unlimited dimensions.

In netCDF-4 files, it's possible to have multiple unlimited dimensions. This function returns a list of the unlimited dimension ids visible in a group.

Dimensions are visible in a group if they have been defined in that group, or any ancestor group.

ncid NetCDF group ID, from a previous call to nc_open, nc_create, nc_def_grp, etc. nunlimdimsp A pointer to an int which will get the number of visible unlimited dimensions. Ignored if NULL. unlimdimidsp A pointer to an already allocated array of int which will get the ids of all visible unlimited dimensions. Ignored if NULL. To allocate the correct length for this array, call nc_inq_unlimdims with a NULL for this parameter and use the nunlimdimsp parameter to get the number of visible unlimited dimensions.

Errors

NC_NOERR No error. NC_EBADID Bad group id. NC_ENOTNC4 Attempting a netCDF-4 operation on a netCDF-3 file. NetCDF-4 operations can only be performed on files defined with a create mode which includes flag HDF5. (see nc_open). NC_ESTRICTNC3 This file was created with the strict netcdf-3 flag, therefore netcdf-4 operations are not allowed. (see nc_open). NC_EHDFERR An error was reported by the HDF5 layer.

Definition at line 563 of file dvarinq.c.


Generated on Wed Aug 22 2012 14:39:41 for netCDF. NetCDF is a Unidata library.