netcdf-c/libsrc4/netcdf3.h
2010-06-03 13:24:43 +00:00

752 lines
19 KiB
C
Executable File
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
This file is part of netcdf-4, a netCDF-like interface for HDF5, or a
HDF5 backend for netCDF, depending on your point of view.
This file contains prototypes for the netcdf-3 functions from libsrc,
which have all be renamed to nc3_* from nc_*.
Copyright 2003, University Corporation for Atmospheric Research. See
netcdf-4/docs/COPYRIGHT file for copying and redistribution
conditions.
$Id: netcdf3.h,v 1.5 2005/08/11 15:35:44 ed Exp $
*/
#ifndef _NETCDF3_
#define _NETCDF3_
#include <stddef.h> /* size_t, ptrdiff_t */
#include <errno.h> /* netcdf functions sometimes return system errors */
#include "netcdf.h"
#if defined(__cplusplus)
extern "C" {
#endif
/*
* 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 *
nc3_inq_libvers(void);
EXTERNL const char *
nc3_strerror(int ncerr1);
EXTERNL int
nc3__create(const char *path, int cmode, size_t initialsz,
size_t *chunksizehintp, int *ncidp);
EXTERNL int
nc3_create(const char *path, int cmode, int *ncidp);
EXTERNL int
nc3__open(const char *path, int mode,
size_t *chunksizehintp, int *ncidp);
EXTERNL int
nc3_open(const char *path, int mode, int *ncidp);
EXTERNL int
nc3_set_fill(int ncid, int fillmode, int *old_modep);
EXTERNL int
nc3_redef(int ncid);
EXTERNL int
nc3__enddef(int ncid, size_t h_minfree, size_t v_align,
size_t v_minfree, size_t r_align);
EXTERNL int
nc3_enddef(int ncid);
EXTERNL int
nc3_sync(int ncid);
EXTERNL int
nc3_abort(int ncid);
EXTERNL int
nc3_close(int ncid);
EXTERNL int
nc3_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp);
EXTERNL int
nc3_inq_ndims(int ncid, int *ndimsp);
EXTERNL int
nc3_inq_nvars(int ncid, int *nvarsp);
EXTERNL int
nc3_inq_natts(int ncid, int *nattsp);
EXTERNL int
nc3_inq_unlimdim(int ncid, int *unlimdimidp);
EXTERNL int
nc3_inq_format(int ncid, int *formatp);
/* Begin _dim */
EXTERNL int
nc3_def_dim(int ncid, const char *name, size_t len, int *idp);
EXTERNL int
nc3_inq_dimid(int ncid, const char *name, int *idp);
EXTERNL int
nc3_inq_dim(int ncid, int dimid, char *name, size_t *lenp);
EXTERNL int
nc3_inq_dimname(int ncid, int dimid, char *name);
EXTERNL int
nc3_inq_dimlen(int ncid, int dimid, size_t *lenp);
EXTERNL int
nc3_rename_dim(int ncid, int dimid, const char *name);
/* End _dim */
/* Begin _att */
EXTERNL int
nc3_inq_att(int ncid, int varid, const char *name,
nc_type *xtypep, size_t *lenp);
EXTERNL int
nc3_inq_attid(int ncid, int varid, const char *name, int *idp);
EXTERNL int
nc3_inq_atttype(int ncid, int varid, const char *name, nc_type *xtypep);
EXTERNL int
nc3_inq_attlen(int ncid, int varid, const char *name, size_t *lenp);
EXTERNL int
nc3_inq_attname(int ncid, int varid, int attnum, char *name);
EXTERNL int
nc3_copy_att(int ncid_in, int varid_in, const char *name, int ncid_out, int varid_out);
EXTERNL int
nc3_rename_att(int ncid, int varid, const char *name, const char *newname);
EXTERNL int
nc3_del_att(int ncid, int varid, const char *name);
/* End _att */
/* Begin {put,get}_att */
EXTERNL int
nc3_put_att_text(int ncid, int varid, const char *name,
size_t len, const char *op);
EXTERNL int
nc3_get_att_text(int ncid, int varid, const char *name, char *ip);
EXTERNL int
nc3_put_att_uchar(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const unsigned char *op);
EXTERNL int
nc3_get_att_uchar(int ncid, int varid, const char *name, unsigned char *ip);
EXTERNL int
nc3_put_att_schar(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const signed char *op);
EXTERNL int
nc3_get_att_schar(int ncid, int varid, const char *name, signed char *ip);
EXTERNL int
nc3_put_att_short(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const short *op);
EXTERNL int
nc3_get_att_short(int ncid, int varid, const char *name, short *ip);
EXTERNL int
nc3_put_att_int(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const int *op);
EXTERNL int
nc3_get_att_int(int ncid, int varid, const char *name, int *ip);
EXTERNL int
nc3_put_att_long(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const long *op);
EXTERNL int
nc3_get_att_long(int ncid, int varid, const char *name, long *ip);
EXTERNL int
nc3_put_att_float(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const float *op);
EXTERNL int
nc3_get_att_float(int ncid, int varid, const char *name, float *ip);
EXTERNL int
nc3_put_att_double(int ncid, int varid, const char *name, nc_type xtype,
size_t len, const double *op);
EXTERNL int
nc3_get_att_double(int ncid, int varid, const char *name, double *ip);
/* End {put,get}_att */
/* Begin _var */
EXTERNL int
nc3_def_var(int ncid, const char *name,
nc_type xtype, int ndims, const int *dimidsp, int *varidp);
EXTERNL int
nc3_inq_var(int ncid, int varid, char *name,
nc_type *xtypep, int *ndimsp, int *dimidsp, int *nattsp);
EXTERNL int
nc3_inq_varid(int ncid, const char *name, int *varidp);
EXTERNL int
nc3_inq_varname(int ncid, int varid, char *name);
EXTERNL int
nc3_inq_vartype(int ncid, int varid, nc_type *xtypep);
EXTERNL int
nc3_inq_varndims(int ncid, int varid, int *ndimsp);
EXTERNL int
nc3_inq_vardimid(int ncid, int varid, int *dimidsp);
EXTERNL int
nc3_inq_varnatts(int ncid, int varid, int *nattsp);
EXTERNL int
nc3_rename_var(int ncid, int varid, const char *name);
EXTERNL int
nc3_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
nc3_put_var1_text(int ncid, int varid, const size_t *indexp, const char *op);
EXTERNL int
nc3_get_var1_text(int ncid, int varid, const size_t *indexp, char *ip);
EXTERNL int
nc3_put_var1_uchar(int ncid, int varid, const size_t *indexp,
const unsigned char *op);
EXTERNL int
nc3_get_var1_uchar(int ncid, int varid, const size_t *indexp,
unsigned char *ip);
EXTERNL int
nc3_put_var1_schar(int ncid, int varid, const size_t *indexp,
const signed char *op);
EXTERNL int
nc3_get_var1_schar(int ncid, int varid, const size_t *indexp,
signed char *ip);
EXTERNL int
nc3_put_var1_short(int ncid, int varid, const size_t *indexp,
const short *op);
EXTERNL int
nc3_get_var1_short(int ncid, int varid, const size_t *indexp,
short *ip);
EXTERNL int
nc3_put_var1_int(int ncid, int varid, const size_t *indexp, const int *op);
EXTERNL int
nc3_get_var1_int(int ncid, int varid, const size_t *indexp, int *ip);
EXTERNL int
nc3_put_var1_long(int ncid, int varid, const size_t *indexp, const long *op);
EXTERNL int
nc3_get_var1_long(int ncid, int varid, const size_t *indexp, long *ip);
EXTERNL int
nc3_put_var1_float(int ncid, int varid, const size_t *indexp, const float *op);
EXTERNL int
nc3_get_var1_float(int ncid, int varid, const size_t *indexp, float *ip);
EXTERNL int
nc3_put_var1_double(int ncid, int varid, const size_t *indexp, const double *op);
EXTERNL int
nc3_get_var1_double(int ncid, int varid, const size_t *indexp, double *ip);
/* End {put,get}_var1 */
/* Begin {put,get}_vara */
EXTERNL int
nc3_put_vara_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const char *op);
EXTERNL int
nc3_get_vara_text(int ncid, int varid,
const size_t *startp, const size_t *countp, char *ip);
EXTERNL int
nc3_put_vara_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, const unsigned char *op);
EXTERNL int
nc3_get_vara_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, unsigned char *ip);
EXTERNL int
nc3_put_vara_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, const signed char *op);
EXTERNL int
nc3_get_vara_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, signed char *ip);
EXTERNL int
nc3_put_vara_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const short *op);
EXTERNL int
nc3_get_vara_short(int ncid, int varid,
const size_t *startp, const size_t *countp, short *ip);
EXTERNL int
nc3_put_vara_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const int *op);
EXTERNL int
nc3_get_vara_int(int ncid, int varid,
const size_t *startp, const size_t *countp, int *ip);
EXTERNL int
nc3_put_vara_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const long *op);
EXTERNL int
nc3_get_vara_long(int ncid, int varid,
const size_t *startp, const size_t *countp, long *ip);
EXTERNL int
nc3_put_vara_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const float *op);
EXTERNL int
nc3_get_vara_float(int ncid, int varid,
const size_t *startp, const size_t *countp, float *ip);
EXTERNL int
nc3_put_vara_double(int ncid, int varid,
const size_t *startp, const size_t *countp, const double *op);
EXTERNL int
nc3_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
nc3_put_vars_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const char *op);
EXTERNL int
nc3_get_vars_text(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
char *ip);
EXTERNL int
nc3_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
nc3_get_vars_uchar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
unsigned char *ip);
EXTERNL int
nc3_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
nc3_get_vars_schar(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
signed char *ip);
EXTERNL int
nc3_put_vars_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const short *op);
EXTERNL int
nc3_get_vars_short(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
short *ip);
EXTERNL int
nc3_put_vars_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const int *op);
EXTERNL int
nc3_get_vars_int(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
int *ip);
EXTERNL int
nc3_put_vars_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const long *op);
EXTERNL int
nc3_get_vars_long(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
long *ip);
EXTERNL int
nc3_put_vars_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const float *op);
EXTERNL int
nc3_get_vars_float(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
float *ip);
EXTERNL int
nc3_put_vars_double(int ncid, int varid,
const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
const double *op);
EXTERNL int
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_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
nc3_put_var_text(int ncid, int varid, const char *op);
EXTERNL int
nc3_get_var_text(int ncid, int varid, char *ip);
EXTERNL int
nc3_put_var_uchar(int ncid, int varid, const unsigned char *op);
EXTERNL int
nc3_get_var_uchar(int ncid, int varid, unsigned char *ip);
EXTERNL int
nc3_put_var_schar(int ncid, int varid, const signed char *op);
EXTERNL int
nc3_get_var_schar(int ncid, int varid, signed char *ip);
EXTERNL int
nc3_put_var_short(int ncid, int varid, const short *op);
EXTERNL int
nc3_get_var_short(int ncid, int varid, short *ip);
EXTERNL int
nc3_put_var_int(int ncid, int varid, const int *op);
EXTERNL int
nc3_get_var_int(int ncid, int varid, int *ip);
EXTERNL int
nc3_put_var_long(int ncid, int varid, const long *op);
EXTERNL int
nc3_get_var_long(int ncid, int varid, long *ip);
EXTERNL int
nc3_put_var_float(int ncid, int varid, const float *op);
EXTERNL int
nc3_get_var_float(int ncid, int varid, float *ip);
EXTERNL int
nc3_put_var_double(int ncid, int varid, const double *op);
EXTERNL int
nc3_get_var_double(int ncid, int varid, double *ip);
EXTERNL int
nc3_put_var1(int ncid, int varid, const size_t *indexp,
const void *op);
/* Read one value of a var of compound type. */
EXTERNL int
nc3_get_var1(int ncid, int varid, const size_t *indexp,
void *ip);
/* Write an array of values of a var of compound type. */
EXTERNL int
nc3_put_vara(int ncid, int varid, const size_t *startp,
const size_t *countp, const void *op);
/* Read an array of values of a var of compound type. */
EXTERNL int
nc3_get_vara(int ncid, int varid, const size_t *startp,
const size_t *countp, void *ip);
/* Write slices of an array of values of a var of compound type. */
EXTERNL int
nc3_put_vars(int ncid, int varid, const size_t *startp,
const size_t *countp, const ptrdiff_t *stridep,
const void *op);
/* Read slices of an array of values of a var of compound type. */
EXTERNL int
nc3_get_vars(int ncid, int varid, const size_t *startp,
const size_t *countp, const ptrdiff_t *stridep,
void *ip);
/* Write mapped slices of an array of values of a var of compound
* type. */
EXTERNL int
nc3_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);
/* Read mapped slices of an array of values of a var of compound
* type. */
EXTERNL int
nc3_get_varm(int ncid, int varid, const size_t *startp,
const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp, void *ip);
/* Write entire var of any type. */
EXTERNL int
nc3_put_var(int ncid, int varid, const void *op);
/* Read entire var of any type. */
EXTERNL int
nc3_get_var(int ncid, int varid, void *ip);
/* Write one value. */
EXTERNL int
nc3_put_var1(int ncid, int varid, const size_t *indexp,
const void *op);
/* Read one value. */
EXTERNL int
nc3_get_var1(int ncid, int varid, const size_t *indexp, void *ip);
/* Write an array of values. */
EXTERNL int
nc3_put_vara(int ncid, int varid, const size_t *startp,
const size_t *countp, const void *op);
/* Read an array of values. */
EXTERNL int
nc3_get_vara(int ncid, int varid, const size_t *startp,
const size_t *countp, void *ip);
/* Write slices of an array of values. */
EXTERNL int
nc3_put_vars(int ncid, int varid, const size_t *startp,
const size_t *countp, const ptrdiff_t *stridep,
const void *op);
/* Read slices of an array of values. */
EXTERNL int
nc3_get_vars(int ncid, int varid, const size_t *startp,
const size_t *countp, const ptrdiff_t *stridep,
void *ip);
/* Write mapped slices of an array of values. */
EXTERNL int
nc3_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);
/* Read mapped slices of an array of values. */
EXTERNL int
nc3_get_varm(int ncid, int varid, const size_t *startp,
const size_t *countp, const ptrdiff_t *stridep,
const ptrdiff_t *imapp, void *ip);
/* End {put,get}_var */
/* #ifdef _CRAYMPP */
/*
* Public interfaces to better support
* CRAY multi-processor systems like T3E.
* A tip of the hat to NERSC.
*/
/*
* It turns out we need to declare and define
* these public interfaces on all platforms
* or things get ugly working out the
* FORTRAN interface. On !_CRAYMPP platforms,
* these functions work as advertised, but you
* can only use "processor element" 0.
*/
EXTERNL int
nc3__create_mp(const char *path, int cmode, size_t initialsz, int basepe,
size_t *chunksizehintp, int *ncidp);
EXTERNL int
nc3__open_mp(const char *path, int mode, int basepe,
size_t *chunksizehintp, int *ncidp);
EXTERNL int
nc3_delete_mp(const char * path, int basepe);
EXTERNL int
nc3_set_base_pe(int ncid, int pe);
EXTERNL int
nc3_inq_base_pe(int ncid, int *pe);
/* #endif _CRAYMPP */
extern int
nc3_put_att(int ncid, int varid, const char *name, nc_type datatype,
size_t len, const void *value);
extern int
nc3_get_att(int ncid, int varid, const char *name, void *value);
#if defined(__cplusplus)
}
#endif
#endif