Last modified: 22 April 2016
Name: H5Pget_virtual_printf_gap
Signature:
  `herr_t H5Pget_virtual_printf_gap( hid_t dapl_id, hsize_t *gap_size )`
Purpose:
  Returns the maximum number of missing source files and/or datasets with the printf-style names when getting the extent for an unlimited virtual dataset.
Description:
  `H5Pget_virtual_printf_gap` returns the maximum number of missing printf-style files and/or datasets for determining the extent of an unlimited virtual dataaset, `gap_size`, using the access property list for the virtual dataset, `dapl_id`.

  The default library value for `gap_size` is `0` (zero).
Parameters:

  `hid_t dapl_id` | `` | IN: Dataset access property list identifier for the virtual dataset
  `hsize_t *gap_size` | `` | OUT: Maximum number of the files and/or datasets allowed to be missing for determining the extent of an unlimited virtual dataset with printf-style mappings. (Default: `0`)

Returns:
  Returns a non-negative value if successful; otherwise returns a negative value.
Fortran Interface: h5pget_virtual_printf_gap_f
See Also:

  “Virtual Dataset Overview” “Using HDF5 Virtual Datasets” Supporting functions: H5Pset_layout H5Pget_layout H5Sis_regular_hyperslab H5Sget_regular_hyperslab H5Sselect_hyperslab | VDS functions: H5Pset_virtual H5Pget_virtual_count H5Pget_virtual_vspace H5Pget_virtual_srcspace H5Pget_virtual_filename H5Pget_virtual_dsetname H5Pset_virtual_printf_gap H5Pset_virtual_view H5Pget_virtual_view

History:

  Release | Change
  1.10.0 | C function introduced with this release.