NetCDF 4.9.3-rc2
Loading...
Searching...
No Matches
netcdf.h
Go to the documentation of this file.
1
13#ifndef _NETCDF_
14#define _NETCDF_
15
16#include <stddef.h> /* size_t, ptrdiff_t */
17#include <errno.h> /* netcdf functions sometimes return system errors */
18
19/* Required for alloca on Windows */
20#if defined(_WIN32) || defined(_WIN64)
21#include <malloc.h>
22#endif
23
25typedef int nc_type;
26
27#if defined(__cplusplus)
28extern "C" {
29#endif
30
31/*
32 * The netcdf external data types
33 */
34#define NC_NAT 0
35#define NC_BYTE 1
36#define NC_CHAR 2
37#define NC_SHORT 3
38#define NC_INT 4
39#define NC_LONG NC_INT
40#define NC_FLOAT 5
41#define NC_DOUBLE 6
42#define NC_UBYTE 7
43#define NC_USHORT 8
44#define NC_UINT 9
45#define NC_INT64 10
46#define NC_UINT64 11
47#define NC_STRING 12
49#define NC_MAX_ATOMIC_TYPE NC_STRING
51/* The following are use internally in support of user-defines
52 * types. They are also the class returned by nc_inq_user_type. */
53#define NC_VLEN 13
54#define NC_OPAQUE 14
55#define NC_ENUM 15
56#define NC_COMPOUND 16
60#define NC_FIRSTUSERTYPEID 32
61
67#define NC_FILL_BYTE ((signed char)-127)
68#define NC_FILL_CHAR ((char)0)
69#define NC_FILL_SHORT ((short)-32767)
70#define NC_FILL_INT (-2147483647)
71#define NC_FILL_FLOAT (9.9692099683868690e+36f) /* near 15 * 2^119 */
72#define NC_FILL_DOUBLE (9.9692099683868690e+36)
73#define NC_FILL_UBYTE (255)
74#define NC_FILL_USHORT (65535)
75#define NC_FILL_UINT (4294967295U)
76#define NC_FILL_INT64 ((long long)-9223372036854775806LL)
77#define NC_FILL_UINT64 ((unsigned long long)18446744073709551614ULL)
78#define NC_FILL_STRING ((char *)"")
89#define NC_MAX_BYTE 127
90#define NC_MIN_BYTE (-NC_MAX_BYTE-1)
91#define NC_MAX_CHAR 255
92#define NC_MAX_SHORT 32767
93#define NC_MIN_SHORT (-NC_MAX_SHORT - 1)
94#define NC_MAX_INT 2147483647
95#define NC_MIN_INT (-NC_MAX_INT - 1)
96#define NC_MAX_FLOAT 3.402823466e+38f
97#define NC_MIN_FLOAT (-NC_MAX_FLOAT)
98#define NC_MAX_DOUBLE 1.7976931348623157e+308
99#define NC_MIN_DOUBLE (-NC_MAX_DOUBLE)
100#define NC_MAX_UBYTE NC_MAX_CHAR
101#define NC_MAX_USHORT 65535U
102#define NC_MAX_UINT 4294967295U
103#define NC_MAX_INT64 (9223372036854775807LL)
104#define NC_MIN_INT64 (-9223372036854775807LL-1)
105#define NC_MAX_UINT64 (18446744073709551615ULL)
118#ifdef NETCDF_ENABLE_LEGACY_MACROS
119#define _FillValue "_FillValue"
120#endif
121#define NC_FillValue "_FillValue"
122#define NC_FILL 0
123#define NC_NOFILL 0x100
125/* Define the ioflags bits for nc_create and nc_open.
126 Currently unused in lower 16 bits:
127 0x0002
128 All upper 16 bits are unused except
129 0x20000
130 0x40000
131*/
132
133/* Lower 16 bits */
134
135#define NC_NOWRITE 0x0000
136#define NC_WRITE 0x0001
138#define NC_CLOBBER 0x0000
139#define NC_NOCLOBBER 0x0004
140#define NC_DISKLESS 0x0008
141#define NC_MMAP 0x0010
143#define NC_64BIT_DATA 0x0020
144#define NC_CDF5 NC_64BIT_DATA
146#define NC_UDF0 0x0040
147#define NC_UDF1 0x0080
149#define NC_CLASSIC_MODEL 0x0100
150#define NC_64BIT_OFFSET 0x0200
156#define NC_LOCK 0x0400
157
160#define NC_SHARE 0x0800
161
162#define NC_NETCDF4 0x1000
167#define NC_MPIIO 0x2000
168#define NC_MPIPOSIX NC_MPIIO
169#define NC_PNETCDF (NC_MPIIO)
171#define NC_PERSIST 0x4000
172#define NC_INMEMORY 0x8000
174/* Upper 16 bits */
175#define NC_NOATTCREORD 0x20000
176#define NC_NODIMSCALE_ATTACH 0x40000
178#define NC_MAX_MAGIC_NUMBER_LEN 8
187#define NC_FORMAT_CLASSIC (1)
188/* After adding CDF5 support, the NC_FORMAT_64BIT
189 flag is somewhat confusing. So, it is renamed.
190 Note that the name in the contributed code
191 NC_FORMAT_64BIT was renamed to NC_FORMAT_CDF2
192*/
193#define NC_FORMAT_64BIT_OFFSET (2)
194#define NC_FORMAT_64BIT (NC_FORMAT_64BIT_OFFSET)
195#define NC_FORMAT_NETCDF4 (3)
196#define NC_FORMAT_NETCDF4_CLASSIC (4)
197#define NC_FORMAT_64BIT_DATA (5)
198
199/* Alias */
200#define NC_FORMAT_CDF5 NC_FORMAT_64BIT_DATA
201
202/* Define a mask covering format flags only */
203#define NC_FORMAT_ALL (NC_64BIT_OFFSET|NC_64BIT_DATA|NC_CLASSIC_MODEL|NC_NETCDF4|NC_UDF0|NC_UDF1)
204
225#define NC_FORMATX_NC3 (1)
226#define NC_FORMATX_NC_HDF5 (2)
227#define NC_FORMATX_NC4 NC_FORMATX_NC_HDF5
228#define NC_FORMATX_NC_HDF4 (3)
229#define NC_FORMATX_PNETCDF (4)
230#define NC_FORMATX_DAP2 (5)
231#define NC_FORMATX_DAP4 (6)
232#define NC_FORMATX_UDF0 (8)
233#define NC_FORMATX_UDF1 (9)
234#define NC_FORMATX_NCZARR (10)
235#define NC_FORMATX_UNDEFINED (0)
236
237 /* To avoid breaking compatibility (such as in the python library),
238 we need to retain the NC_FORMAT_xxx format as well. This may come
239 out eventually, as the NC_FORMATX is more clear that it's an extended
240 format specifier.*/
241
242#define NC_FORMAT_NC3 NC_FORMATX_NC3
243#define NC_FORMAT_NC_HDF5 NC_FORMATX_NC_HDF5
244#define NC_FORMAT_NC4 NC_FORMATX_NC4
245#define NC_FORMAT_NC_HDF4 NC_FORMATX_NC_HDF4
246#define NC_FORMAT_PNETCDF NC_FORMATX_PNETCDF
247#define NC_FORMAT_DAP2 NC_FORMATX_DAP2
248#define NC_FORMAT_DAP4 NC_FORMATX_DAP4
249#define NC_FORMAT_UNDEFINED NC_FORMATX_UNDEFINED
250#define NC_FORMATX_ZARR NC_FORMATX_NCZARR
255#define NC_SIZEHINT_DEFAULT 0
256
258#define NC_ALIGN_CHUNK ((size_t)(-1))
259
261#define NC_UNLIMITED 0L
262
264#define NC_GLOBAL -1
265
288#define NC_MAX_DIMS 1024 /* not enforced after 4.5.0 */
289#define NC_MAX_ATTRS 8192 /* not enforced after 4.5.0 */
290#define NC_MAX_VARS 8192 /* not enforced after 4.5.0 */
291#define NC_MAX_NAME 256
292#define NC_MAX_VAR_DIMS 1024
299#define NC_MAX_HDF4_NAME NC_MAX_NAME
300
304#define NC_ENDIAN_NATIVE 0
305#define NC_ENDIAN_LITTLE 1
306#define NC_ENDIAN_BIG 2
314#define NC_CHUNKED 0
315#define NC_CONTIGUOUS 1
316#define NC_COMPACT 2
317#define NC_UNKNOWN_STORAGE 3
318#define NC_VIRTUAL 4
326#define NC_NOCHECKSUM 0
327#define NC_FLETCHER32 1
335#define NC_NOSHUFFLE 0
336#define NC_SHUFFLE 1
339#define NC_MIN_DEFLATE_LEVEL 0
340#define NC_MAX_DEFLATE_LEVEL 9
342#define NC_SZIP_NN 32
343#define NC_SZIP_EC 4
345#define NC_NOQUANTIZE 0
346#define NC_QUANTIZE_BITGROOM 1
347#define NC_QUANTIZE_GRANULARBR 2
348#define NC_QUANTIZE_BITROUND 3
353#define NC_QUANTIZE_BITGROOM_ATT_NAME "_QuantizeBitGroomNumberOfSignificantDigits"
354#define NC_QUANTIZE_GRANULARBR_ATT_NAME "_QuantizeGranularBitRoundNumberOfSignificantDigits"
355#define NC_QUANTIZE_BITROUND_ATT_NAME "_QuantizeBitRoundNumberOfSignificantBits"
361#define NC_QUANTIZE_MAX_FLOAT_NSD (7)
362#define NC_QUANTIZE_MAX_FLOAT_NSB (23)
368#define NC_QUANTIZE_MAX_DOUBLE_NSD (15)
369#define NC_QUANTIZE_MAX_DOUBLE_NSB (52)
376#define NC_ISSYSERR(err) ((err) > 0)
377
378#define NC_NOERR 0
379#define NC2_ERR (-1)
385#define NC_EBADID (-33)
386#define NC_ENFILE (-34)
387#define NC_EEXIST (-35)
388#define NC_EINVAL (-36)
389#define NC_EPERM (-37)
394#define NC_ENOTINDEFINE (-38)
395
403#define NC_EINDEFINE (-39)
404
410#define NC_EINVALCOORDS (-40)
411
415#define NC_EMAXDIMS (-41) /* not enforced after 4.5.0 */
416
417#define NC_ENAMEINUSE (-42)
418#define NC_ENOTATT (-43)
419#define NC_EMAXATTS (-44)
420#define NC_EBADTYPE (-45)
421#define NC_EBADDIM (-46)
422#define NC_EUNLIMPOS (-47)
427#define NC_EMAXVARS (-48) /* not enforced after 4.5.0 */
428
432#define NC_ENOTVAR (-49)
433#define NC_EGLOBAL (-50)
434#define NC_ENOTNC (-51)
435#define NC_ESTS (-52)
436#define NC_EMAXNAME (-53)
437#define NC_EUNLIMIT (-54)
438#define NC_ENORECVARS (-55)
439#define NC_ECHAR (-56)
448#define NC_EEDGE (-57)
449#define NC_ESTRIDE (-58)
450#define NC_EBADNAME (-59)
451/* N.B. following must match value in ncx.h */
452
457#define NC_ERANGE (-60)
458#define NC_ENOMEM (-61)
459#define NC_EVARSIZE (-62)
460#define NC_EDIMSIZE (-63)
461#define NC_ETRUNC (-64)
462#define NC_EAXISTYPE (-65)
464/* Following errors are added for DAP */
465#define NC_EDAP (-66)
466#define NC_ECURL (-67)
467#define NC_EIO (-68)
468#define NC_ENODATA (-69)
469#define NC_EDAPSVC (-70)
470#define NC_EDAS (-71)
471#define NC_EDDS (-72)
472#define NC_EDMR NC_EDDS
473#define NC_EDATADDS (-73)
474#define NC_EDATADAP NC_EDATADDS
475#define NC_EDAPURL (-74)
476#define NC_EDAPCONSTRAINT (-75)
477#define NC_ETRANSLATION (-76)
478#define NC_EACCESS (-77)
479#define NC_EAUTH (-78)
481/* Misc. additional errors */
482#define NC_ENOTFOUND (-90)
483#define NC_ECANTREMOVE (-91)
484#define NC_EINTERNAL (-92)
485#define NC_EPNETCDF (-93)
487/* The following was added in support of netcdf-4. Make all netcdf-4
488 error codes < -100 so that errors can be added to netcdf-3 if
489 needed. */
490#define NC4_FIRST_ERROR (-100)
491#define NC_EHDFERR (-101)
492#define NC_ECANTREAD (-102)
493#define NC_ECANTWRITE (-103)
494#define NC_ECANTCREATE (-104)
495#define NC_EFILEMETA (-105)
496#define NC_EDIMMETA (-106)
497#define NC_EATTMETA (-107)
498#define NC_EVARMETA (-108)
499#define NC_ENOCOMPOUND (-109)
500#define NC_EATTEXISTS (-110)
501#define NC_ENOTNC4 (-111)
502#define NC_ESTRICTNC3 (-112)
503#define NC_ENOTNC3 (-113)
504#define NC_ENOPAR (-114)
505#define NC_EPARINIT (-115)
506#define NC_EBADGRPID (-116)
507#define NC_EBADTYPID (-117)
508#define NC_ETYPDEFINED (-118)
509#define NC_EBADFIELD (-119)
510#define NC_EBADCLASS (-120)
511#define NC_EMAPTYPE (-121)
512#define NC_ELATEFILL (-122)
513#define NC_ELATEDEF (-123)
514#define NC_EDIMSCALE (-124)
515#define NC_ENOGRP (-125)
516#define NC_ESTORAGE (-126)
517#define NC_EBADCHUNK (-127)
518#define NC_ENOTBUILT (-128)
519#define NC_EDISKLESS (-129)
520#define NC_ECANTEXTEND (-130)
521#define NC_EMPI (-131)
523#define NC_EFILTER (-132)
524#define NC_ERCFILE (-133)
525#define NC_ENULLPAD (-134)
526#define NC_EINMEMORY (-135)
527#define NC_ENOFILTER (-136)
528#define NC_ENCZARR (-137)
529#define NC_ES3 (-138)
530#define NC_EEMPTY (-139)
531#define NC_EOBJECT (-140)
532#define NC_ENOOBJECT (-141)
533#define NC_EPLUGIN (-142)
535#define NC4_LAST_ERROR (-142)
537/* Errors for all remote access methods(e.g. DAP and CDMREMOTE)*/
538#define NC_EURL (NC_EDAPURL)
539#define NC_ECONSTRAINT (NC_EDAPCONSTRAINT)
543#define DIM_WITHOUT_VARIABLE "This is a netCDF dimension but not a netCDF variable."
544
548#define NC_HAVE_NEW_CHUNKING_API 1
549
550/*
551 * The Interface
552 */
553
554/* Declaration modifiers for DLL support (MSC et al) */
555#if defined(DLL_NETCDF) /* define when library is a DLL */
556# if defined(DLL_EXPORT) /* define when building the library */
557# define MSC_EXTRA __declspec(dllexport)
558# else
559# define MSC_EXTRA __declspec(dllimport)
560# endif
561# include <io.h>
562#else
563#define MSC_EXTRA
564#endif /* defined(DLL_NETCDF) */
565
566#define EXTERNL MSC_EXTRA extern
568#if defined(DLL_NETCDF) /* define when library is a DLL */
569EXTERNL int ncerr;
570EXTERNL int ncopts;
571#endif
572
573EXTERNL const char *
574nc_inq_libvers(void);
575
576EXTERNL const char *
577nc_strerror(int ncerr);
578
579/* Set up user-defined format. */
580typedef struct NC_Dispatch NC_Dispatch;
581EXTERNL int
582nc_def_user_format(int mode_flag, NC_Dispatch *dispatch_table, char *magic_number);
583
584EXTERNL int
585nc_inq_user_format(int mode_flag, NC_Dispatch **dispatch_table, char *magic_number);
586
587/* Set the global alignment property */
588EXTERNL int
589nc_set_alignment(int threshold, int alignment);
590
591/* Get the global alignment property */
592EXTERNL int
593nc_get_alignment(int* thresholdp, int* alignmentp);
594
595EXTERNL int
596nc__create(const char *path, int cmode, size_t initialsz,
597 size_t *chunksizehintp, int *ncidp);
598
599EXTERNL int
600nc_create(const char *path, int cmode, int *ncidp);
601
602EXTERNL int
603nc__open(const char *path, int mode,
604 size_t *chunksizehintp, int *ncidp);
605
606EXTERNL int
607nc_open(const char *path, int mode, int *ncidp);
608
609/* Learn the path used to open/create the file. */
610EXTERNL int
611nc_inq_path(int ncid, size_t *pathlen, char *path);
612
613/* Given an ncid and group name (NULL gets root group), return
614 * locid. */
615EXTERNL int
616nc_inq_ncid(int ncid, const char *name, int *grp_ncid);
617
618/* Given a location id, return the number of groups it contains, and
619 * an array of their locids. */
620EXTERNL int
621nc_inq_grps(int ncid, int *numgrps, int *ncids);
622
623/* Given locid, find name of group. (Root group is named "/".) */
624EXTERNL int
625nc_inq_grpname(int ncid, char *name);
626
627/* Given ncid, find full name and len of full name. (Root group is
628 * named "/", with length 1.) */
629EXTERNL int
630nc_inq_grpname_full(int ncid, size_t *lenp, char *full_name);
631
632/* Given ncid, find len of full name. */
633EXTERNL int
634nc_inq_grpname_len(int ncid, size_t *lenp);
635
636/* Given an ncid, find the ncid of its parent group. */
637EXTERNL int
638nc_inq_grp_parent(int ncid, int *parent_ncid);
639
640/* Given a name and parent ncid, find group ncid. */
641EXTERNL int
642nc_inq_grp_ncid(int ncid, const char *grp_name, int *grp_ncid);
643
644/* Given a full name and ncid, find group ncid. */
645EXTERNL int
646nc_inq_grp_full_ncid(int ncid, const char *full_name, int *grp_ncid);
647
648/* Get a list of ids for all the variables in a group. */
649EXTERNL int
650nc_inq_varids(int ncid, int *nvars, int *varids);
651
652/* Find all dimids for a location. This finds all dimensions in a
653 * group, or any of its parents. */
654EXTERNL int
655nc_inq_dimids(int ncid, int *ndims, int *dimids, int include_parents);
656
657/* Find all user-defined types for a location. This finds all
658 * user-defined types in a group. */
659EXTERNL int
660nc_inq_typeids(int ncid, int *ntypes, int *typeids);
661
662/* Are two types equal? */
663EXTERNL int
664nc_inq_type_equal(int ncid1, nc_type typeid1, int ncid2,
665 nc_type typeid2, int *equal);
666
667/* Create a group. its ncid is returned in the new_ncid pointer. */
668EXTERNL int
669nc_def_grp(int parent_ncid, const char *name, int *new_ncid);
670
671/* Rename a group */
672EXTERNL int
673nc_rename_grp(int grpid, const char *name);
674
675/* Here are functions for dealing with compound types. */
676
677/* Create a compound type. */
678EXTERNL int
679nc_def_compound(int ncid, size_t size, const char *name, nc_type *typeidp);
680
681/* Insert a named field into a compound type. */
682EXTERNL int
683nc_insert_compound(int ncid, nc_type xtype, const char *name,
684 size_t offset, nc_type field_typeid);
685
686/* Insert a named array into a compound type. */
687EXTERNL int
688nc_insert_array_compound(int ncid, nc_type xtype, const char *name,
689 size_t offset, nc_type field_typeid,
690 int ndims, const int *dim_sizes);
691
692/* Get the name and size of a type. */
693EXTERNL int
694nc_inq_type(int ncid, nc_type xtype, char *name, size_t *size);
695
696/* Get the id of a type from the name, which might be a fully qualified name */
697EXTERNL int
698nc_inq_typeid(int ncid, const char *name, nc_type *typeidp);
699
700/* Get the name, size, and number of fields in a compound type. */
701EXTERNL int
702nc_inq_compound(int ncid, nc_type xtype, char *name, size_t *sizep,
703 size_t *nfieldsp);
704
705/* Get the name of a compound type. */
706EXTERNL int
707nc_inq_compound_name(int ncid, nc_type xtype, char *name);
708
709/* Get the size of a compound type. */
710EXTERNL int
711nc_inq_compound_size(int ncid, nc_type xtype, size_t *sizep);
712
713/* Get the number of fields in this compound type. */
714EXTERNL int
715nc_inq_compound_nfields(int ncid, nc_type xtype, size_t *nfieldsp);
716
717/* Given the xtype and the fieldid, get all info about it. */
718EXTERNL int
719nc_inq_compound_field(int ncid, nc_type xtype, int fieldid, char *name,
720 size_t *offsetp, nc_type *field_typeidp, int *ndimsp,
721 int *dim_sizesp);
722
723/* Given the typeid and the fieldid, get the name. */
724EXTERNL int
725nc_inq_compound_fieldname(int ncid, nc_type xtype, int fieldid,
726 char *name);
727
728/* Given the xtype and the name, get the fieldid. */
729EXTERNL int
730nc_inq_compound_fieldindex(int ncid, nc_type xtype, const char *name,
731 int *fieldidp);
732
733/* Given the xtype and fieldid, get the offset. */
734EXTERNL int
735nc_inq_compound_fieldoffset(int ncid, nc_type xtype, int fieldid,
736 size_t *offsetp);
737
738/* Given the xtype and the fieldid, get the type of that field. */
739EXTERNL int
740nc_inq_compound_fieldtype(int ncid, nc_type xtype, int fieldid,
741 nc_type *field_typeidp);
742
743/* Given the xtype and the fieldid, get the number of dimensions for
744 * that field (scalars are 0). */
745EXTERNL int
746nc_inq_compound_fieldndims(int ncid, nc_type xtype, int fieldid,
747 int *ndimsp);
748
749/* Given the xtype and the fieldid, get the sizes of dimensions for
750 * that field. User must have allocated storage for the dim_sizes. */
751EXTERNL int
752nc_inq_compound_fielddim_sizes(int ncid, nc_type xtype, int fieldid,
753 int *dim_sizes);
754
756typedef struct {
757 size_t len;
758 void *p;
759} nc_vlen_t;
760
765#define NC_COMPOUND_OFFSET(S,M) (offsetof(S,M))
766
767/* Create a variable length type. */
768EXTERNL int
769nc_def_vlen(int ncid, const char *name, nc_type base_typeid, nc_type *xtypep);
770
771/* Find out about a vlen. */
772EXTERNL int
773nc_inq_vlen(int ncid, nc_type xtype, char *name, size_t *datum_sizep,
774 nc_type *base_nc_typep);
775
776/* Put or get one element in a vlen array. */
777EXTERNL int
778nc_put_vlen_element(int ncid, int typeid1, void *vlen_element,
779 size_t len, const void *data);
780
781EXTERNL int
782nc_get_vlen_element(int ncid, int typeid1, const void *vlen_element,
783 size_t *len, void *data);
784
785/* Find out about a user defined type. */
786EXTERNL int
787nc_inq_user_type(int ncid, nc_type xtype, char *name, size_t *size,
788 nc_type *base_nc_typep, size_t *nfieldsp, int *classp);
789
790/* Write an attribute of any type. */
791EXTERNL int
792nc_put_att(int ncid, int varid, const char *name, nc_type xtype,
793 size_t len, const void *op);
794
795/* Read an attribute of any type. */
796EXTERNL int
797nc_get_att(int ncid, int varid, const char *name, void *ip);
798
799/* Enum type. */
800
801/* Create an enum type. Provide a base type and a name. At the moment
802 * only ints are accepted as base types. */
803EXTERNL int
804nc_def_enum(int ncid, nc_type base_typeid, const char *name,
805 nc_type *typeidp);
806
807/* Insert a named value into an enum type. The value must fit within
808 * the size of the enum type, the name size must be <= NC_MAX_NAME. */
809EXTERNL int
810nc_insert_enum(int ncid, nc_type xtype, const char *name,
811 const void *value);
812
813/* Get information about an enum type: its name, base type and the
814 * number of members defined. */
815EXTERNL int
816nc_inq_enum(int ncid, nc_type xtype, char *name, nc_type *base_nc_typep,
817 size_t *base_sizep, size_t *num_membersp);
818
819/* Get information about an enum member: a name and value. Name size
820 * will be <= NC_MAX_NAME. */
821EXTERNL int
822nc_inq_enum_member(int ncid, nc_type xtype, int idx, char *name,
823 void *value);
824
825
826/* Get enum name from enum value. Name size will be <= NC_MAX_NAME. */
827/* If value is zero and there is no matching ident, then return _UNDEFINED */
828#define NC_UNDEFINED_ENUM_IDENT "_UNDEFINED"
829
830EXTERNL int
831nc_inq_enum_ident(int ncid, nc_type xtype, long long value, char *identifier);
832
833/* Opaque type. */
834
835/* Create an opaque type. Provide a size and a name. */
836EXTERNL int
837nc_def_opaque(int ncid, size_t size, const char *name, nc_type *xtypep);
838
839/* Get information about an opaque type. */
840EXTERNL int
841nc_inq_opaque(int ncid, nc_type xtype, char *name, size_t *sizep);
842
843/* Write entire var of any type. */
844EXTERNL int
845nc_put_var(int ncid, int varid, const void *op);
846
847/* Read entire var of any type. */
848EXTERNL int
849nc_get_var(int ncid, int varid, void *ip);
850
851/* Write one value. */
852EXTERNL int
853nc_put_var1(int ncid, int varid, const size_t *indexp,
854 const void *op);
855
856/* Read one value. */
857EXTERNL int
858nc_get_var1(int ncid, int varid, const size_t *indexp, void *ip);
859
860/* Write an array of values. */
861EXTERNL int
862nc_put_vara(int ncid, int varid, const size_t *startp,
863 const size_t *countp, const void *op);
864
865/* Read an array of values. */
866EXTERNL int
867nc_get_vara(int ncid, int varid, const size_t *startp,
868 const size_t *countp, void *ip);
869
870/* Write slices of an array of values. */
871EXTERNL int
872nc_put_vars(int ncid, int varid, const size_t *startp,
873 const size_t *countp, const ptrdiff_t *stridep,
874 const void *op);
875
876/* Read slices of an array of values. */
877EXTERNL int
878nc_get_vars(int ncid, int varid, const size_t *startp,
879 const size_t *countp, const ptrdiff_t *stridep,
880 void *ip);
881
882/* Write mapped slices of an array of values. */
883EXTERNL int
884nc_put_varm(int ncid, int varid, const size_t *startp,
885 const size_t *countp, const ptrdiff_t *stridep,
886 const ptrdiff_t *imapp, const void *op);
887
888/* Read mapped slices of an array of values. */
889EXTERNL int
890nc_get_varm(int ncid, int varid, const size_t *startp,
891 const size_t *countp, const ptrdiff_t *stridep,
892 const ptrdiff_t *imapp, void *ip);
893
894/* Extra netcdf-4 stuff. */
895
896/* Set quantization settings for a variable. Quantizing data improves
897 * later compression. Must be called after nc_def_var and before
898 * nc_enddef. */
899EXTERNL int
900nc_def_var_quantize(int ncid, int varid, int quantize_mode, int nsd);
901
902/* Find out quantization settings of a var. */
903EXTERNL int
904nc_inq_var_quantize(int ncid, int varid, int *quantize_modep, int *nsdp);
905
906/* Set compression settings for a variable. Lower is faster, higher is
907 * better. Must be called after nc_def_var and before nc_enddef. */
908EXTERNL int
909nc_def_var_deflate(int ncid, int varid, int shuffle, int deflate,
910 int deflate_level);
911
912/* Find out compression settings of a var. */
913EXTERNL int
914nc_inq_var_deflate(int ncid, int varid, int *shufflep,
915 int *deflatep, int *deflate_levelp);
916
917/* Set szip compression for a variable. */
918EXTERNL int nc_def_var_szip(int ncid, int varid, int options_mask,
919 int pixels_per_block);
920
921/* Find out szip settings of a var. */
922EXTERNL int
923nc_inq_var_szip(int ncid, int varid, int *options_maskp, int *pixels_per_blockp);
924
925/* Set fletcher32 checksum for a var. This must be done after nc_def_var
926 and before nc_enddef. */
927EXTERNL int
928nc_def_var_fletcher32(int ncid, int varid, int fletcher32);
929
930/* Inquire about fletcher32 checksum for a var. */
931EXTERNL int
932nc_inq_var_fletcher32(int ncid, int varid, int *fletcher32p);
933
934/* Define chunking for a variable. This must be done after nc_def_var
935 and before nc_enddef. */
936EXTERNL int
937nc_def_var_chunking(int ncid, int varid, int storage, const size_t *chunksizesp);
938
939/* Inq chunking stuff for a var. */
940EXTERNL int
941nc_inq_var_chunking(int ncid, int varid, int *storagep, size_t *chunksizesp);
942
943/* Define fill value behavior for a variable. This must be done after
944 nc_def_var and before nc_enddef. */
945EXTERNL int
946nc_def_var_fill(int ncid, int varid, int no_fill, const void *fill_value);
947
948/* Inq fill value setting for a var. */
949EXTERNL int
950nc_inq_var_fill(int ncid, int varid, int *no_fill, void *fill_valuep);
951
952/* Define the endianness of a variable. */
953EXTERNL int
954nc_def_var_endian(int ncid, int varid, int endian);
955
956/* Learn about the endianness of a variable. */
957EXTERNL int
958nc_inq_var_endian(int ncid, int varid, int *endianp);
959
960/* Define a filter for a variable */
961EXTERNL int
962nc_def_var_filter(int ncid, int varid, unsigned int id, size_t nparams, const unsigned int* parms);
963
964/* Learn about the first filter on a variable */
965EXTERNL int
966nc_inq_var_filter(int ncid, int varid, unsigned int* idp, size_t* nparams, unsigned int* params);
967
968/* Set the fill mode (classic or 64-bit offset files only). */
969EXTERNL int
970nc_set_fill(int ncid, int fillmode, int *old_modep);
971
972/* Set the default nc_create format to NC_FORMAT_CLASSIC, NC_FORMAT_64BIT,
973 * NC_FORMAT_CDF5, NC_FORMAT_NETCDF4, or NC_FORMAT_NETCDF4_CLASSIC */
974EXTERNL int
975nc_set_default_format(int format, int *old_formatp);
976
977/* Set the cache size, nelems, and preemption policy. */
978EXTERNL int
979nc_set_chunk_cache(size_t size, size_t nelems, float preemption);
980
981/* Get the cache size, nelems, and preemption policy. */
982EXTERNL int
983nc_get_chunk_cache(size_t *sizep, size_t *nelemsp, float *preemptionp);
984
985/* Set the per-variable cache size, nelems, and preemption policy. */
986EXTERNL int
987nc_set_var_chunk_cache(int ncid, int varid, size_t size, size_t nelems,
988 float preemption);
989
990/* Get the per-variable cache size, nelems, and preemption policy. */
991EXTERNL int
992nc_get_var_chunk_cache(int ncid, int varid, size_t *sizep, size_t *nelemsp,
993 float *preemptionp);
994
995EXTERNL int
996nc_redef(int ncid);
997
998/* Is this ever used? Convert to parameter form */
999EXTERNL int
1000nc__enddef(int ncid, size_t h_minfree, size_t v_align,
1001 size_t v_minfree, size_t r_align);
1002
1003EXTERNL int
1004nc_enddef(int ncid);
1005
1006EXTERNL int
1007nc_sync(int ncid);
1008
1009EXTERNL int
1010nc_abort(int ncid);
1011
1012EXTERNL int
1013nc_close(int ncid);
1014
1015EXTERNL int
1016nc_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp);
1017
1018EXTERNL int
1019nc_inq_ndims(int ncid, int *ndimsp);
1020
1021EXTERNL int
1022nc_inq_nvars(int ncid, int *nvarsp);
1023
1024EXTERNL int
1025nc_inq_natts(int ncid, int *nattsp);
1026
1027EXTERNL int
1028nc_inq_unlimdim(int ncid, int *unlimdimidp);
1029
1030/* The next function is for NetCDF-4 only */
1031EXTERNL int
1032nc_inq_unlimdims(int ncid, int *nunlimdimsp, int *unlimdimidsp);
1033
1034/* Added in 3.6.1 to return format of netCDF file. */
1035EXTERNL int
1036nc_inq_format(int ncid, int *formatp);
1037
1038/* Added in 4.3.1 to return additional format info */
1039EXTERNL int
1040nc_inq_format_extended(int ncid, int *formatp, int* modep);
1041
1042/* Begin _dim */
1043
1044EXTERNL int
1045nc_def_dim(int ncid, const char *name, size_t len, int *idp);
1046
1047EXTERNL int
1048nc_inq_dimid(int ncid, const char *name, int *idp);
1049
1050EXTERNL int
1051nc_inq_dim(int ncid, int dimid, char *name, size_t *lenp);
1052
1053EXTERNL int
1054nc_inq_dimname(int ncid, int dimid, char *name);
1055
1056EXTERNL int
1057nc_inq_dimlen(int ncid, int dimid, size_t *lenp);
1058
1059EXTERNL int
1060nc_rename_dim(int ncid, int dimid, const char *name);
1061
1062/* End _dim */
1063/* Begin _att */
1064
1065EXTERNL int
1066nc_inq_att(int ncid, int varid, const char *name,
1067 nc_type *xtypep, size_t *lenp);
1068
1069EXTERNL int
1070nc_inq_attid(int ncid, int varid, const char *name, int *idp);
1071
1072EXTERNL int
1073nc_inq_atttype(int ncid, int varid, const char *name, nc_type *xtypep);
1074
1075EXTERNL int
1076nc_inq_attlen(int ncid, int varid, const char *name, size_t *lenp);
1077
1078EXTERNL int
1079nc_inq_attname(int ncid, int varid, int attnum, char *name);
1080
1081EXTERNL int
1082nc_copy_att(int ncid_in, int varid_in, const char *name, int ncid_out, int varid_out);
1083
1084EXTERNL int
1085nc_rename_att(int ncid, int varid, const char *name, const char *newname);
1086
1087EXTERNL int
1088nc_del_att(int ncid, int varid, const char *name);
1089
1090/* End _att */
1091/* Begin {put,get}_att */
1092EXTERNL int
1093nc_put_att_text(int ncid, int varid, const char *name,
1094 size_t len, const char *op);
1095
1096EXTERNL int
1097nc_get_att_text(int ncid, int varid, const char *name, char *ip);
1098
1099EXTERNL int
1100nc_put_att_string(int ncid, int varid, const char *name,
1101 size_t len, const char **op);
1102
1103EXTERNL int
1104nc_get_att_string(int ncid, int varid, const char *name, char **ip);
1105
1106EXTERNL int
1107nc_put_att_uchar(int ncid, int varid, const char *name, nc_type xtype,
1108 size_t len, const unsigned char *op);
1109
1110EXTERNL int
1111nc_get_att_uchar(int ncid, int varid, const char *name, unsigned char *ip);
1112
1113EXTERNL int
1114nc_put_att_schar(int ncid, int varid, const char *name, nc_type xtype,
1115 size_t len, const signed char *op);
1116
1117EXTERNL int
1118nc_get_att_schar(int ncid, int varid, const char *name, signed char *ip);
1119
1120EXTERNL int
1121nc_put_att_short(int ncid, int varid, const char *name, nc_type xtype,
1122 size_t len, const short *op);
1123
1124EXTERNL int
1125nc_get_att_short(int ncid, int varid, const char *name, short *ip);
1126
1127EXTERNL int
1128nc_put_att_int(int ncid, int varid, const char *name, nc_type xtype,
1129 size_t len, const int *op);
1130
1131EXTERNL int
1132nc_get_att_int(int ncid, int varid, const char *name, int *ip);
1133
1134EXTERNL int
1135nc_put_att_long(int ncid, int varid, const char *name, nc_type xtype,
1136 size_t len, const long *op);
1137
1138EXTERNL int
1139nc_get_att_long(int ncid, int varid, const char *name, long *ip);
1140
1141EXTERNL int
1142nc_put_att_float(int ncid, int varid, const char *name, nc_type xtype,
1143 size_t len, const float *op);
1144
1145EXTERNL int
1146nc_get_att_float(int ncid, int varid, const char *name, float *ip);
1147
1148EXTERNL int
1149nc_put_att_double(int ncid, int varid, const char *name, nc_type xtype,
1150 size_t len, const double *op);
1151
1152EXTERNL int
1153nc_get_att_double(int ncid, int varid, const char *name, double *ip);
1154
1155EXTERNL int
1156nc_put_att_ushort(int ncid, int varid, const char *name, nc_type xtype,
1157 size_t len, const unsigned short *op);
1158
1159EXTERNL int
1160nc_get_att_ushort(int ncid, int varid, const char *name, unsigned short *ip);
1161
1162EXTERNL int
1163nc_put_att_uint(int ncid, int varid, const char *name, nc_type xtype,
1164 size_t len, const unsigned int *op);
1165
1166EXTERNL int
1167nc_get_att_uint(int ncid, int varid, const char *name, unsigned int *ip);
1168
1169EXTERNL int
1170nc_put_att_longlong(int ncid, int varid, const char *name, nc_type xtype,
1171 size_t len, const long long *op);
1172
1173EXTERNL int
1174nc_get_att_longlong(int ncid, int varid, const char *name, long long *ip);
1175
1176EXTERNL int
1177nc_put_att_ulonglong(int ncid, int varid, const char *name, nc_type xtype,
1178 size_t len, const unsigned long long *op);
1179
1180EXTERNL int
1181nc_get_att_ulonglong(int ncid, int varid, const char *name,
1182 unsigned long long *ip);
1183
1184
1185/* End {put,get}_att */
1186/* Begin _var */
1187
1188EXTERNL int
1189nc_def_var(int ncid, const char *name, nc_type xtype, int ndims,
1190 const int *dimidsp, int *varidp);
1191
1192EXTERNL int
1193nc_inq_var(int ncid, int varid, char *name, nc_type *xtypep,
1194 int *ndimsp, int *dimidsp, int *nattsp);
1195
1196EXTERNL int
1197nc_inq_varid(int ncid, const char *name, int *varidp);
1198
1199EXTERNL int
1200nc_inq_varname(int ncid, int varid, char *name);
1201
1202EXTERNL int
1203nc_inq_vartype(int ncid, int varid, nc_type *xtypep);
1204
1205EXTERNL int
1206nc_inq_varndims(int ncid, int varid, int *ndimsp);
1207
1208EXTERNL int
1209nc_inq_vardimid(int ncid, int varid, int *dimidsp);
1210
1211EXTERNL int
1212nc_inq_varnatts(int ncid, int varid, int *nattsp);
1213
1214EXTERNL int
1215nc_rename_var(int ncid, int varid, const char *name);
1216
1217EXTERNL int
1218nc_copy_var(int ncid_in, int varid, int ncid_out);
1219
1220#ifndef ncvarcpy
1221/* support the old name for now */
1222#define ncvarcpy(ncid_in, varid, ncid_out) ncvarcopy((ncid_in), (varid), (ncid_out))
1223#endif
1224
1225/* End _var */
1226/* Begin {put,get}_var1 */
1227
1228EXTERNL int
1229nc_put_var1_text(int ncid, int varid, const size_t *indexp, const char *op);
1230
1231EXTERNL int
1232nc_get_var1_text(int ncid, int varid, const size_t *indexp, char *ip);
1233
1234EXTERNL int
1235nc_put_var1_uchar(int ncid, int varid, const size_t *indexp,
1236 const unsigned char *op);
1237
1238EXTERNL int
1239nc_get_var1_uchar(int ncid, int varid, const size_t *indexp,
1240 unsigned char *ip);
1241
1242EXTERNL int
1243nc_put_var1_schar(int ncid, int varid, const size_t *indexp,
1244 const signed char *op);
1245
1246EXTERNL int
1247nc_get_var1_schar(int ncid, int varid, const size_t *indexp,
1248 signed char *ip);
1249
1250EXTERNL int
1251nc_put_var1_short(int ncid, int varid, const size_t *indexp,
1252 const short *op);
1253
1254EXTERNL int
1255nc_get_var1_short(int ncid, int varid, const size_t *indexp,
1256 short *ip);
1257
1258EXTERNL int
1259nc_put_var1_int(int ncid, int varid, const size_t *indexp, const int *op);
1260
1261EXTERNL int
1262nc_get_var1_int(int ncid, int varid, const size_t *indexp, int *ip);
1263
1264EXTERNL int
1265nc_put_var1_long(int ncid, int varid, const size_t *indexp, const long *op);
1266
1267EXTERNL int
1268nc_get_var1_long(int ncid, int varid, const size_t *indexp, long *ip);
1269
1270EXTERNL int
1271nc_put_var1_float(int ncid, int varid, const size_t *indexp, const float *op);
1272
1273EXTERNL int
1274nc_get_var1_float(int ncid, int varid, const size_t *indexp, float *ip);
1275
1276EXTERNL int
1277nc_put_var1_double(int ncid, int varid, const size_t *indexp, const double *op);
1278
1279EXTERNL int
1280nc_get_var1_double(int ncid, int varid, const size_t *indexp, double *ip);
1281
1282EXTERNL int
1283nc_put_var1_ushort(int ncid, int varid, const size_t *indexp,
1284 const unsigned short *op);
1285
1286EXTERNL int
1287nc_get_var1_ushort(int ncid, int varid, const size_t *indexp,
1288 unsigned short *ip);
1289
1290EXTERNL int
1291nc_put_var1_uint(int ncid, int varid, const size_t *indexp,
1292 const unsigned int *op);
1293
1294EXTERNL int
1295nc_get_var1_uint(int ncid, int varid, const size_t *indexp,
1296 unsigned int *ip);
1297
1298EXTERNL int
1299nc_put_var1_longlong(int ncid, int varid, const size_t *indexp,
1300 const long long *op);
1301
1302EXTERNL int
1303nc_get_var1_longlong(int ncid, int varid, const size_t *indexp,
1304 long long *ip);
1305
1306EXTERNL int
1307nc_put_var1_ulonglong(int ncid, int varid, const size_t *indexp,
1308 const unsigned long long *op);
1309
1310EXTERNL int
1311nc_get_var1_ulonglong(int ncid, int varid, const size_t *indexp,
1312 unsigned long long *ip);
1313
1314EXTERNL int
1315nc_put_var1_string(int ncid, int varid, const size_t *indexp,
1316 const char **op);
1317
1318EXTERNL int
1319nc_get_var1_string(int ncid, int varid, const size_t *indexp,
1320 char **ip);
1321
1322/* End {put,get}_var1 */
1323/* Begin {put,get}_vara */
1324
1325EXTERNL int
1326nc_put_vara_text(int ncid, int varid, const size_t *startp,
1327 const size_t *countp, const char *op);
1328
1329EXTERNL int
1330nc_get_vara_text(int ncid, int varid, const size_t *startp,
1331 const size_t *countp, char *ip);
1332
1333EXTERNL int
1334nc_put_vara_uchar(int ncid, int varid, const size_t *startp,
1335 const size_t *countp, const unsigned char *op);
1336
1337EXTERNL int
1338nc_get_vara_uchar(int ncid, int varid, const size_t *startp,
1339 const size_t *countp, unsigned char *ip);
1340
1341EXTERNL int
1342nc_put_vara_schar(int ncid, int varid, const size_t *startp,
1343 const size_t *countp, const signed char *op);
1344
1345EXTERNL int
1346nc_get_vara_schar(int ncid, int varid, const size_t *startp,
1347 const size_t *countp, signed char *ip);
1348
1349EXTERNL int
1350nc_put_vara_short(int ncid, int varid, const size_t *startp,
1351 const size_t *countp, const short *op);
1352
1353EXTERNL int
1354nc_get_vara_short(int ncid, int varid, const size_t *startp,
1355 const size_t *countp, short *ip);
1356
1357EXTERNL int
1358nc_put_vara_int(int ncid, int varid, const size_t *startp,
1359 const size_t *countp, const int *op);
1360
1361EXTERNL int
1362nc_get_vara_int(int ncid, int varid, const size_t *startp,
1363 const size_t *countp, int *ip);
1364
1365EXTERNL int
1366nc_put_vara_long(int ncid, int varid, const size_t *startp,
1367 const size_t *countp, const long *op);
1368
1369EXTERNL int
1370nc_get_vara_long(int ncid, int varid,
1371 const size_t *startp, const size_t *countp, long *ip);
1372
1373EXTERNL int
1374nc_put_vara_float(int ncid, int varid,
1375 const size_t *startp, const size_t *countp, const float *op);
1376
1377EXTERNL int
1378nc_get_vara_float(int ncid, int varid,
1379 const size_t *startp, const size_t *countp, float *ip);
1380
1381EXTERNL int
1382nc_put_vara_double(int ncid, int varid, const size_t *startp,
1383 const size_t *countp, const double *op);
1384
1385EXTERNL int
1386nc_get_vara_double(int ncid, int varid, const size_t *startp,
1387 const size_t *countp, double *ip);
1388
1389EXTERNL int
1390nc_put_vara_ushort(int ncid, int varid, const size_t *startp,
1391 const size_t *countp, const unsigned short *op);
1392
1393EXTERNL int
1394nc_get_vara_ushort(int ncid, int varid, const size_t *startp,
1395 const size_t *countp, unsigned short *ip);
1396
1397EXTERNL int
1398nc_put_vara_uint(int ncid, int varid, const size_t *startp,
1399 const size_t *countp, const unsigned int *op);
1400
1401EXTERNL int
1402nc_get_vara_uint(int ncid, int varid, const size_t *startp,
1403 const size_t *countp, unsigned int *ip);
1404
1405EXTERNL int
1406nc_put_vara_longlong(int ncid, int varid, const size_t *startp,
1407 const size_t *countp, const long long *op);
1408
1409EXTERNL int
1410nc_get_vara_longlong(int ncid, int varid, const size_t *startp,
1411 const size_t *countp, long long *ip);
1412
1413EXTERNL int
1414nc_put_vara_ulonglong(int ncid, int varid, const size_t *startp,
1415 const size_t *countp, const unsigned long long *op);
1416
1417EXTERNL int
1418nc_get_vara_ulonglong(int ncid, int varid, const size_t *startp,
1419 const size_t *countp, unsigned long long *ip);
1420
1421EXTERNL int
1422nc_put_vara_string(int ncid, int varid, const size_t *startp,
1423 const size_t *countp, const char **op);
1424
1425EXTERNL int
1426nc_get_vara_string(int ncid, int varid, const size_t *startp,
1427 const size_t *countp, char **ip);
1428
1429/* End {put,get}_vara */
1430/* Begin {put,get}_vars */
1431
1432EXTERNL int
1433nc_put_vars_text(int ncid, int varid,
1434 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1435 const char *op);
1436
1437EXTERNL int
1438nc_get_vars_text(int ncid, int varid,
1439 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1440 char *ip);
1441
1442EXTERNL int
1443nc_put_vars_uchar(int ncid, int varid,
1444 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1445 const unsigned char *op);
1446
1447EXTERNL int
1448nc_get_vars_uchar(int ncid, int varid,
1449 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1450 unsigned char *ip);
1451
1452EXTERNL int
1453nc_put_vars_schar(int ncid, int varid,
1454 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1455 const signed char *op);
1456
1457EXTERNL int
1458nc_get_vars_schar(int ncid, int varid,
1459 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1460 signed char *ip);
1461
1462EXTERNL int
1463nc_put_vars_short(int ncid, int varid,
1464 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1465 const short *op);
1466
1467EXTERNL int
1468nc_get_vars_short(int ncid, int varid, const size_t *startp,
1469 const size_t *countp, const ptrdiff_t *stridep,
1470 short *ip);
1471
1472EXTERNL int
1473nc_put_vars_int(int ncid, int varid,
1474 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1475 const int *op);
1476
1477EXTERNL int
1478nc_get_vars_int(int ncid, int varid,
1479 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1480 int *ip);
1481
1482EXTERNL int
1483nc_put_vars_long(int ncid, int varid,
1484 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1485 const long *op);
1486
1487EXTERNL int
1488nc_get_vars_long(int ncid, int varid,
1489 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1490 long *ip);
1491
1492EXTERNL int
1493nc_put_vars_float(int ncid, int varid,
1494 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1495 const float *op);
1496
1497EXTERNL int
1498nc_get_vars_float(int ncid, int varid,
1499 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1500 float *ip);
1501
1502EXTERNL int
1503nc_put_vars_double(int ncid, int varid,
1504 const size_t *startp, const size_t *countp, const ptrdiff_t *stridep,
1505 const double *op);
1506
1507EXTERNL int
1508nc_get_vars_double(int ncid, int varid, const size_t *startp,
1509 const size_t *countp, const ptrdiff_t *stridep,
1510 double *ip);
1511
1512EXTERNL int
1513nc_put_vars_ushort(int ncid, int varid, const size_t *startp,
1514 const size_t *countp, const ptrdiff_t *stridep,
1515 const unsigned short *op);
1516
1517EXTERNL int
1518nc_get_vars_ushort(int ncid, int varid, const size_t *startp,
1519 const size_t *countp, const ptrdiff_t *stridep,
1520 unsigned short *ip);
1521
1522EXTERNL int
1523nc_put_vars_uint(int ncid, int varid, const size_t *startp,
1524 const size_t *countp, const ptrdiff_t *stridep,
1525 const unsigned int *op);
1526
1527EXTERNL int
1528nc_get_vars_uint(int ncid, int varid, const size_t *startp,
1529 const size_t *countp, const ptrdiff_t *stridep,
1530 unsigned int *ip);
1531
1532EXTERNL int
1533nc_put_vars_longlong(int ncid, int varid, const size_t *startp,
1534 const size_t *countp, const ptrdiff_t *stridep,
1535 const long long *op);
1536
1537EXTERNL int
1538nc_get_vars_longlong(int ncid, int varid, const size_t *startp,
1539 const size_t *countp, const ptrdiff_t *stridep,
1540 long long *ip);
1541
1542EXTERNL int
1543nc_put_vars_ulonglong(int ncid, int varid, const size_t *startp,
1544 const size_t *countp, const ptrdiff_t *stridep,
1545 const unsigned long long *op);
1546
1547EXTERNL int
1548nc_get_vars_ulonglong(int ncid, int varid, const size_t *startp,
1549 const size_t *countp, const ptrdiff_t *stridep,
1550 unsigned long long *ip);
1551
1552EXTERNL int
1553nc_put_vars_string(int ncid, int varid, const size_t *startp,
1554 const size_t *countp, const ptrdiff_t *stridep,
1555 const char **op);
1556
1557EXTERNL int
1558nc_get_vars_string(int ncid, int varid, const size_t *startp,
1559 const size_t *countp, const ptrdiff_t *stridep,
1560 char **ip);
1561
1562/* End {put,get}_vars */
1563/* Begin {put,get}_varm */
1564
1565EXTERNL int
1566nc_put_varm_text(int ncid, int varid, const size_t *startp,
1567 const size_t *countp, const ptrdiff_t *stridep,
1568 const ptrdiff_t *imapp, const char *op);
1569
1570EXTERNL int
1571nc_get_varm_text(int ncid, int varid, const size_t *startp,
1572 const size_t *countp, const ptrdiff_t *stridep,
1573 const ptrdiff_t *imapp, char *ip);
1574
1575EXTERNL int
1576nc_put_varm_uchar(int ncid, int varid, const size_t *startp,
1577 const size_t *countp, const ptrdiff_t *stridep,
1578 const ptrdiff_t *imapp, const unsigned char *op);
1579
1580EXTERNL int
1581nc_get_varm_uchar(int ncid, int varid, const size_t *startp,
1582 const size_t *countp, const ptrdiff_t *stridep,
1583 const ptrdiff_t *imapp, unsigned char *ip);
1584
1585EXTERNL int
1586nc_put_varm_schar(int ncid, int varid, const size_t *startp,
1587 const size_t *countp, const ptrdiff_t *stridep,
1588 const ptrdiff_t *imapp, const signed char *op);
1589
1590EXTERNL int
1591nc_get_varm_schar(int ncid, int varid, const size_t *startp,
1592 const size_t *countp, const ptrdiff_t *stridep,
1593 const ptrdiff_t *imapp, signed char *ip);
1594
1595EXTERNL int
1596nc_put_varm_short(int ncid, int varid, const size_t *startp,
1597 const size_t *countp, const ptrdiff_t *stridep,
1598 const ptrdiff_t *imapp, const short *op);
1599
1600EXTERNL int
1601nc_get_varm_short(int ncid, int varid, const size_t *startp,
1602 const size_t *countp, const ptrdiff_t *stridep,
1603 const ptrdiff_t *imapp, short *ip);
1604
1605EXTERNL int
1606nc_put_varm_int(int ncid, int varid, const size_t *startp,
1607 const size_t *countp, const ptrdiff_t *stridep,
1608 const ptrdiff_t *imapp, const int *op);
1609
1610EXTERNL int
1611nc_get_varm_int(int ncid, int varid, const size_t *startp,
1612 const size_t *countp, const ptrdiff_t *stridep,
1613 const ptrdiff_t *imapp, int *ip);
1614
1615EXTERNL int
1616nc_put_varm_long(int ncid, int varid, const size_t *startp,
1617 const size_t *countp, const ptrdiff_t *stridep,
1618 const ptrdiff_t *imapp, const long *op);
1619
1620EXTERNL int
1621nc_get_varm_long(int ncid, int varid, const size_t *startp,
1622 const size_t *countp, const ptrdiff_t *stridep,
1623 const ptrdiff_t *imapp, long *ip);
1624
1625EXTERNL int
1626nc_put_varm_float(int ncid, int varid,const size_t *startp,
1627 const size_t *countp, const ptrdiff_t *stridep,
1628 const ptrdiff_t *imapp, const float *op);
1629
1630EXTERNL int
1631nc_get_varm_float(int ncid, int varid,const size_t *startp,
1632 const size_t *countp, const ptrdiff_t *stridep,
1633 const ptrdiff_t *imapp, float *ip);
1634
1635EXTERNL int
1636nc_put_varm_double(int ncid, int varid, const size_t *startp,
1637 const size_t *countp, const ptrdiff_t *stridep,
1638 const ptrdiff_t *imapp, const double *op);
1639
1640EXTERNL int
1641nc_get_varm_double(int ncid, int varid, const size_t *startp,
1642 const size_t *countp, const ptrdiff_t *stridep,
1643 const ptrdiff_t * imapp, double *ip);
1644
1645EXTERNL int
1646nc_put_varm_ushort(int ncid, int varid, const size_t *startp,
1647 const size_t *countp, const ptrdiff_t *stridep,
1648 const ptrdiff_t * imapp, const unsigned short *op);
1649
1650EXTERNL int
1651nc_get_varm_ushort(int ncid, int varid, const size_t *startp,
1652 const size_t *countp, const ptrdiff_t *stridep,
1653 const ptrdiff_t * imapp, unsigned short *ip);
1654
1655EXTERNL int
1656nc_put_varm_uint(int ncid, int varid, const size_t *startp,
1657 const size_t *countp, const ptrdiff_t *stridep,
1658 const ptrdiff_t * imapp, const unsigned int *op);
1659
1660EXTERNL int
1661nc_get_varm_uint(int ncid, int varid, const size_t *startp,
1662 const size_t *countp, const ptrdiff_t *stridep,
1663 const ptrdiff_t * imapp, unsigned int *ip);
1664
1665EXTERNL int
1666nc_put_varm_longlong(int ncid, int varid, const size_t *startp,
1667 const size_t *countp, const ptrdiff_t *stridep,
1668 const ptrdiff_t * imapp, const long long *op);
1669
1670EXTERNL int
1671nc_get_varm_longlong(int ncid, int varid, const size_t *startp,
1672 const size_t *countp, const ptrdiff_t *stridep,
1673 const ptrdiff_t * imapp, long long *ip);
1674
1675EXTERNL int
1676nc_put_varm_ulonglong(int ncid, int varid, const size_t *startp,
1677 const size_t *countp, const ptrdiff_t *stridep,
1678 const ptrdiff_t * imapp, const unsigned long long *op);
1679
1680EXTERNL int
1681nc_get_varm_ulonglong(int ncid, int varid, const size_t *startp,
1682 const size_t *countp, const ptrdiff_t *stridep,
1683 const ptrdiff_t * imapp, unsigned long long *ip);
1684
1685EXTERNL int
1686nc_put_varm_string(int ncid, int varid, const size_t *startp,
1687 const size_t *countp, const ptrdiff_t *stridep,
1688 const ptrdiff_t * imapp, const char **op);
1689
1690EXTERNL int
1691nc_get_varm_string(int ncid, int varid, const size_t *startp,
1692 const size_t *countp, const ptrdiff_t *stridep,
1693 const ptrdiff_t * imapp, char **ip);
1694
1695/* End {put,get}_varm */
1696/* Begin {put,get}_var */
1697
1698EXTERNL int
1699nc_put_var_text(int ncid, int varid, const char *op);
1700
1701EXTERNL int
1702nc_get_var_text(int ncid, int varid, char *ip);
1703
1704EXTERNL int
1705nc_put_var_uchar(int ncid, int varid, const unsigned char *op);
1706
1707EXTERNL int
1708nc_get_var_uchar(int ncid, int varid, unsigned char *ip);
1709
1710EXTERNL int
1711nc_put_var_schar(int ncid, int varid, const signed char *op);
1712
1713EXTERNL int
1714nc_get_var_schar(int ncid, int varid, signed char *ip);
1715
1716EXTERNL int
1717nc_put_var_short(int ncid, int varid, const short *op);
1718
1719EXTERNL int
1720nc_get_var_short(int ncid, int varid, short *ip);
1721
1722EXTERNL int
1723nc_put_var_int(int ncid, int varid, const int *op);
1724
1725EXTERNL int
1726nc_get_var_int(int ncid, int varid, int *ip);
1727
1728EXTERNL int
1729nc_put_var_long(int ncid, int varid, const long *op);
1730
1731EXTERNL int
1732nc_get_var_long(int ncid, int varid, long *ip);
1733
1734EXTERNL int
1735nc_put_var_float(int ncid, int varid, const float *op);
1736
1737EXTERNL int
1738nc_get_var_float(int ncid, int varid, float *ip);
1739
1740EXTERNL int
1741nc_put_var_double(int ncid, int varid, const double *op);
1742
1743EXTERNL int
1744nc_get_var_double(int ncid, int varid, double *ip);
1745
1746EXTERNL int
1747nc_put_var_ushort(int ncid, int varid, const unsigned short *op);
1748
1749EXTERNL int
1750nc_get_var_ushort(int ncid, int varid, unsigned short *ip);
1751
1752EXTERNL int
1753nc_put_var_uint(int ncid, int varid, const unsigned int *op);
1754
1755EXTERNL int
1756nc_get_var_uint(int ncid, int varid, unsigned int *ip);
1757
1758EXTERNL int
1759nc_put_var_longlong(int ncid, int varid, const long long *op);
1760
1761EXTERNL int
1762nc_get_var_longlong(int ncid, int varid, long long *ip);
1763
1764EXTERNL int
1765nc_put_var_ulonglong(int ncid, int varid, const unsigned long long *op);
1766
1767EXTERNL int
1768nc_get_var_ulonglong(int ncid, int varid, unsigned long long *ip);
1769
1770EXTERNL int
1771nc_put_var_string(int ncid, int varid, const char **op);
1772
1773EXTERNL int
1774nc_get_var_string(int ncid, int varid, char **ip);
1775
1776/* Begin instance walking functions */
1777
1778/* When you read an array of string typed instances, the library will allocate
1779 * the storage space for the strings in the array (but not the array itself).
1780 * The strings must be freed eventually, so pass the pointer to the array plus
1781 * the number of elements in the array to this function when you're done with
1782 * the data, and it will free the all the string instances.
1783 * The caller is still responsible for free'ing the array itself,
1784 * if it was dynamically allocated.
1785 */
1786EXTERNL int
1787nc_free_string(size_t nelems, char **data);
1788
1789/* When you read an array of VLEN typed instances, the library will allocate
1790 * the storage space for the data in each VLEN in the array (but not the array itself).
1791 * That VLEN data must be freed eventually, so pass the pointer to the array plus
1792 * the number of elements in the array to this function when you're done with
1793 * the data, and it will free the all the VLEN instances.
1794 * The caller is still responsible for free'ing the array itself,
1795 * if it was dynamically allocated.
1796 *
1797 * WARNING: this function only works if the basetype of the vlen type
1798 * is fixed size. This means it is an atomic type except NC_STRING,
1799 * or an NC_ENUM, or and NC_OPAQUE, or an NC_COMPOUND where all
1800 * the fields of the compound type are themselves fixed size.
1801 */
1802EXTERNL int
1803nc_free_vlens(size_t nelems, nc_vlen_t vlens[]);
1804
1805/* This function is a special case of "nc_free_vlens" where nelem == 1 */
1806EXTERNL int
1808
1827EXTERNL int nc_reclaim_data(int ncid, nc_type xtypeid, void* memory, size_t nelems);
1828EXTERNL int nc_reclaim_data_all(int ncid, nc_type xtypeid, void* memory, size_t nelems);
1829
1843EXTERNL int nc_copy_data(int ncid, nc_type xtypeid, const void* memory, size_t count, void* copy);
1844EXTERNL int nc_copy_data_all(int ncid, nc_type xtypeid, const void* memory, size_t count, void** copyp);
1845
1846/* end recursive instance walking functions */
1847
1848/* Begin Deprecated, same as functions with "_ubyte" replaced by "_uchar" */
1849EXTERNL int
1850nc_put_att_ubyte(int ncid, int varid, const char *name, nc_type xtype,
1851 size_t len, const unsigned char *op);
1852EXTERNL int
1853nc_get_att_ubyte(int ncid, int varid, const char *name,
1854 unsigned char *ip);
1855EXTERNL int
1856nc_put_var1_ubyte(int ncid, int varid, const size_t *indexp,
1857 const unsigned char *op);
1858EXTERNL int
1859nc_get_var1_ubyte(int ncid, int varid, const size_t *indexp,
1860 unsigned char *ip);
1861EXTERNL int
1862nc_put_vara_ubyte(int ncid, int varid, const size_t *startp,
1863 const size_t *countp, const unsigned char *op);
1864EXTERNL int
1865nc_get_vara_ubyte(int ncid, int varid, const size_t *startp,
1866 const size_t *countp, unsigned char *ip);
1867EXTERNL int
1868nc_put_vars_ubyte(int ncid, int varid, const size_t *startp,
1869 const size_t *countp, const ptrdiff_t *stridep,
1870 const unsigned char *op);
1871EXTERNL int
1872nc_get_vars_ubyte(int ncid, int varid, const size_t *startp,
1873 const size_t *countp, const ptrdiff_t *stridep,
1874 unsigned char *ip);
1875EXTERNL int
1876nc_put_varm_ubyte(int ncid, int varid, const size_t *startp,
1877 const size_t *countp, const ptrdiff_t *stridep,
1878 const ptrdiff_t * imapp, const unsigned char *op);
1879EXTERNL int
1880nc_get_varm_ubyte(int ncid, int varid, const size_t *startp,
1881 const size_t *countp, const ptrdiff_t *stridep,
1882 const ptrdiff_t * imapp, unsigned char *ip);
1883EXTERNL int
1884nc_put_var_ubyte(int ncid, int varid, const unsigned char *op);
1885
1886EXTERNL int
1887nc_get_var_ubyte(int ncid, int varid, unsigned char *ip);
1888
1889/* End Deprecated */
1890
1891/* Set the log level. 0 shows only errors, 1 only major messages,
1892 * etc., to 5, which shows way too much information. */
1893EXTERNL int
1894nc_set_log_level(int new_level);
1895
1896/* Use this to turn off logging by calling
1897 nc_log_level(NC_TURN_OFF_LOGGING) */
1898#define NC_TURN_OFF_LOGGING (-1)
1899
1900/* Show the netCDF library's in-memory metadata for a file. */
1901EXTERNL int
1902nc_show_metadata(int ncid);
1903
1904/* End {put,get}_var */
1905
1906/* Delete a file. */
1907EXTERNL int
1908nc_delete(const char *path);
1909
1910/*
1911 * The following functions were written to accommodate the old Cray
1912 * systems. Modern HPC systems do not use these functions any more,
1913 * but use the nc_open_par()/nc_create_par() functions instead. These
1914 * functions are retained for backward compatibibility. These
1915 * functions work as advertised, but you can only use "processor
1916 * element" 0.
1917 */
1918
1919EXTERNL int
1920nc__create_mp(const char *path, int cmode, size_t initialsz, int basepe,
1921 size_t *chunksizehintp, int *ncidp);
1922
1923EXTERNL int
1924nc__open_mp(const char *path, int mode, int basepe,
1925 size_t *chunksizehintp, int *ncidp);
1926
1927EXTERNL int
1928nc_delete_mp(const char *path, int basepe);
1929
1930EXTERNL int
1931nc_set_base_pe(int ncid, int pe);
1932
1933EXTERNL int
1934nc_inq_base_pe(int ncid, int *pe);
1935
1936/* This v2 function is used in the nc_test program. */
1937EXTERNL int
1938nctypelen(nc_type datatype);
1939
1940/* Begin v2.4 backward compatibility */
1941
1944#define FILL_BYTE NC_FILL_BYTE
1945#define FILL_CHAR NC_FILL_CHAR
1946#define FILL_SHORT NC_FILL_SHORT
1947#define FILL_LONG NC_FILL_INT
1948#define FILL_FLOAT NC_FILL_FLOAT
1949#define FILL_DOUBLE NC_FILL_DOUBLE
1950
1951#define MAX_NC_DIMS NC_MAX_DIMS
1952#define MAX_NC_ATTRS NC_MAX_ATTRS
1953#define MAX_NC_VARS NC_MAX_VARS
1954#define MAX_NC_NAME NC_MAX_NAME
1955#define MAX_VAR_DIMS NC_MAX_VAR_DIMS
1959/*
1960 * Global error status
1961 */
1962EXTERNL int ncerr;
1963
1964#define NC_ENTOOL NC_EMAXNAME
1965#define NC_EXDR (-32)
1966#define NC_SYSERR (-31)
1968/*
1969 * Global options variable.
1970 * Used to determine behavior of error handler.
1971 */
1972#define NC_FATAL 1
1973#define NC_VERBOSE 2
1977
1978EXTERNL void
1979nc_advise(const char *cdf_routine_name, int err, const char *fmt,...);
1980
1986typedef int nclong;
1987
1988EXTERNL int
1989nccreate(const char* path, int cmode);
1990
1991EXTERNL int
1992ncopen(const char* path, int mode);
1993
1994EXTERNL int
1995ncsetfill(int ncid, int fillmode);
1996
1997EXTERNL int
1998ncredef(int ncid);
1999
2000EXTERNL int
2001ncendef(int ncid);
2002
2003EXTERNL int
2004ncsync(int ncid);
2005
2006EXTERNL int
2007ncabort(int ncid);
2008
2009EXTERNL int
2010ncclose(int ncid);
2011
2012EXTERNL int
2013ncinquire(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimp);
2014
2015EXTERNL int
2016ncdimdef(int ncid, const char *name, long len);
2017
2018EXTERNL int
2019ncdimid(int ncid, const char *name);
2020
2021EXTERNL int
2022ncdiminq(int ncid, int dimid, char *name, long *lenp);
2023
2024EXTERNL int
2025ncdimrename(int ncid, int dimid, const char *name);
2026
2027EXTERNL int
2028ncattput(int ncid, int varid, const char *name, nc_type xtype,
2029 int len, const void *op);
2030
2031EXTERNL int
2032ncattinq(int ncid, int varid, const char *name, nc_type *xtypep, int *lenp);
2033
2034EXTERNL int
2035ncattget(int ncid, int varid, const char *name, void *ip);
2036
2037EXTERNL int
2038ncattcopy(int ncid_in, int varid_in, const char *name, int ncid_out,
2039 int varid_out);
2040
2041EXTERNL int
2042ncattname(int ncid, int varid, int attnum, char *name);
2043
2044EXTERNL int
2045ncattrename(int ncid, int varid, const char *name, const char *newname);
2046
2047EXTERNL int
2048ncattdel(int ncid, int varid, const char *name);
2049
2050EXTERNL int
2051ncvardef(int ncid, const char *name, nc_type xtype,
2052 int ndims, const int *dimidsp);
2053
2054EXTERNL int
2055ncvarid(int ncid, const char *name);
2056
2057EXTERNL int
2058ncvarinq(int ncid, int varid, char *name, nc_type *xtypep,
2059 int *ndimsp, int *dimidsp, int *nattsp);
2060
2061EXTERNL int
2062ncvarput1(int ncid, int varid, const long *indexp, const void *op);
2063
2064EXTERNL int
2065ncvarget1(int ncid, int varid, const long *indexp, void *ip);
2066
2067EXTERNL int
2068ncvarput(int ncid, int varid, const long *startp, const long *countp,
2069 const void *op);
2070
2071EXTERNL int
2072ncvarget(int ncid, int varid, const long *startp, const long *countp,
2073 void *ip);
2074
2075EXTERNL int
2076ncvarputs(int ncid, int varid, const long *startp, const long *countp,
2077 const long *stridep, const void *op);
2078
2079EXTERNL int
2080ncvargets(int ncid, int varid, const long *startp, const long *countp,
2081 const long *stridep, void *ip);
2082
2083EXTERNL int
2084ncvarputg(int ncid, int varid, const long *startp, const long *countp,
2085 const long *stridep, const long *imapp, const void *op);
2086
2087EXTERNL int
2088ncvargetg(int ncid, int varid, const long *startp, const long *countp,
2089 const long *stridep, const long *imapp, void *ip);
2090
2091EXTERNL int
2092ncvarrename(int ncid, int varid, const char *name);
2093
2094EXTERNL int
2095ncrecinq(int ncid, int *nrecvarsp, int *recvaridsp, long *recsizesp);
2096
2097EXTERNL int
2098ncrecget(int ncid, long recnum, void **datap);
2099
2100EXTERNL int
2101ncrecput(int ncid, long recnum, void *const *datap);
2102
2103/* This function may be called to force the library to
2104 initialize itself. It is not required, however.
2105*/
2106EXTERNL int nc_initialize(void);
2107
2108/* This function may be called to force the library to
2109 cleanup global memory so that memory checkers will not
2110 report errors. It is not required, however.
2111*/
2112EXTERNL int nc_finalize(void);
2113
2114/* Programmatic access to the internal .rc table */
2115
2116/* Get the value corresponding to key | return NULL; caller frees result */
2117EXTERNL char* nc_rc_get(const char* key);
2118
2119/* Set/overwrite the value corresponding to key */
2120EXTERNL int nc_rc_set(const char* key, const char* value);
2121
2122#if defined(__cplusplus)
2123}
2124#endif
2125
2126/* Define two hard-coded functionality-related
2127 (as requested by community developers) macros.
2128 This is not going to be standard practice.
2129 Don't remove without an in-place replacement of some sort,
2130 the are now (for better or worse) used by downstream
2131 software external to Unidata. */
2132#ifndef NC_HAVE_RENAME_GRP
2133#define NC_HAVE_RENAME_GRP
2134#endif
2135
2136#ifndef NC_HAVE_INQ_FORMAT_EXTENDED
2137#define NC_HAVE_INQ_FORMAT_EXTENDED
2138#endif
2139
2140#define NC_HAVE_META_H
2141
2142#endif /* _NETCDF_ */
EXTERNL int nc_get_att_int(int ncid, int varid, const char *name, int *ip)
Get an attribute array of type int.
Definition dattget.c:354
EXTERNL int nc_get_att_string(int ncid, int varid, const char *name, char **ip)
Get an attribute array of type string.
Definition dattget.c:711
EXTERNL int nc_put_att(int ncid, int varid, const char *name, nc_type xtype, size_t len, const void *op)
Write an attribute of any type.
Definition dattput.c:222
EXTERNL int nc_get_att(int ncid, int varid, const char *name, void *ip)
Get an attribute of any type.
Definition dattget.c:133
EXTERNL int nc_get_att_float(int ncid, int varid, const char *name, float *ip)
Get an attribute array of type float.
Definition dattget.c:420
EXTERNL int nc_get_att_long(int ncid, int varid, const char *name, long *ip)
Get an attribute array of type long.
Definition dattget.c:387
EXTERNL int nc_get_att_uchar(int ncid, int varid, const char *name, unsigned char *ip)
Get an attribute of an signed char type.
Definition dattget.c:288
EXTERNL int nc_inq_attid(int ncid, int varid, const char *name, int *idp)
Find an attribute ID.
Definition dattinq.c:164
EXTERNL int nc_get_att_longlong(int ncid, int varid, const char *name, long long *ip)
Get an attribute array of type long long.
Definition dattget.c:585
EXTERNL int nc_put_att_uint(int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned int *op)
Write an attribute of type unsigned int.
Definition dattput.c:562
EXTERNL int nc_get_att_ubyte(int ncid, int varid, const char *name, unsigned char *ip)
Get an attribute array of type unsigned char.
Definition dattget.c:486
EXTERNL int nc_put_att_string(int ncid, int varid, const char *name, size_t len, const char **op)
Write a string attribute.
Definition dattput.c:75
EXTERNL int nc_inq_natts(int ncid, int *nattsp)
Find number of global or group attributes.
Definition dattinq.c:300
EXTERNL int nc_put_att_ubyte(int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned char *op)
Write an attribute of type unsigned char.
Definition dattput.c:494
EXTERNL int nc_put_att_text(int ncid, int varid, const char *name, size_t len, const char *op)
Write a text attribute.
Definition dattput.c:153
EXTERNL int nc_put_att_schar(int ncid, int varid, const char *name, nc_type xtype, size_t len, const signed char *op)
Write an attribute of type signed char.
Definition dattput.c:256
EXTERNL int nc_put_att_ushort(int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned short *op)
Write an attribute of type unsigned short.
Definition dattput.c:528
EXTERNL int nc_put_att_long(int ncid, int varid, const char *name, nc_type xtype, size_t len, const long *op)
Write an attribute of type long.
Definition dattput.c:392
EXTERNL int nc_put_att_float(int ncid, int varid, const char *name, nc_type xtype, size_t len, const float *op)
Write an attribute of type float.
Definition dattput.c:426
EXTERNL int nc_put_att_uchar(int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned char *op)
Write an attribute of type unsigned char.
Definition dattput.c:290
EXTERNL int nc_get_att_ulonglong(int ncid, int varid, const char *name, unsigned long long *ip)
Get an attribute array of type unsigned long long.
Definition dattget.c:618
EXTERNL int nc_get_att_text(int ncid, int varid, const char *name, char *ip)
Get a text attribute.
Definition dattget.c:222
EXTERNL int nc_get_att_short(int ncid, int varid, const char *name, short *ip)
Get an attribute array of type short.
Definition dattget.c:321
EXTERNL int nc_inq_att(int ncid, int varid, const char *name, nc_type *xtypep, size_t *lenp)
Return information about a netCDF attribute.
Definition dattinq.c:86
EXTERNL int nc_get_att_schar(int ncid, int varid, const char *name, signed char *ip)
Get an attribute of an signed char type.
Definition dattget.c:255
EXTERNL int nc_put_att_longlong(int ncid, int varid, const char *name, nc_type xtype, size_t len, const long long *op)
Write an attribute of type long long.
Definition dattput.c:596
EXTERNL int nc_get_att_double(int ncid, int varid, const char *name, double *ip)
Get an attribute array of type double.
Definition dattget.c:453
EXTERNL int nc_inq_atttype(int ncid, int varid, const char *name, nc_type *xtypep)
Find the type of an attribute.
Definition dattinq.c:358
EXTERNL int nc_put_att_ulonglong(int ncid, int varid, const char *name, nc_type xtype, size_t len, const unsigned long long *op)
Write an attribute of type unsigned long long.
Definition dattput.c:631
EXTERNL int nc_put_att_int(int ncid, int varid, const char *name, nc_type xtype, size_t len, const int *op)
Write an attribute of type int.
Definition dattput.c:358
EXTERNL int nc_del_att(int ncid, int varid, const char *name)
Delete an attribute.
Definition datt.c:177
EXTERNL int nc_rename_att(int ncid, int varid, const char *name, const char *newname)
Rename an attribute.
Definition datt.c:113
EXTERNL int nc_get_att_ushort(int ncid, int varid, const char *name, unsigned short *ip)
Get an attribute array of type unsigned short.
Definition dattget.c:519
EXTERNL int nc_put_att_short(int ncid, int varid, const char *name, nc_type xtype, size_t len, const short *op)
Write an attribute of type short.
Definition dattput.c:324
EXTERNL int nc_inq_attname(int ncid, int varid, int attnum, char *name)
Find the name of an attribute.
Definition dattinq.c:255
EXTERNL int nc_inq_attlen(int ncid, int varid, const char *name, size_t *lenp)
Find the length of an attribute.
Definition dattinq.c:424
EXTERNL int nc_get_att_uint(int ncid, int varid, const char *name, unsigned int *ip)
Get an attribute array of type unsigned int.
Definition dattget.c:552
EXTERNL int nc_put_att_double(int ncid, int varid, const char *name, nc_type xtype, size_t len, const double *op)
Write an attribute of type double.
Definition dattput.c:460
EXTERNL int nc_inq_user_format(int mode_flag, NC_Dispatch **dispatch_table, char *magic_number)
Inquire about user-defined format.
Definition dfile.c:179
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 caching.
Definition dfile.c:470
EXTERNL int nc_close(int ncid)
Close an open netCDF dataset.
Definition dfile.c:1300
EXTERNL int nc_abort(int ncid)
No longer necessary for user to invoke manually.
Definition dfile.c:1247
EXTERNL int nc_create(const char *path, int cmode, int *ncidp)
Create a new netCDF file.
Definition dfile.c:398
EXTERNL int nc_inq(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimidp)
Inquire about a file or group.
Definition dfile.c:1635
EXTERNL int nc_inq_format_extended(int ncid, int *formatp, int *modep)
Obtain more detailed (vis-a-vis nc_inq_format) format information about an open dataset.
Definition dfile.c:1582
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.
Definition dfile.c:1118
EXTERNL int nc_set_fill(int ncid, int fillmode, int *old_modep)
Change the fill-value mode to improve write performance.
Definition dfile.c:1474
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.
Definition dfile.c:721
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.
Definition dfile.c:898
EXTERNL int nc_def_user_format(int mode_flag, NC_Dispatch *dispatch_table, char *magic_number)
Add handling of user-defined format.
Definition dfile.c:123
EXTERNL int nc_get_chunk_cache(size_t *sizep, size_t *nelemsp, float *preemptionp)
Get current netCDF chunk cache settings.
Definition nc4cache.c:95
EXTERNL int nc_inq_type(int ncid, nc_type xtype, char *name, size_t *size)
Inquire about a type.
Definition dfile.c:1728
EXTERNL int nc_enddef(int ncid)
Leave define mode.
Definition dfile.c:1027
EXTERNL int nc_redef(int ncid)
Put open netcdf dataset into define mode.
Definition dfile.c:963
EXTERNL int nc_open(const char *path, int mode, int *ncidp)
Open an existing netCDF file.
Definition dfile.c:664
EXTERNL int nc_set_chunk_cache(size_t size, size_t nelems, float preemption)
Set chunk cache size.
Definition nc4cache.c:66
EXTERNL int nc_inq_format(int ncid, int *formatp)
Inquire about the binary format of a netCDF file as presented by the API.
Definition dfile.c:1547
EXTERNL int nc_sync(int ncid)
Synchronize an open netcdf dataset to disk.
Definition dfile.c:1195
EXTERNL int nc_inq_ndims(int ncid, int *ndimsp)
Find the number of dimensions.
Definition ddim.c:317
EXTERNL int nc_inq_dimlen(int ncid, int dimid, size_t *lenp)
Find the length of a dimension.
Definition ddim.c:467
EXTERNL int nc_inq_dimname(int ncid, int dimid, char *name)
Find out the name of a dimension.
Definition ddim.c:409
EXTERNL int nc_def_dim(int ncid, const char *name, size_t len, int *idp)
Define a new dimension.
Definition ddim.c:121
EXTERNL int nc_rename_dim(int ncid, int dimid, const char *name)
Rename a dimension.
Definition ddim.c:285
EXTERNL int nc_inq_dim(int ncid, int dimid, char *name, size_t *lenp)
Find the name and length of a dimension.
Definition ddim.c:216
EXTERNL int nc_inq_unlimdim(int ncid, int *unlimdimidp)
Find the ID of the unlimited dimension.
Definition ddim.c:350
EXTERNL int nc_inq_dimid(int ncid, const char *name, int *idp)
Find the ID of a dimension from the name.
Definition ddim.c:152
EXTERNL const char * nc_strerror(int ncerr)
Given an error number, return an error message.
Definition derror.c:87
EXTERNL int nc_inq_typeids(int ncid, int *ntypes, int *typeids)
Retrieve a list of types associated with a group.
Definition dgroup.c:223
EXTERNL int nc_inq_dimids(int ncid, int *ndims, int *dimids, int include_parents)
Retrieve a list of dimension ids associated with a group.
Definition dgroup.c:205
EXTERNL int nc_inq_grps(int ncid, int *numgrps, int *ncids)
Get a list of groups or subgroups from a file or groupID.
Definition dgroup.c:73
EXTERNL int nc_show_metadata(int ncid)
Print the metadata for a file.
Definition dgroup.c:299
EXTERNL int nc_inq_grp_full_ncid(int ncid, const char *full_name, int *grp_ncid)
Get the full ncid given a group name.
Definition dgroup.c:169
EXTERNL int nc_inq_grpname(int ncid, char *name)
Get the name of a group given an ID.
Definition dgroup.c:88
EXTERNL int nc_inq_ncid(int ncid, const char *name, int *grp_ncid)
Return the group ID for a group given the name.
Definition dgroup.c:56
EXTERNL int nc_inq_varids(int ncid, int *nvars, int *varids)
Get a list of varids associated with a group given a group ID.
Definition dgroup.c:187
EXTERNL int nc_inq_grp_parent(int ncid, int *parent_ncid)
Get the ID of the parent based on a group ID.
Definition dgroup.c:136
EXTERNL int nc_inq_grpname_len(int ncid, size_t *lenp)
Get the length of a group name given an ID.
Definition dgroup.c:122
EXTERNL int nc_inq_grpname_full(int ncid, size_t *lenp, char *full_name)
Get the full path/groupname of a group/subgroup given an ID.
Definition dgroup.c:106
EXTERNL int nc_def_grp(int parent_ncid, const char *name, int *new_ncid)
Define a new group.
Definition dgroup.c:268
EXTERNL int nc_rename_grp(int grpid, const char *name)
Rename a group.
Definition dgroup.c:284
EXTERNL int nc_inq_grp_ncid(int ncid, const char *grp_name, int *grp_ncid)
Get a group ncid given the group name.
Definition dgroup.c:155
EXTERNL int nc_def_enum(int ncid, nc_type base_typeid, const char *name, nc_type *typeidp)
Create an enum type.
Definition denum.c:43
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.
Definition dcompound.c:383
EXTERNL int nc_inq_type_equal(int ncid1, nc_type typeid1, int ncid2, nc_type typeid2, int *equal)
Learn if two types are equal.
Definition dtype.c:69
EXTERNL int nc_inq_compound(int ncid, nc_type xtype, char *name, size_t *sizep, size_t *nfieldsp)
Learn about a compound type.
Definition dcompound.c:175
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.
Definition denum.c:140
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.
Definition dcompound.c:99
EXTERNL int nc_def_opaque(int ncid, size_t size, const char *name, nc_type *xtypep)
Create an opaque type.
Definition dopaque.c:33
EXTERNL int nc_inq_compound_name(int ncid, nc_type xtype, char *name)
Learn the name of a compound type.
Definition dcompound.c:203
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.
Definition dcompound.c:287
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.
Definition dvlen.c:93
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.
Definition dcompound.c:443
EXTERNL int nc_free_vlen(nc_vlen_t *vl)
Free memory in a single VLEN object.
Definition dvlen.c:61
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.
Definition dvlen.c:121
EXTERNL int nc_inq_opaque(int ncid, nc_type xtype, char *name, size_t *sizep)
Learn about an opaque type.
Definition dopaque.c:61
EXTERNL int nc_free_vlens(size_t nelems, nc_vlen_t vlens[])
Free an array of vlens given the number of elements and an array.
Definition dvlen.c:40
EXTERNL int nc_def_compound(int ncid, size_t size, const char *name, nc_type *typeidp)
Create a compound type.
Definition dcompound.c:63
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.
Definition dcompound.c:475
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.
Definition dcompound.c:413
EXTERNL int nc_inq_compound_nfields(int ncid, nc_type xtype, size_t *nfieldsp)
Learn the number of fields in a compound type.
Definition dcompound.c:249
EXTERNL int nc_insert_enum(int ncid, nc_type xtype, const char *name, const void *value)
Insert a named member into a enum type.
Definition denum.c:71
EXTERNL int nc_inq_typeid(int ncid, const char *name, nc_type *typeidp)
Find a type by name.
Definition dtype.c:102
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.
Definition dcompound.c:141
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.
Definition denum.c:107
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.
Definition denum.c:164
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.
Definition dcompound.c:353
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.
Definition dcompound.c:321
EXTERNL int nc_inq_compound_size(int ncid, nc_type xtype, size_t *sizep)
Learn the size of a compound type.
Definition dcompound.c:226
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.
Definition dtype.c:146
EXTERNL int ncvardef(int ncid, const char *name, nc_type xtype, int ndims, const int *dimidsp)
Define a variable.
Definition dv2i.c:856
EXTERNL int ncclose(int ncid)
Close a file.
Definition dv2i.c:606
EXTERNL int ncvarputg(int ncid, int varid, const long *startp, const long *countp, const long *stridep, const long *imapp, const void *op)
Write mapped data.
Definition dv2i.c:1231
EXTERNL int ncattget(int ncid, int varid, const char *name, void *ip)
Read an attribute.
Definition dv2i.c:1479
EXTERNL int ncattinq(int ncid, int varid, const char *name, nc_type *xtypep, int *lenp)
Learn about an attribute.
Definition dv2i.c:1440
EXTERNL int ncattrename(int ncid, int varid, const char *name, const char *newname)
Rename an attribute.
Definition dv2i.c:1574
EXTERNL int ncattname(int ncid, int varid, int attnum, char *name)
Learn attribute name from its number.
Definition dv2i.c:1543
EXTERNL int ncvarput1(int ncid, int varid, const long *indexp, const void *op)
Write 1 data value.
Definition dv2i.c:965
EXTERNL int ncvarid(int ncid, const char *name)
Learn a variable ID from the name.
Definition dv2i.c:887
EXTERNL int nccreate(const char *path, int cmode)
Create a netCDF file.
Definition dv2i.c:511
EXTERNL int ncendef(int ncid)
End define mode for file.
Definition dv2i.c:583
EXTERNL int ncopen(const char *path, int mode)
Open a netCDF file.
Definition dv2i.c:536
EXTERNL int ncrecput(int ncid, long recnum, void *const *datap)
Write one record's worth of data, except don't write to variables for which the address of the data t...
Definition dv2i.c:1754
EXTERNL int ncattcopy(int ncid_in, int varid_in, const char *name, int ncid_out, int varid_out)
Copy an attribute.
Definition dv2i.c:1511
EXTERNL int ncdimrename(int ncid, int dimid, const char *name)
Rename a dimension.
Definition dv2i.c:825
EXTERNL int ncattdel(int ncid, int varid, const char *name)
Delete an attribute.
Definition dv2i.c:1604
EXTERNL int ncvarputs(int ncid, int varid, const long *startp, const long *countp, const long *stridep, const void *op)
Write strided data.
Definition dv2i.c:1125
EXTERNL int ncvarput(int ncid, int varid, const long *startp, const long *countp, const void *op)
Write some data.
Definition dv2i.c:1040
EXTERNL int ncdiminq(int ncid, int dimid, char *name, long *lenp)
Learn about a dimension.
Definition dv2i.c:788
EXTERNL int ncvarget1(int ncid, int varid, const long *indexp, void *ip)
Read 1 data value.
Definition dv2i.c:1002
EXTERNL int ncvargetg(int ncid, int varid, const long *startp, const long *countp, const long *stridep, const long *imapp, void *ip)
Read mapped data.
Definition dv2i.c:1304
EXTERNL int ncinquire(int ncid, int *ndimsp, int *nvarsp, int *nattsp, int *unlimdimp)
Learn about a file.
Definition dv2i.c:635
EXTERNL int ncvarinq(int ncid, int varid, char *name, nc_type *xtypep, int *ndimsp, int *dimidsp, int *nattsp)
Learn about a variable.
Definition dv2i.c:920
EXTERNL int ncattput(int ncid, int varid, const char *name, nc_type xtype, int len, const void *op)
Write an attribute.
Definition dv2i.c:1405
EXTERNL void nc_advise(const char *cdf_routine_name, int err, const char *fmt,...)
Show an error message and exit (based on ncopts).
Definition dv2i.c:466
EXTERNL int ncabort(int ncid)
Abort defining a file.
Definition dv2i.c:700
EXTERNL int ncsync(int ncid)
Sync a file.
Definition dv2i.c:677
EXTERNL int ncrecinq(int ncid, int *nrecvarsp, int *recvaridsp, long *recsizesp)
Learn record variables and the lengths of the record dimension.
Definition dv2i.c:1666
EXTERNL int ncrecget(int ncid, long recnum, void **datap)
Read one record's worth of data, except don't read from variables for which the address of the data t...
Definition dv2i.c:1723
EXTERNL int ncsetfill(int ncid, int fillmode)
Set the fill mode.
Definition dv2i.c:1636
EXTERNL int ncdimdef(int ncid, const char *name, long len)
Define a dimension.
Definition dv2i.c:726
EXTERNL int ncvarget(int ncid, int varid, const long *startp, const long *countp, void *ip)
Read some data.
Definition dv2i.c:1082
EXTERNL int ncvargets(int ncid, int varid, const long *startp, const long *countp, const long *stridep, void *ip)
Read strided data.
Definition dv2i.c:1178
EXTERNL int ncredef(int ncid)
Put file in define mode.
Definition dv2i.c:560
EXTERNL int ncvarrename(int ncid, int varid, const char *name)
Rename a variable.
Definition dv2i.c:1373
EXTERNL int ncdimid(int ncid, const char *name)
Find dimension ID from name.
Definition dv2i.c:761
EXTERNL int nc_inq_var_endian(int ncid, int varid, int *endianp)
Find the endianness of a variable.
Definition dvarinq.c:582
EXTERNL int nc_inq_varndims(int ncid, int varid, int *ndimsp)
Learn how many dimensions are associated with a variable.
Definition dvarinq.c:202
EXTERNL int nc_def_var_endian(int ncid, int varid, int endian)
Define endianness of a variable.
Definition dvar.c:807
EXTERNL int nc_inq_varname(int ncid, int varid, char *name)
Learn the name of a variable.
Definition dvarinq.c:156
EXTERNL int nc_free_string(size_t nelems, char **data)
Free string space allocated by the library.
Definition dvar.c:1316
EXTERNL int nc_inq_var_quantize(int ncid, int varid, int *quantize_modep, int *nsdp)
Learn whether quantization is on for a variable, and, if so, the NSD setting.
Definition dvarinq.c:545
EXTERNL int nc_def_var_szip(int ncid, int varid, int options_mask, int pixels_per_block)
Set szip compression settings on a variable.
Definition dvar.c:864
EXTERNL int nc_inq_var_deflate(int ncid, int varid, int *shufflep, int *deflatep, int *deflate_levelp)
Learn the shuffle and deflate settings for a variable.
Definition dvarinq.c:295
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.
Definition dvarget.c:1173
EXTERNL int nc_set_var_chunk_cache(int ncid, int varid, size_t size, size_t nelems, float preemption)
Change the cache settings for a chunked variable.
Definition dvar.c:1394
EXTERNL int nc_inq_vartype(int ncid, int varid, nc_type *xtypep)
Learn the type of a variable.
Definition dvarinq.c:178
EXTERNL int nc_inq_var_fletcher32(int ncid, int varid, int *fletcher32p)
Learn the checksum settings for a variable.
Definition dvarinq.c:378
EXTERNL int nc_inq_varid(int ncid, const char *name, int *varidp)
Find the ID of a variable, from the name.
Definition dvarinq.c:60
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.
Definition dvarput.c:1243
EXTERNL int nc_inq_varnatts(int ncid, int varid, int *nattsp)
Learn how many attributes are associated with a variable.
Definition dvarinq.c:249
EXTERNL int nc_put_var(int ncid, int varid, const void *op)
Write an entire variable with one call.
Definition dvarput.c:922
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.
Definition dvarget.c:746
EXTERNL int nc_def_var_deflate(int ncid, int varid, int shuffle, int deflate, int deflate_level)
Set the zlib compression and shuffle settings for a variable in an netCDF/HDF5 file.
Definition dvar.c:461
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.
Definition dvarput.c:1048
EXTERNL int nc_def_var_fletcher32(int ncid, int varid, int fletcher32)
Set checksum for a var.
Definition dvar.c:609
EXTERNL int nc_def_var_quantize(int ncid, int varid, int quantize_mode, int nsd)
Turn on quantization for a variable.
Definition dvar.c:560
EXTERNL int nc_get_var(int ncid, int varid, void *ip)
Read an entire variable in one call.
Definition dvarget.c:1038
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.
Definition dvarget.c:1370
EXTERNL int nc_inq_var(int ncid, int varid, char *name, nc_type *xtypep, int *ndimsp, int *dimidsp, int *nattsp)
Learn about a variable.
Definition dvarinq.c:124
EXTERNL int nc_inq_var_szip(int ncid, int varid, int *options_maskp, int *pixels_per_blockp)
Learn the szip settings of a variable.
Definition dvarinq.c:732
EXTERNL int nc_inq_var_filter(int ncid, int varid, unsigned int *idp, size_t *nparams, unsigned int *params)
Find the first filter (if any) associated with a variable.
Definition dfilter.c:167
EXTERNL int nc_inq_vardimid(int ncid, int varid, int *dimidsp)
Learn the dimension IDs associated with a variable.
Definition dvarinq.c:225
EXTERNL int nc_get_var1(int ncid, int varid, const size_t *indexp, void *ip)
Read a single datum from a variable.
Definition dvarget.c:894
EXTERNL int nc_def_var_fill(int ncid, int varid, int no_fill, const void *fill_value)
Set the fill value for a variable.
Definition dvar.c:309
EXTERNL int nc_inq_var_chunking(int ncid, int varid, int *storagep, size_t *chunksizesp)
Get the storage and (for chunked variables) the chunksizes of a variable.
Definition dvarinq.c:466
EXTERNL int nc_def_var(int ncid, const char *name, nc_type xtype, int ndims, const int *dimidsp, int *varidp)
Define a new variable.
Definition dvar.c:214
EXTERNL int nc_rename_var(int ncid, int varid, const char *name)
Rename a variable.
Definition dvar.c:944
EXTERNL int nc_put_var1(int ncid, int varid, const size_t *indexp, const void *op)
Write one datum.
Definition dvarput.c:783
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.
Definition dvarput.c:633
EXTERNL int nc_def_var_chunking(int ncid, int varid, int storage, const size_t *chunksizesp)
Define storage and, if chunked storage is used, chunking parameters for a variable.
Definition dvar.c:729
EXTERNL int nc_get_var_chunk_cache(int ncid, int varid, size_t *sizep, size_t *nelemsp, float *preemptionp)
Get the per-variable chunk cache settings from the HDF5 layer.
Definition dvar.c:1435
EXTERNL int nc_inq_var_fill(int ncid, int varid, int *no_fill, void *fill_valuep)
Learn the fill mode of a variable.
Definition dvarinq.c:502
EXTERNL int nc_inq_nvars(int ncid, int *nvarsp)
Learn the number of variables in a file or group.
Definition dfile.c:1654
EXTERNL const char * nc_inq_libvers(void)
Return the library version.
Definition derror.c:27
void * p
Pointer to VL data.
Definition netcdf.h:758
EXTERNL int nc_reclaim_data(int ncid, nc_type xtypeid, void *memory, size_t nelems)
Reclaim an array of instances of an arbitrary type.
size_t len
Length of VL data (in base type units)
Definition netcdf.h:757
EXTERNL int nc_inq_unlimdims(int ncid, int *nunlimdimsp, int *unlimdimidsp)
Return number and list of unlimited dimensions.
Definition dvarinq.c:672
#define EXTERNL
Needed for DLL build.
Definition netcdf.h:566
EXTERNL int ncopts
V2 API error handling.
Definition netcdf.h:1976
EXTERNL int nc_copy_data(int ncid, nc_type xtypeid, const void *memory, size_t count, void *copy)
Copy vector of arbitrary type instances.
int nclong
C data type corresponding to a netCDF NC_LONG argument, a signed 32 bit object.
Definition netcdf.h:1986
EXTERNL int nc_copy_att(int ncid_in, int varid_in, const char *name, int ncid_out, int varid_out)
Copy an attribute from one open file to another.
Definition dcopy.c:587
EXTERNL int nc_copy_var(int ncid_in, int varid, int ncid_out)
This will copy a variable that is an array of primitive type and its attributes from one file to anot...
Definition dcopy.c:282
EXTERNL int nc_def_var_filter(int ncid, int varid, unsigned int id, size_t nparams, const unsigned int *parms)
Define a new variable filter Assumes HDF5 format using unsigned ints.
Definition dfilter.c:126
int nc_type
The nc_type type is just an int.
Definition netcdf.h:25
This is the type of arrays of vlens.
Definition netcdf.h:756