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

Return to the Main Unidata NetCDF page.
Generated on Sat Dec 30 2017 10:59:33 for NetCDF. NetCDF is a Unidata library.