mirror of
https://github.com/Unidata/netcdf-c.git
synced 2025-02-11 16:40:36 +08:00
ccc70d640b
and https://github.com/Unidata/netcdf-c/issues/708 Expand the NC_INMEMORY capabilities to support writing and accessing the final modified memory. Three new functions have been added: nc_open_memio, nc_create_mem, and nc_close_memio. The following new capabilities were added. 1. nc_open_memio() allows the NC_WRITE mode flag so a chunk of memory can be passed in and be modified 2. nc_create_mem() allows the NC_INMEMORY flag to be set to cause the created file to be kept in memory. 3. nc_close_mem() allows the final in-memory contents to be retrieved at the time the file is closed. 4. A special flag, NC_MEMIO_LOCK, is provided to ensure that the provided memory will not be freed or reallocated. Note the following. 1. If nc_open_memio() is called with NC_WRITE, and NC_MEMIO_LOCK is not set, then the netcdf-c library will take control of the incoming memory. This means that the original memory block should not be freed but the block returned by nc_close_mem() must be freed. 2. If nc_open_memio() is called with NC_WRITE, and NC_MEMIO_LOCK is set, then modifications to the original memory may fail if the space available is insufficient. Documentation is provided in the file docs/inmemory.md. A test case is provided: nc_test/tst_inmemory.c driven by nc_test/run_inmemory.sh WARNING: changes were made to the dispatch table for the close entry. From int (*close)(int) to int (*close)(int,void*). |
||
|---|---|---|
| .. | ||
| .gitignore | ||
| ceconstraints.h | ||
| CMakeLists.txt | ||
| err_macros.h | ||
| fbits.h | ||
| hdf4dispatch.h | ||
| Makefile.am | ||
| nc3dispatch.h | ||
| nc3internal.h | ||
| nc4dispatch.h | ||
| nc4internal.h | ||
| nc_hashmap.h | ||
| nc_logging.h | ||
| nc_tests.h | ||
| nc.h | ||
| ncauth.h | ||
| ncaux.h | ||
| ncbytes.h | ||
| ncconfigure.h | ||
| ncdap.h | ||
| ncdimscale.h | ||
| ncdispatch.h | ||
| ncexternl.h | ||
| ncfilter.h | ||
| nchashmap.h | ||
| nclist.h | ||
| nclistmap.h | ||
| nclog.h | ||
| ncoffsets.h | ||
| ncrc.h | ||
| nctestserver.h | ||
| nctime.h | ||
| ncuri.h | ||
| ncutf8.h | ||
| ncwinpath.h | ||
| netcdf_f.h | ||
| netcdf_mem.h | ||
| netcdf_meta.h.in | ||
| netcdf_par.h | ||
| netcdf.h | ||
| onstack.h | ||
| rnd.h | ||
| XGetopt.h | ||