mirror of
https://github.com/Unidata/netcdf-c.git
synced 2024-11-21 03:13:42 +08:00
6934aa2e8b
re: https://github.com/Unidata/netcdf-c/issues/1373 (partial) * Mark some global constants be const to indicate to make them easier to track. * Hide direct access to the ncrc_globalstate behind a function call. * Convert dispatch tables to constants (except the user defined ones) This has some consequences in terms of function arguments needing to be marked as const also. * Remove some no longer needed global fields * Aggregate all the globals in nclog.c * Uniformly replace nc_sizevector{0,1} with NC_coord_{zero,one} * Uniformly replace nc_ptrdffvector1 with NC_stride_one * Remove some obsolete code
87 lines
2.5 KiB
C
87 lines
2.5 KiB
C
/*
|
|
* Copyright 2018, University Corporation for Atmospheric Research
|
|
* See netcdf/COPYRIGHT file for copying and redistribution conditions.
|
|
*/
|
|
#ifndef _NC_H_
|
|
#define _NC_H_
|
|
|
|
#include "config.h"
|
|
#include "netcdf.h"
|
|
|
|
/* Forward */
|
|
struct NCmodel;
|
|
|
|
/* There's an external ncid (ext_ncid) and an internal ncid
|
|
* (int_ncid). The ext_ncid is the ncid returned to the user. If
|
|
* the user has opened or created a netcdf-4 file, then the
|
|
* ext_ncid is the same as the int_ncid. If he has opened or
|
|
* created a netcdf-3 file ext_ncid (which the user sees) is
|
|
* different from the int_ncid, which is the ncid returned by the
|
|
* netcdf-3 layer, which insists on inventing its own ncids,
|
|
* regardless of what is already in use due to previously opened
|
|
* netcdf-4 files. The ext_ncid contains the ncid for the root
|
|
* group (i.e. group zero). */
|
|
|
|
/* Common Shared Structure for all Dispatched Objects */
|
|
typedef struct NC {
|
|
int ext_ncid;
|
|
int int_ncid;
|
|
const struct NC_Dispatch* dispatch;
|
|
void* dispatchdata; /*per-'file' data; points to e.g. NC3_INFO data*/
|
|
char* path;
|
|
int mode; /* as provided to nc_open/nc_create */
|
|
struct NCmodel* model; /* as determined by libdispatch/dfile.c */
|
|
#ifdef USE_REFCOUNT
|
|
int refcount; /* To enable multiple name-based opens */
|
|
#endif
|
|
} NC;
|
|
|
|
/*
|
|
* Counted string for names and such
|
|
*/
|
|
typedef struct {
|
|
/* all xdr'd */
|
|
size_t nchars;
|
|
char *cp;
|
|
} NC_string;
|
|
|
|
/* Define functions that are used across multiple dispatchers */
|
|
|
|
/* Begin defined in string.c */
|
|
extern void
|
|
free_NC_string(NC_string *ncstrp);
|
|
|
|
extern int
|
|
NC_check_name(const char *name);
|
|
|
|
extern NC_string *
|
|
new_NC_string(size_t slen, const char *str);
|
|
extern int
|
|
set_NC_string(NC_string *ncstrp, const char *str);
|
|
|
|
/* End defined in string.c */
|
|
|
|
extern int
|
|
NC_check_id(int ncid, NC **ncpp);
|
|
|
|
/* Create a pseudo file descriptor that does not
|
|
overlap real file descriptors */
|
|
extern int nc__pseudofd(void);
|
|
|
|
/* This function gets a current default create flag */
|
|
extern int nc_get_default_format(void);
|
|
|
|
extern int add_to_NCList(NC*);
|
|
extern void del_from_NCList(NC*);/* does not free object */
|
|
extern NC* find_in_NCList(int ext_ncid);
|
|
extern NC* find_in_NCList_by_name(const char*);
|
|
extern void free_NCList(void);/* reclaim whole list */
|
|
extern int count_NCList(void); /* return # of entries in NClist */
|
|
extern int iterate_NCList(int i,NC**); /* Walk from 0 ...; ERANGE return => stop */
|
|
|
|
/* Defined in nc.c */
|
|
extern void free_NC(NC*);
|
|
extern int new_NC(const struct NC_Dispatch*, const char*, int, struct NCmodel*, NC**);
|
|
|
|
#endif /* _NC_H_ */
|