netcdf-c/include/nc4dispatch.h

267 lines
6.6 KiB
C
Raw Normal View History

/* Copyright 2018-2018 University Corporation for Atmospheric
2018-11-26 20:20:35 +08:00
Research/Unidata. */
/**
* @file
* @internal Includes prototypes for libsrc4 dispatch functions.
2010-08-18 23:11:17 +08:00
*
2018-11-26 20:20:35 +08:00
* @author Dennis Heimbigner, Ed Hartnett
*/
2010-06-03 21:24:43 +08:00
#ifndef _NC4DISPATCH_H
#define _NC4DISPATCH_H
2011-09-26 18:14:55 +08:00
#include "config.h"
2010-06-03 21:24:43 +08:00
#include <stddef.h> /* size_t, ptrdiff_t */
#include "ncdispatch.h"
2010-06-03 21:24:43 +08:00
2018-11-26 20:20:35 +08:00
#define NCLOGLEVELENV "NETCDF_LOG_LEVEL"
2010-06-03 21:24:43 +08:00
#if defined(__cplusplus)
extern "C" {
#endif
EXTERNL int
NC4_create(const char *path, int cmode,
size_t initialsz, int basepe, size_t *chunksizehintp,
2019-08-02 04:30:20 +08:00
void* parameters, const NC_Dispatch*, int);
EXTERNL int
NC4_open(const char *path, int mode,
int basepe, size_t *chunksizehintp,
2019-08-02 04:30:20 +08:00
void* parameters, const NC_Dispatch*, int);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_redef(int ncid);
EXTERNL int
NC4__enddef(int ncid, size_t h_minfree, size_t v_align,
size_t v_minfree, size_t r_align);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_sync(int ncid);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_abort(int ncid);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_close(int ncid,void*);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_set_fill(int ncid, int fillmode, int *old_modep);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_format(int ncid, int *formatp);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_format_extended(int ncid, int *formatp, int *modep);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp);
EXTERNL int
NC4_inq_type(int, nc_type, char *, size_t *);
2010-06-03 21:24:43 +08:00
/* Begin _dim */
EXTERNL int
NC4_def_dim(int ncid, const char *name, size_t len, int *idp);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_dimid(int ncid, const char *name, int *idp);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_dim(int ncid, int dimid, char *name, size_t *lenp);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_unlimdim(int ncid, int *unlimdimidp);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_rename_dim(int ncid, int dimid, const char *name);
2010-06-03 21:24:43 +08:00
/* End _dim */
/* Begin _att */
EXTERNL int
NC4_inq_att(int ncid, int varid, const char *name,
nc_type *xtypep, size_t *lenp);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_attid(int ncid, int varid, const char *name, int *idp);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_attname(int ncid, int varid, int attnum, char *name);
2010-06-03 21:24:43 +08:00
/* End _att */
/* Begin {put,get}_att */
EXTERNL int
NC4_get_att(int ncid, int varid, const char *name, void *value, nc_type);
2010-06-03 21:24:43 +08:00
/* End {put,get}_att */
/* Begin _var */
EXTERNL int
NC4_def_var(int ncid, const char *name,
nc_type xtype, int ndims, const int *dimidsp, int *varidp);
EXTERNL int
NC4_inq_var_all(int ncid, int varid, char *name, nc_type *xtypep,
int *ndimsp, int *dimidsp, int *nattsp,
int *shufflep, int *deflatep, int *deflate_levelp,
int *fletcher32p, int *contiguousp, size_t *chunksizesp,
int *no_fill, void *fill_valuep, int *endiannessp,
unsigned int* idp, size_t* nparamsp, unsigned int* params
);
EXTERNL int
NC4_inq_varid(int ncid, const char *name, int *varidp);
EXTERNL int
NC4_rename_var(int ncid, int varid, const char *name);
EXTERNL int
NC4_put_vara(int ncid, int varid,
const size_t *start, const size_t *count,
const void *value, nc_type);
EXTERNL int
NC4_get_vara(int ncid, int varid,
const size_t *start, const size_t *count,
void *value, nc_type);
extern int
NC4_put_vars(int ncid, int varid,
const size_t *start, const size_t *count, const ptrdiff_t* stride,
const void *value, nc_type);
extern int
NC4_get_vars(int ncid, int varid,
const size_t *start, const size_t *count, const ptrdiff_t* stride,
void *value, nc_type);
2010-06-03 21:24:43 +08:00
/* End _var */
/* netCDF4 API only */
EXTERNL int
NC4_var_par_access(int, int, int);
2018-11-26 20:20:35 +08:00
EXTERNL int
NC4_inq_ncid(int, const char *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_grps(int, int *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_grpname(int, char *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_grpname_full(int, size_t *, char *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_grp_parent(int, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_grp_full_ncid(int, const char *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_varids(int, int * nvars, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_dimids(int, int * ndims, int *, int);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_typeids(int, int * ntypes, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_type_equal(int, nc_type, int, nc_type, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_grp(int, const char *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_rename_grp(int, const char *);
EXTERNL int
NC4_inq_user_type(int, nc_type, char *, size_t *, nc_type *,
size_t *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_compound(int, size_t, const char *, nc_type *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_insert_compound(int, nc_type, const char *, size_t, nc_type);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_insert_array_compound(int, nc_type, const char *, size_t,
nc_type, int, const int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_typeid(int, const char *, nc_type *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_compound_field(int, nc_type, int, char *, size_t *,
nc_type *, int *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_compound_fieldindex(int, nc_type, const char *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_vlen(int, const char *, nc_type base_typeid, nc_type *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_put_vlen_element(int, int, void *, size_t, const void *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_get_vlen_element(int, int, const void *, size_t *, void *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_enum(int, nc_type, const char *, nc_type *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_insert_enum(int, nc_type, const char *, const void *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_enum_member(int, nc_type, int, char *, void *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_enum_ident(int, nc_type, long long, char *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_opaque(int, size_t, const char *, nc_type *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_var_deflate(int, int, int, int, int);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_var_fletcher32(int, int, int);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_var_chunking(int, int, int, const size_t *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_var_fill(int, int, int, const void *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_var_endian(int, int, int);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_def_var_filter(int, int, unsigned int, size_t, const unsigned int*);
EXTERNL int
NC4_get_var_chunk_cache(int, int, size_t *, size_t *, float *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_inq_unlimdims(int, int *, int *);
2010-06-03 21:24:43 +08:00
EXTERNL int
NC4_show_metadata(int);
2010-06-03 21:24:43 +08:00
Add support for multiple filters per variable. re: https://github.com/Unidata/netcdf-c/issues/1584 Support has been added for multiple filters per variable. This affects a number of components in netcdf. The new APIs are documented in NUG/filters.md. The primary changes are: * A set of new functions are provided (see __include/netcdf_filter.h__). - Obtain a list of the filters associated with a variable - Obtain the parameters for a specific filter. * The existing __nc_inq_var_filter__ function now returns info about the first defined filter. * The utilities (ncgen, ncdump, and nccopy) now support an extended format for specifying a sequence of filters. The general form is __<filter>|<filter>..._. * The ncdump **_Filter** attribute now dumps a list of all the filters associated with a variable using the above new format. * Filter specifications can now use a filter name instead of number for filters known to the netcdf library, which in turn is taken from the HDF5 filter registration page. * New errors are defined: NC_EFILTER and NC_ENOFILTER. The latter is returned if an attempt is made to access an unknown filter. * Internally, the dispatch table has been extended to add a function to handle all of the filter functions. * New, filter-related, tests were added to nc_test4. * A new plugin was added to the plugins directory to help with testing. Notes: 1. The shuffle and fletcher32 filters are not part of the multifilter system. Misc. changes: 1. A debug module was added to libhdf5 to help catch error locations.
2020-02-17 03:59:33 +08:00
EXTERNL int
NC4_filter_actions(int, int, int, struct NC_Filterobject*);
2010-06-03 21:24:43 +08:00
#if defined(__cplusplus)
}
#endif
2010-08-18 23:11:17 +08:00
#endif /*_NC4DISPATCH_H */