ncsa.hdf.hdf5lib
Class H5

java.lang.Object
  extended by ncsa.hdf.hdf5lib.H5

public class H5
extends java.lang.Object

This class is the Java interface for the HDF5 library.

This code is the called by Java programs to access the entry points of the HDF5 library. Each routine wraps a single HDF5 entry point, generally with the arguments and return codes analogous to the C interface.

For details of the HDF5 library, see the HDF5 Documentation at: http://hdfgroup.org/HDF5/


Mapping of arguments for Java

In general, arguments to the HDF Java API are straightforward translations from the 'C' API described in the HDF Reference Manual.

HDF-5 C types to Java types
HDF-5 Java
H5T_NATIVE_INT int, Integer
H5T_NATIVE_SHORT short, Short
H5T_NATIVE_FLOAT float, Float
H5T_NATIVE_DOUBLE double, Double
H5T_NATIVE_CHAR byte, Byte
H5T_C_S1 java.lang.String
void *
(i.e., pointer to `Any')
Special -- see HDFArray

General Rules for Passing Arguments and Results

In general, arguments passed IN to Java are the analogous basic types, as above. The exception is for arrays, which are discussed below.

The return value of Java methods is also the analogous type, as above. A major exception to that rule is that all HDF functions that return SUCCEED/FAIL are declared boolean in the Java version, rather than int as in the C. Functions that return a value or else FAIL are declared the equivalent to the C function. However, in most cases the Java method will raise an exception instead of returning an error code. See Errors and Exceptions below.

Java does not support pass by reference of arguments, so arguments that are returned through OUT parameters must be wrapped in an object or array. The Java API for HDF consistently wraps arguments in arrays.

For instance, a function that returns two integers is declared:

       h_err_t HDF5dummy( int *a1, int *a2)
 
For the Java interface, this would be declared:

 public synchronized static native int HDF5dummy(int args[]);
 
where a1 is args[0] and a2 is args[1], and would be invoked:

 H5.HDF5dummy(a);
 

All the routines where this convention is used will have specific documentation of the details, given below.

Arrays

HDF5 needs to read and write multi-dimensional arrays of any number type (and records). The HDF5 API describes the layout of the source and destination, and the data for the array passed as a block of bytes, for instance,

      herr_t H5Dread(int fid, int filetype, int memtype, int memspace,
      void * data);
 

where ``void *'' means that the data may be any valid numeric type, and is a contiguous block of bytes that is the data for a multi-dimensional array. The other parameters describe the dimensions, rank, and datatype of the array on disk (source) and in memory (destination).

For Java, this ``ANY'' is a problem, as the type of data must always be declared. Furthermore, multidimensional arrays are definitely not layed out contiguously in memory. It would be infeasible to declare a separate routine for every combination of number type and dimensionality. For that reason, the HDFArray class is used to discover the type, shape, and size of the data array at run time, and to convert to and from a contiguous array of bytes in synchronized static native C order.

The upshot is that any Java array of numbers (either primitive or sub-classes of type Number) can be passed as an ``Object'', and the Java API will translate to and from the appropriate packed array of bytes needed by the C library. So the function above would be declared:

 public synchronized static native int H5Dread(int fid, int filetype,
         int memtype, int memspace, Object data);
 
and the parameter data can be any multi-dimensional array of numbers, such as float[][], or int[][][], or Double[][].

HDF-5 Constants

The HDF-5 API defines a set of constants and enumerated values. Most of these values are available to Java programs via the class HDF5Constants. For example, the parameters for the h5open() call include two numeric values, HDFConstants.H5F_ACC_RDWR and HDF5Constants.H5P_DEFAULT. As would be expected, these numbers correspond to the C constants H5F_ACC_RDWR and H5P_DEFAULT.

The HDF-5 API defines a set of values that describe number types and sizes, such as "H5T_NATIVE_INT" and "hsize_t". These values are determined at run time by the HDF-5 C library. To support these parameters, the Java class HDF5CDataTypes looks up the values when initiated. The values can be accessed as public variables of the Java class, such as:

 int data_type = HDF5CDataTypes.JH5T_NATIVE_INT;
 
The Java application uses both types of constants the same way, the only difference is that the HDF5CDataTypes may have different values on different platforms.

Error handling and Exceptions

The HDF5 error API (H5E) manages the behavior of the error stack in the HDF-5 library. This API is omitted from the JHI5. Errors are converted into Java exceptions. This is totally different from the C interface, but is very natural for Java programming.

The exceptions of the JHI5 are organized as sub-classes of the class HDF5Exception. There are two subclasses of HDF5Exception, HDF5LibraryException and HDF5JavaException. The sub-classes of the former represent errors from the HDF-5 C library, while sub-classes of the latter represent errors in the JHI5 wrapper and support code.

The super-class HDF5LibraryException implements the method 'printStackTrace()', which prints out the HDF-5 error stack, as described in the HDF-5 C API H5Eprint(). This may be used by Java exception handlers to print out the HDF-5 error stack.


Version:
HDF5 1.2
See also: ncsa.hdf.hdf5lib.HDFArray
ncsa.hdf.hdf5lib.HDF5Constants
ncsa.hdf.hdf5lib.HDF5CDataTypes
ncsa.hdf.hdf5lib.HDF5Exception
http://hdfgroup.org/HDF5"

Field Summary
static java.lang.String H5_LIBRARY_NAME_PROPERTY_KEY
           
static java.lang.String H5PATH_PROPERTY_KEY
           
static int[] LIB_VERSION
          The version number of the HDF5 library:
LIB_VERSION[0]: The major version of the library.
LIB_VERSION[1]: The minor version of the library.
LIB_VERSION[2]: The release number of the library.
Make sure to update the verions number when a different library is used.
static int LOGGING_LEVEL
          logging level: 0 -- information, 1 -- warning message, 2 -- failure
 
Constructor Summary
H5()
           
 
Method Summary
static int _H5Gcreate_anon(int loc_id, int gcpl_id, int gapl_id)
           
static int _H5Gcreate2(int loc_id, java.lang.String name, int lcpl_id, int gcpl_id, int gapl_id)
           
static int _H5Gopen2(int loc_id, java.lang.String name, int gapl_id)
           
static int _H5Oopen(int loc_id, java.lang.String name, int lapl_id)
           
static int _H5Screate_simple(int rank, long[] dims, long[] maxdims)
           
static int getOpenID(int index)
          Get the open ID at the specified index.
static int getOpenIDCount()
          Get number of open IDs.
static int H5Aclose(int attr_id)
          H5Aclose terminates access to the attribute specified by its identifier, attr_id.
static int H5Acopy(int src_aid, int dst_aid)
          H5Acopy copies the content of one attribute to another.
static int H5Acreate_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int type_id, int space_id, int acpl_id, int aapl_id, int lapl_id)
          H5Acreate_by_name creates an attribute, attr_name, which is attached to the object specified by loc_id and obj_name.
static int H5Acreate(int loc_id, java.lang.String name, int type_id, int space_id, int create_plist)
          Deprecated. As of HDF5 1.8, replaced by H5Acreate( int, String, int, int, int, int)
static int H5Acreate(int loc_id, java.lang.String attr_name, int type_id, int space_id, int acpl_id, int aapl_id)
          H5Acreate creates an attribute, attr_name, which is attached to the object specified by the identifier loc_id.
static void H5Adelete_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id)
          H5Adelete_by_idx removes an attribute, specified by its location in an index, from an object.
static int H5Adelete_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id)
          H5Adelete_by_name removes the attribute attr_name from an object specified by location and name, loc_id and obj_name, respectively.
static int H5Adelete(int loc_id, java.lang.String name)
          H5Adelete removes the attribute specified by its name, name, from a dataset, group, or named datatype.
static boolean H5Aexists_by_name(int obj_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id)
          H5Aexists_by_name determines whether the attribute attr_name exists on an object.
static boolean H5Aexists(int obj_id, java.lang.String attr_name)
          H5Aexists determines whether the attribute attr_name exists on the object specified by obj_id.
static H5A_info_t H5Aget_info_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id)
          H5Aget_info_by_idx Retrieves attribute information, by attribute index position.
static H5A_info_t H5Aget_info_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int lapl_id)
          H5Aget_info_by_name Retrieves attribute information, by attribute name.
static H5A_info_t H5Aget_info(int attr_id)
          H5Aget_info retrieves attribute information, by attribute identifier.
static java.lang.String H5Aget_name_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int lapl_id)
          H5Aget_name_by_idx retrieves the name of an attribute that is attached to an object, which is specified by its location and name, loc_id and obj_name, respectively.
static long H5Aget_name(int attr_id, long buf_size, java.lang.String[] name)
          H5Aget_name retrieves the name of an attribute specified by the identifier, attr_id.
static long H5Aget_name(int attr_id, java.lang.String[] name)
           
static int H5Aget_num_attrs(int loc_id)
          Deprecated. As of HDF5 1.8, replaced by H5Oget_info( int )
static int H5Aget_space(int attr_id)
          H5Aget_space retrieves a copy of the dataspace for an attribute.
static long H5Aget_storage_size(int attr_id)
          H5Aget_storage_size returns the amount of storage that is required for the specified attribute, attr_id.
static int H5Aget_type(int attr_id)
          H5Aget_type retrieves a copy of the datatype for an attribute.
static int H5Aopen_by_idx(int loc_id, java.lang.String obj_name, int idx_type, int order, long n, int aapl_id, int lapl_id)
          H5Aopen_by_idx opens an existing attribute that is attached to an object specified by location and name, loc_id and obj_name, respectively
static int H5Aopen_by_name(int loc_id, java.lang.String obj_name, java.lang.String attr_name, int aapl_id, int lapl_id)
          H5Aopen_by_name Opens an attribute for an object by object name and attribute name
static int H5Aopen_idx(int loc_id, int idx)
          Deprecated. As of HDF5 1.8, replaced by H5Aopen_by_idx(int, String, int, int, long, int, int)
static int H5Aopen_name(int loc_id, java.lang.String name)
          Deprecated. As of HDF5 1.8, replaced by H5Aopen_by_name(int, String, String, int, int)
static int H5Aopen(int obj_id, java.lang.String attr_name, int aapl_id)
          H5Aopen opens an existing attribute, attr_name, that is attached to an object specified an object identifier, object_id.
static int H5Aread(int attr_id, int mem_type_id, byte[] buf)
          H5Aread reads an attribute, specified with attr_id.
static int H5Aread(int attr_id, int mem_type_id, java.lang.Object obj)
          H5Aread reads an attribute, specified with attr_id.
static int H5AreadVL(int attr_id, int mem_type_id, java.lang.String[] buf)
           
static int H5Arename_by_name(int loc_id, java.lang.String obj_name, java.lang.String old_attr_name, java.lang.String new_attr_name, int lapl_id)
          H5Arename_by_name changes the name of attribute that is attached to the object specified by loc_id and obj_name.
static int H5Awrite(int attr_id, int mem_type_id, byte[] buf)
          H5Awrite writes an attribute, specified with attr_id.
static int H5Awrite(int attr_id, int mem_type_id, java.lang.Object obj)
          H5Awrite writes an attribute, specified with attr_id.
static int H5check_version(int majnum, int minnum, int relnum)
          H5check_version verifies that the arguments match the version numbers compiled into the library.
static int H5close()
          H5close flushes all data to disk, closes all file identifiers, and cleans up all memory used by the library.
static int H5Dchdir_ext(java.lang.String dir_name)
           
static int H5Dclose(int dataset_id)
          H5Dclose ends access to a dataset specified by dataset_id and releases resources used by it.
static int H5Dcopy(int src_did, int dst_did)
          H5Dcopy copies the content of one dataset to another dataset.
static int H5Dcreate_anon(int loc_id, int type_id, int space_id, int dcpl_id, int dapl_id)
          H5Dcreate_anon creates a dataset in the file specified by loc_id.
static int H5Dcreate(int loc_id, java.lang.String name, int type_id, int space_id, int create_plist_id)
          Deprecated. As of HDF5 1.8, replaced by H5Dcreate(int, String, int, int, int, int, int)
static int H5Dcreate(int loc_id, java.lang.String name, int type_id, int space_id, int lcpl_id, int dcpl_id, int dapl_id)
          H5Dcreate creates a new dataset named name at the location specified by loc_id.
static int H5Dextend(int dataset_id, byte[] size)
          Deprecated. As of HDF5 1.8, replaced by H5Dset_extent(int, long[])
static int H5Dextend(int dataset_id, long[] size)
          Deprecated. As of HDF5 1.8, replaced by H5Dset_extent(int, long[])
static void H5Dfill(byte[] fill, int fill_type, byte[] buf, int buf_type, int space)
          H5Dfill explicitly fills the dataspace selection in memory, space_id, with the fill value specified in fill.
static int H5Dget_access_plist(int dset_id)
          H5Dget_access_plist returns an identifier for a copy of the dataset access property list for a dataset.
static int H5Dget_create_plist(int dataset_id)
          H5Dget_create_plist returns an identifier for a copy of the dataset creation property list for a dataset.
static long H5Dget_offset(int dset_id)
          H5Dget_offset returns the address in the file of the dataset dset_id.
static int H5Dget_space_status(int dset_id)
          H5Dget_space_status determines whether space has been allocated for the dataset dset_id.
static int H5Dget_space_status(int dset_id, int[] status)
          H5Dget_space_status determines whether space has been allocated for the dataset dset_id.
static int H5Dget_space(int dataset_id)
          H5Dget_space returns an identifier for a copy of the dataspace for a dataset.
static long H5Dget_storage_size(int dataset_id)
          H5Dget_storage_size returns the amount of storage that is required for the dataset.
static int H5Dget_type(int dataset_id)
          H5Dget_type returns an identifier for a copy of the datatype for a dataset.
static int H5Dgetdir_ext(java.lang.String[] dir_name, int size)
           
static int H5Dopen(int loc_id, java.lang.String name)
          Deprecated. As of HDF5 1.8, replaced by H5Dopen(int, String, int)
static int H5Dopen(int loc_id, java.lang.String name, int dapl_id)
          H5Dopen opens the existing dataset specified by a location identifier and name, loc_id and name, respectively.
static int H5Dread_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf)
           
static int H5Dread_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf, boolean isCriticalPinning)
           
static int H5Dread_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf)
           
static int H5Dread_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf, boolean isCriticalPinning)
           
static int H5Dread_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf)
           
static int H5Dread_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf, boolean isCriticalPinning)
           
static int H5Dread_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf)
           
static int H5Dread_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf, boolean isCriticalPinning)
           
static int H5Dread_reg_ref(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf)
           
static int H5Dread_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf)
           
static int H5Dread_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf, boolean isCriticalPinning)
           
static int H5Dread_string(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf)
           
static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf)
           
static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf, boolean isCriticalPinning)
          H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application memory buffer buf.
static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj)
           
static int H5Dread(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj, boolean isCriticalPinning)
          H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application data object.
static int H5DreadVL(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object[] buf)
           
static void H5Dset_extent(int dset_id, long[] size)
          H5Dset_extent sets the current dimensions of the chunked dataset dset_id to the sizes specified in size.
static long H5Dvlen_get_buf_size(int dset_id, int type_id, int space_id)
          H5Dvlen_get_buf_size determines the number of bytes required to store the VL data from the dataset, using the space_id for the selection in the dataset on disk and the type_id for the memory representation of the VL data in memory.
static int H5Dvlen_get_buf_size(int dataset_id, int type_id, int space_id, int[] size)
           
static int H5Dvlen_reclaim(int type_id, int space_id, int xfer_plist_id, byte[] buf)
           
static int H5Dwrite_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf)
           
static int H5Dwrite_double(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, double[] buf, boolean isCriticalPinning)
           
static int H5Dwrite_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf)
           
static int H5Dwrite_float(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, float[] buf, boolean isCriticalPinning)
           
static int H5Dwrite_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf)
           
static int H5Dwrite_int(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, int[] buf, boolean isCriticalPinning)
           
static int H5Dwrite_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf)
           
static int H5Dwrite_long(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, long[] buf, boolean isCriticalPinning)
           
static int H5Dwrite_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf)
           
static int H5Dwrite_short(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, short[] buf, boolean isCriticalPinning)
           
static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf)
           
static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, byte[] buf, boolean isCriticalPinning)
          H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file.
static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj)
           
static int H5Dwrite(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.Object obj, boolean isCriticalPinning)
          H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory data object into the file.
static int H5DwriteString(int dataset_id, int mem_type_id, int mem_space_id, int file_space_id, int xfer_plist_id, java.lang.String[] buf)
          H5DwriteString writes a (partial) variable length String dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file.
static boolean H5Eauto_is_v2(int err_stack)
          H5Eauto_is_v2 determines whether the error auto reporting function for an error stack conforms to the H5E_auto2_t typedef or the H5E_auto1_t typedef.
static int H5Eclear()
          H5Eclear clears the error stack for the current thread.
static void H5Eclear(int err_stack)
          H5Eclear clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.
static void H5Eclear2(int err_stack)
          H5Eclear2 clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.
static void H5Eclose_msg(int err_id)
          H5Eclose_msg closes an error message identifier, which can be either a major or minor message.
static void H5Eclose_stack(int stack_id)
          H5Eclose_stack closes the object handle for an error stack and releases its resources.
static int H5Ecreate_msg(int cls_id, int msg_type, java.lang.String msg)
          H5Ecreate_msg adds an error message to an error class defined by client library or application program.
static int H5Ecreate_stack()
          H5Ecreate_stack creates a new empty error stack and returns the new stack's identifier.
static java.lang.String H5Eget_class_name(int class_id)
          H5Eget_class_name retrieves the name of the error class specified by the class identifier.
static int H5Eget_current_stack()
          H5Eget_current_stack copies the current error stack and returns an error stack identifier for the new copy.
static java.lang.String H5Eget_msg(int msg_id, int[] type_list)
          H5Eget_msg retrieves the error message including its length and type.
static long H5Eget_num(int stack_id)
          H5Eget_num retrieves the number of error records in the error stack specified by estack_id (including major, minor messages and description).
static void H5Epop(int stack_id, long count)
          H5Epop deletes the number of error records specified in count from the top of the error stack specified by estack_id (including major, minor messages and description).
static void H5Eprint1(java.lang.Object stream)
          Deprecated. As of HDF5 1.8, replaced by H5Eprint2(int, Object)
static void H5Eprint2(int err_stack, java.lang.Object stream)
          H5Eprint2 prints the error stack specified by estack_id on the specified stream, stream.
static int H5Eregister_class(java.lang.String cls_name, java.lang.String lib_name, java.lang.String version)
          H5Eregister_class registers a client library or application program to the HDF5 error API so that the client library or application program can report errors together with HDF5 library.
static int H5error_off()
          Turn off error handling By default, the C library prints the error stack of the HDF-5 C library on stdout.
static void H5Eset_current_stack(int stack_id)
          H5Eset_current_stack replaces the content of the current error stack with a copy of the content of the error stack specified by estack_id.
static void H5Eunregister_class(int class_id)
          H5Eunregister_class removes the error class specified by class_id.
static int H5Fclose(int file_id)
          H5Fclose terminates access to an HDF5 file.
static int H5Fcreate(java.lang.String name, int flags, int create_id, int access_id)
          H5Fcreate is the primary function for creating HDF5 files.
static int H5Fflush(int object_id, int scope)
          H5Fflush causes all buffers associated with a file or object to be immediately flushed (written) to disk without removing the data from the (memory) cache.
static int H5Fget_access_plist(int file_id)
          H5Fget_access_plist returns the file access property list identifier of the specified file.
static int H5Fget_create_plist(int file_id)
          H5Fget_create_plist returns a file creation property list identifier identifying the creation properties used to create this file.
static long H5Fget_filesize(int file_id)
           
static long H5Fget_freespace(int file_id)
          H5Fget_freespace returns the amount of space that is unused by any objects in the file.
static int H5Fget_intent(int file_id)
          H5Fget_intent retrieves the intended access mode flag passed with H5Fopen when the file was opened.
static double H5Fget_mdc_hit_rate(int file_id)
          H5Fget_mdc_hit_rate queries the metadata cache of the target file to obtain its hit rate (cache hits / (cache hits + cache misses)) since the last time hit rate statistics were reset.
static int H5Fget_mdc_size(int file_id, long[] metadata_cache)
          H5Fget_mdc_size queries the metadata cache of the target file for the desired size information.
static java.lang.String H5Fget_name(int obj_id)
          H5Fget_name retrieves the name of the file to which the object obj_id belongs.
static java.lang.String H5Fget_name(int obj_id, int size)
           
static long H5Fget_obj_count_long(int file_id, int types)
          H5Fget_obj_count returns the number of open object identifiers for the file.
static int H5Fget_obj_count(int file_id, int types)
          H5Fget_obj_count returns the number of open object identifiers for the file.
static long H5Fget_obj_ids_long(int file_id, int types, long max_objs, int[] obj_id_list)
          H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.
static int H5Fget_obj_ids(int file_id, int types, int max, int[] obj_id_list)
          H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.
static boolean H5Fis_hdf5(java.lang.String name)
          H5Fis_hdf5 determines whether a file is in the HDF5 format.
static int H5Fmount(int loc_id, java.lang.String name, int child_id, int plist_id)
          H5Fmount mounts the file specified by child_id onto the group specified by loc_id and name using the mount properties plist_id.
static int H5Fopen(java.lang.String name, int flags, int access_id)
          H5Fopen opens an existing file and is the primary function for accessing existing HDF5 files.
static int H5Freopen(int file_id)
          H5Freopen reopens an HDF5 file.
static void H5Freset_mdc_hit_rate_stats(int file_id)
          H5Freset_mdc_hit_rate_stats resets the hit rate statistics counters in the metadata cache associated with the specified file.
static int H5Funmount(int loc_id, java.lang.String name)
          Given a mount point, H5Funmount dissassociates the mount point's file from the file mounted there.
static int H5garbage_collect()
          H5garbage_collect collects on all free-lists of all types.
static int H5Gclose(int group_id)
          H5Gclose releases resources used by a group which was opened by a call to H5Gcreate() or H5Gopen().
static int H5Gcreate_anon(int loc_id, int gcpl_id, int gapl_id)
          H5Gcreate_anon creates a new empty group in the file specified by loc_id.
static int H5Gcreate(int loc_id, java.lang.String name, int lcpl_id, int gcpl_id, int gapl_id)
          H5Gcreate creates a new group with the specified name at the specified location, loc_id.
static int H5Gcreate(int loc_id, java.lang.String name, long size_hint)
          Deprecated. As of HDF5 1.8, replaced by H5Gcreate(int, String, int, int, int)
static int H5get_libversion(int[] libversion)
          H5get_libversion retrieves the major, minor, and release numbers of the version of the HDF library which is linked to the application.
static int H5Gget_comment(int loc_id, java.lang.String name, int bufsize, java.lang.String[] comment)
          Deprecated. As of HDF5 1.8, replaced by H5Oget_comment(int)
static int H5Gget_create_plist(int group_id)
          H5Gget_create_plist returns an identifier for the group creation property list associated with the group specified by group_id.
static H5G_info_t H5Gget_info_by_idx(int group_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
          H5Gget_info_by_idx retrieves information about a group, according to the group's position within an index.
static H5G_info_t H5Gget_info_by_name(int group_id, java.lang.String name, int lapl_id)
          H5Gget_info_by_name retrieves information about the group group_name located in the file or group specified by loc_id.
static H5G_info_t H5Gget_info(int group_id)
          H5Gget_info retrieves information about the group specified by group_id.
static int H5Gget_linkval(int loc_id, java.lang.String name, int size, java.lang.String[] value)
          Deprecated. As of HDF5 1.8, replaced by H5Lget_val(int, String, String[] , int)
static int H5Gget_num_objs(int loc_id, long[] num_obj)
          Deprecated. As of HDF5 1.8, replaced by H5Gget_info(int)
static int H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, int[] ltype, long[] ref, int indx_type)
           
static int H5Gget_obj_info_all(int loc_id, java.lang.String name, java.lang.String[] oname, int[] otype, long[] ref)
          retrieves information of all objects under the group (name) located in the file or group specified by loc_id.
static int H5Gget_obj_info_idx(int loc_id, java.lang.String name, int idx, java.lang.String[] oname, int[] type)
          H5Gget_obj_info_idx report the name and type of object with index 'idx' in a Group.
static int H5Gget_obj_info_max(int loc_id, java.lang.String[] objNames, int[] objTypes, int[] lnkTypes, long[] ref, int objMax)
          retrieves information of all objects (recurvisely) under the group (name) located in the file or group specified by loc_id upto maximum specified by objMax.
static int H5Gget_objinfo(int loc_id, java.lang.String name, boolean follow_link, HDF5GroupInfo info)
          Deprecated. As of HDF5 1.8
static int H5Gget_objinfo(int loc_id, java.lang.String name, boolean follow_link, long[] fileno, long[] objno, int[] link_info, long[] mtime)
          Deprecated. As of HDF5 1.8, replaced by and #H5Oget_info(int)
static long H5Gget_objname_by_idx(int group_id, long idx, java.lang.String[] name, long size)
          Deprecated. As of HDF5 1.8, replaced by H5Lget_name_by_idx(int, String, int, int, long, int)
static int H5Gget_objtype_by_idx(int group_id, long idx)
          Deprecated. As of HDF5 1.8, replaced by H5Oget_info(int)
static int H5Glink(int loc_id, int link_type, java.lang.String current_name, java.lang.String new_name)
          Deprecated. As of HDF5 1.8, replaced by and #H5Lcreate_soft(String, int, String, int, int)
static int H5Glink2(int curr_loc_id, java.lang.String current_name, int link_type, int new_loc_id, java.lang.String new_name)
          Deprecated. As of HDF5 1.8
static int H5Gmove(int loc_id, java.lang.String src, java.lang.String dst)
          Deprecated. As of HDF5 1.8, replaced by H5Lmove(int, String, int,String, int, int)
static long H5Gn_members_long(int loc_id, java.lang.String name)
          H5Gn_members report the number of objects in a Group.
static int H5Gn_members(int loc_id, java.lang.String name)
          H5Gn_members report the number of objects in a Group.
static int H5Gopen(int loc_id, java.lang.String name)
          Deprecated. As of HDF5 1.8, replaced by H5Gopen(int, String, int)
static int H5Gopen(int loc_id, java.lang.String name, int gapl_id)
          H5Gopen opens an existing group, name, at the location specified by loc_id.
static int H5Gset_comment(int loc_id, java.lang.String name, java.lang.String comment)
          Deprecated. As of HDF5 1.8, replaced by H5Oset_comment(int, String)
static int H5Gunlink(int loc_id, java.lang.String name)
          Deprecated. As of HDF5 1.8, replaced by H5Ldelete(int, String, int)
static int H5Idec_ref(int obj_id)
           
static int H5Iget_file_id(int obj_id)
           
static long H5Iget_name(int obj_id, java.lang.String[] name, long size)
           
static int H5Iget_ref(int obj_id)
           
static int H5Iget_type_ref(int type)
          H5Iget_type_ref retrieves the reference count on an ID type.
static int H5Iget_type(int obj_id)
          H5Iget_type retrieves the type of the object identified by obj_id.
static int H5Iinc_ref(int obj_id)
           
static int H5INcreate(java.lang.String grp_name, int grp_loc_id, int property_list, int data_loc_id, java.lang.String data_loc_name, java.lang.String field_name, long max_mem_size)
           
static int H5Inmembers(int type)
          H5Inmembers returns the number of identifiers of the identifier type specified in type.
static int H5INquery(int dset_id, java.lang.String[] keys, java.lang.Object ubounds, java.lang.Object lbounds, int nkeys)
           
static void H5Lcopy(int src_loc, java.lang.String src_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id)
          H5Lcopy copies a link from one location to another.
static void H5Lcreate_external(java.lang.String file_name, java.lang.String obj_name, int link_loc_id, java.lang.String link_name, int lcpl_id, int lapl_id)
          H5Lcreate_external creates a new soft link to an external object, which is an object in a different HDF5 file from the location of the link.
static void H5Lcreate_hard(int cur_loc, java.lang.String cur_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id)
          H5Lcreate_hard creates a new hard link to a pre-existing object in an HDF5 file.
static void H5Lcreate_soft(java.lang.String link_target, int link_loc_id, java.lang.String link_name, int lcpl_id, int lapl_id)
          H5Lcreate_soft creates a new soft link to an object in an HDF5 file.
static void H5Ldelete_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
          H5Ldelete_by_idx removes the nth link in a group according to the specified order and in the specified index.
static void H5Ldelete(int loc_id, java.lang.String name, int lapl_id)
          H5Ldelete removes the link specified from a group.
static boolean H5Lexists(int loc_id, java.lang.String name, int lapl_id)
          H5Lexists checks if a link with a particular name exists in a group.
static H5L_info_t H5Lget_info_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
          H5Lget_info_by_idx opens a named datatype at the location specified by loc_id and return an identifier for the datatype.
static H5L_info_t H5Lget_info(int loc_id, java.lang.String name, int lapl_id)
          H5Lget_info returns information about the specified link.
static java.lang.String H5Lget_name_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
          H5Lget_name_by_idx retrieves name of the nth link in a group, according to the order within a specified field or index.
static int H5Lget_val_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, java.lang.String[] link_value, int lapl_id)
          H5Lget_val_by_idx retrieves value of the nth link in a group, according to the order within an index.
static int H5Lget_val(int loc_id, java.lang.String name, java.lang.String[] link_value, int lapl_id)
          H5Lget_val returns the link value of a symbolic link.
static int H5Literate_by_name(int loc_id, java.lang.String group_name, int idx_type, int order, long idx, H5L_iterate_cb op, H5L_iterate_t op_data, int lapl_id)
          H5Literate_by_name iterates through links in a group.
static int H5Literate(int grp_id, int idx_type, int order, long idx, H5L_iterate_cb op, H5L_iterate_t op_data)
          H5Literate iterates through links in a group.
static void H5Lmove(int src_loc, java.lang.String src_name, int dst_loc, java.lang.String dst_name, int lcpl_id, int lapl_id)
          H5Lmove renames a link within an HDF5 file.
static int H5Lvisit_by_name(int loc_id, java.lang.String group_name, int idx_type, int order, H5L_iterate_cb op, H5L_iterate_t op_data, int lapl_id)
          H5Lvisit_by_name recursively visits all links starting from a specified group.
static int H5Lvisit(int grp_id, int idx_type, int order, H5L_iterate_cb op, H5L_iterate_t op_data)
          H5Lvisit recursively visits all links starting from a specified group.
static int H5Oclose(int object_id)
          H5Oclose closes the group, dataset, or named datatype specified.
static void H5Ocopy(int src_loc_id, java.lang.String src_name, int dst_loc_id, java.lang.String dst_name, int ocpypl_id, int lcpl_id)
          H5Ocopy copies the group, dataset or named datatype specified from the file or group specified by source location to the destination location.
static java.lang.String H5Oget_comment_by_name(int loc_id, java.lang.String name, int lapl_id)
          H5Oget_comment_by_name retrieves the comment for an object.
static java.lang.String H5Oget_comment(int obj_id)
          H5Oget_comment retrieves the comment for the specified object.
static H5O_info_t H5Oget_info_by_idx(int loc_id, java.lang.String group_name, int idx_type, int order, long n, int lapl_id)
          H5Oget_info_by_idx retrieves the metadata for an object, identifying the object by an index position.
static H5O_info_t H5Oget_info_by_name(int loc_id, java.lang.String name, int lapl_id)
          H5Oget_info_by_name retrieves the metadata for an object, identifying the object by location and relative name.
static H5O_info_t H5Oget_info(int loc_id)
          H5Oget_info retrieves the metadata for an object specified by an identifier.
static void H5Olink(int obj_id, int new_loc_id, java.lang.String new_name, int lcpl_id, int lapl_id)
          H5Olink creates a new hard link to an object in an HDF5 file.
static int H5Oopen(int loc_id, java.lang.String name, int lapl_id)
          H5Oopen opens a group, dataset, or named datatype specified by a location and a path name.
static int H5open()
          H5open initialize the library.
static void H5Oset_comment_by_name(int loc_id, java.lang.String name, java.lang.String comment, int lapl_id)
          H5Oset_comment_by_name sets the comment for the specified object.
static void H5Oset_comment(int obj_id, java.lang.String comment)
          H5Oset_comment sets the comment for the specified object.
static int H5Ovisit_by_name(int loc_id, java.lang.String obj_name, int idx_type, int order, H5O_iterate_cb op, H5O_iterate_t op_data, int lapl_id)
          H5Ovisit_by_name recursively visits all objects starting from a specified object.
static int H5Ovisit(int obj_id, int idx_type, int order, H5O_iterate_cb op, H5O_iterate_t op_data)
          H5Ovisit recursively visits all objects accessible from a specified object.
static boolean H5Pall_filters_avail(int dcpl_id)
           
static int H5Pclose_class(int plid)
          Closes an existing property list class
static int H5Pclose(int plist)
          H5Pclose terminates access to a property list.
static int H5Pcopy_prop(int dst_id, int src_id, java.lang.String name)
          H5Pcopy_prop copies a property from one property list or class to another
static int H5Pcopy(int plist)
          H5Pcopy copies an existing property list to create a new property list.
static int H5Pcreate(int type)
          H5Pcreate creates a new property as an instance of some property list class.
static int H5Pequal(int plid1, int plid2)
          H5Pequal determines if two property lists or classes are equal
static int H5Pexist(int plid, java.lang.String name)
          H5Pexist determines whether a property exists within a property list or class
static int H5Pfill_value_defined(int plist_id, int[] status)
           
static int H5Pget_alignment(int plist, long[] alignment)
          H5Pget_alignment retrieves the current settings for alignment properties from a file access property list.
static int H5Pget_alloc_time(int plist_id, int[] alloc_time)
           
static int H5Pget_attr_creation_order(int ocpl_id)
          H5Pget_attr_creation_order retrieves the settings for tracking and indexing attribute creation order on an object
static int H5Pget_attr_phase_change(int ocpl_id, int[] attributes)
          H5Pget_attr_phase_change retrieves attribute storage phase change thresholds.
static int H5Pget_btree_ratios(int plist_id, double[] left, double[] middle, double[] right)
          H5Pget_btree_ratio Get the B-tree split ratios for a dataset transfer property list.
static int H5Pget_buffer(int plist, byte[] tconv, byte[] bkg)
          HH5Pget_buffer gets type conversion and background buffers.
static int H5Pget_cache(int plist, int[] mdc_nelmts, int[] rdcc_nelmts, int[] rdcc_nbytes, double[] rdcc_w0)
          Retrieves the maximum possible number of elements in the meta data cache and the maximum possible number of bytes and the RDCC_W0 value in the raw data chunk cache.
static int H5Pget_chunk(int plist, int max_ndims, long[] dims)
          H5Pget_chunk retrieves the size of chunks for the raw data of a chunked layout dataset.
static java.lang.String H5Pget_class_name(int plid)
          H5Pget_class_name retrieves the name of a generic property list class
static int H5Pget_class_parent(int plid)
          H5Pget_class_parent retrieves an identifier for the parent class of a property class
static int H5Pget_class(int plist)
          H5Pget_class returns the property list class for the property list identified by the plist parameter.
static int H5Pget_copy_object(int ocp_plist_id)
          H5Pget_copy_object retrieves the properties to be used when an object is copied.
static boolean H5Pget_create_intermediate_group(int lcpl_id)
          H5Pget_create_intermediate_group determines whether property is set to enable creating missing intermediate groups.
static long H5Pget_data_transform(int plist_id, java.lang.String[] expression, long size)
          H5Pget_data_transform retrieves the data transform expression previously set in the dataset transfer property list plist_id by H5Pset_data_transform.
static int H5Pget_edc_check(int plist)
           
static int H5Pget_elink_acc_flags(int lapl_id)
          H5Pget_elink_acc_flags retrieves the external link traversal file access flag from the specified link access property list.
static int H5Pget_elink_fapl(int lapl_id)
          H5Pget_elink_fapl Retrieves the file access property list identifier associated with the link access property list.
static long H5Pget_elink_prefix(int lapl_id, java.lang.String[] prefix)
          H5Pget_elink_prefix Retrieves prefix applied to external link paths.
static int H5Pget_est_link_info(int gcpl_id, int[] link_info)
          H5Pget_est_link_info Queries data required to estimate required local heap or object header size.
static int H5Pget_external_count(int plist)
          H5Pget_external_count returns the number of external files for the specified dataset.
static int H5Pget_external(int plist, int idx, int name_size, java.lang.String[] name, long[] size)
          H5Pget_external returns information about an external file.
static long H5Pget_family_offset(int fapl_id)
           
static int H5Pget_fapl_core(int fapl_id, int[] increment, boolean[] backing_store)
           
static int H5Pget_fapl_direct(int fapl_id, int[] info)
          H5Pget_fapl_direct Retrieve direct I/O settings.
static int H5Pget_fapl_family(int fapl_id, long[] memb_size, int[] memb_fapl_id)
           
static int H5Pget_fclose_degree(int plist_id)
           
static int H5Pget_fill_time(int plist_id, int[] fill_time)
           
static int H5Pget_fill_value(int plist_id, int type_id, byte[] value)
          H5Pget_fill_value queries the fill value property of a dataset creation property list.
static int H5Pget_fill_value(int plist_id, int type_id, java.lang.Object obj)
          H5Pget_fill_value queries the fill value property of a dataset creation property list.
static int H5Pget_filter_by_id(int plist_id, int filter, int[] flags, long[] cd_nelmts, int[] cd_values, long namelen, java.lang.String[] name)
           
static int H5Pget_filter(int plist, int filter_number, int[] flags, int[] cd_nelmts, int[] cd_values, int namelen, java.lang.String[] name)
          Deprecated. As of HDF5 1.8, replaced by H5Pget_filter(int, int, int[], int[], int[], int, String[], int[])
static int H5Pget_filter(int plist, int filter_number, int[] flags, int[] cd_nelmts, int[] cd_values, int namelen, java.lang.String[] name, int[] filter_config)
          H5Pget_filter returns information about a filter, specified by its filter number, in a filter pipeline, specified by the property list with which it is associated.
static int H5Pget_gc_reference(int fapl_id, boolean[] gc_ref)
           
static int H5Pget_gc_references(int fapl_id, boolean[] gc_ref)
          H5Pget_gc_references Returns the current setting for the garbage collection refernces property from a file access property list.
static int H5Pget_hyper_vector_size(int dxpl_id, long[] vector_size)
           
static int H5Pget_istore_k(int plist, int[] ik)
          H5Pget_istore_k queries the 1/2 rank of an indexed storage B-tree.
static int H5Pget_layout(int plist)
          H5Pget_layout returns the layout of the raw data for a dataset.
static int H5Pget_libver_bounds(int fapl_id, int[] libver)
          H5Pget_libver_bounds retrieves the lower and upper bounds on the HDF5 Library versions that indirectly determine the object formats versions used when creating objects in the file.
static int H5Pget_link_creation_order(int gcpl_id)
          H5Pget_link_creation_order queries the group creation property list, gcpl_id, and returns a flag indicating whether link creation order is tracked and/or indexed in a group.
static int H5Pget_link_phase_change(int gcpl_id, int[] links)
          H5Pget_link_phase_change Queries the settings for conversion between compact and dense groups.
static int H5Pget_local_heap_size_hint(int gcpl_id)
          H5Pget_local_heap_size_hint Retrieves the anticipated size of the local heap for original-style groups.
static int H5Pget_nfilters(int plist)
          H5Pget_nfilters returns the number of filters defined in the filter pipeline associated with the property list plist.
static long H5Pget_nlinks(int lapl_id)
          H5Pget_nlinks retrieves the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal.
static long H5Pget_nprops(int plid)
          H5Pget_nprops retrieves the number of properties in a property list or class
static int H5Pget_preserve(int plist)
          H5Pget_preserve checks the status of the dataset transfer property list.
static int H5Pget_shared_mesg_index(int fcpl_id, int index_num, int[] mesg_info)
          H5Pget_shared_mesg_index Retrieves the configuration settings for a shared message index.
static int H5Pget_shared_mesg_nindexes(int fcpl_id)
          H5Pget_shared_mesg_nindexes retrieves number of shared object header message indexes in file creation property list.
static int H5Pget_shared_mesg_phase_change(int fcpl_id, int[] size)
          H5Pget_shared_mesg_phase_change retrieves shared object header message phase change information.
static long H5Pget_size(int plid, java.lang.String name)
          H5Pget_size retrieves the size of a property's value in bytes
static int H5Pget_sizes(int plist, int[] size)
          H5Pget_sizes retrieves the size of the offsets and lengths used in an HDF5 file.
static int H5Pget_small_data_block_size(int plist, long[] size)
          H5Pget_small_data_block_size retrieves the size of a block of small data in a file creation property list.
static int H5Pget_sym_k(int plist, int[] size)
          H5Pget_sym_k retrieves the size of the symbol table B-tree 1/2 rank and the symbol table leaf node 1/2 size.
static int H5Pget_userblock(int plist, long[] size)
          H5Pget_userblock retrieves the size of a user block in a file creation property list.
static int H5Pget_version(int plist, int[] version_info)
          H5Pget_version retrieves the version information of various objects for a file creation property list.
static int H5Pget(int plid, java.lang.String name)
          H5Pget retrieves a copy of the value for a property in a property list (support integer only)
static int H5Pisa_class(int plist, int pclass)
          H5Pisa_class checks to determine whether a property list is a member of the specified class
static int H5Pmodify_filter(int plist, int filter, int flags, long cd_nelmts, int[] cd_values)
           
static int H5Premove_filter(int obj_id, int filter)
           
static int H5Premove(int plid, java.lang.String name)
          H5Premove removes a property from a property list
static int H5Pset_alignment(int plist, long threshold, long alignment)
          H5Pset_alignment sets the alignment properties of a file access property list so that any file object >= THRESHOLD bytes will be aligned on an address which is a multiple of ALIGNMENT.
static int H5Pset_alloc_time(int plist_id, int alloc_time)
           
static int H5Pset_attr_creation_order(int ocpl_id, int crt_order_flags)
          H5Pset_attr_creation_order sets flags specifying whether to track and index attribute creation order on an object.
static int H5Pset_btree_ratios(int plist_id, double left, double middle, double right)
          H5Pset_btree_ratio Sets B-tree split ratios for a dataset transfer property list.
static int H5Pset_buffer(int plist, int size, byte[] tconv, byte[] bkg)
          H5Pset_buffer sets type conversion and background buffers.
static int H5Pset_cache(int plist, int mdc_nelmts, int rdcc_nelmts, int rdcc_nbytes, double rdcc_w0)
          H5Pset_cache sets the number of elements (objects) in the meta data cache and the total number of bytes in the raw data chunk cache.
static int H5Pset_chunk(int plist, int ndims, byte[] dim)
          H5Pset_chunk sets the size of the chunks used to store a chunked layout dataset.
static int H5Pset_chunk(int plist, int ndims, long[] dim)
           
static void H5Pset_copy_object(int ocp_plist_id, int copy_options)
          H5Pset_copy_object Sets properties to be used when an object is copied.
static int H5Pset_create_intermediate_group(int lcpl_id, boolean crt_intermed_group)
          H5Pset_create_intermediate_group specifies in property list whether to create missing intermediate groups
static int H5Pset_data_transform(int plist_id, java.lang.String expression)
          H5Pset_data_transform sets a data transform expression
static int H5Pset_deflate(int plist, int level)
          H5Pset_deflate sets the compression method for a dataset.
static int H5Pset_edc_check(int plist, int check)
           
static int H5Pset_elink_acc_flags(int lapl_id, int flags)
          H5Pset_elink_acc_flags Sets the external link traversal file access flag in a link access property list.
static int H5Pset_elink_fapl(int lapl_id, int fapl_id)
          H5Pset_elink_fapl Sets a file access property list for use in accessing a file pointed to by an external link.
static int H5Pset_elink_prefix(int lapl_id, java.lang.String prefix)
          H5Pset_elink_prefix Sets prefix to be applied to external link paths.
static int H5Pset_est_link_info(int gcpl_id, int est_num_entries, int est_name_len)
          H5Pset_est_link_info Sets estimated number of links and length of link names in a group.
static int H5Pset_external(int plist, java.lang.String name, long offset, long size)
          H5Pset_external adds an external file to the list of external files.
static int H5Pset_family_offset(int fapl_id, long offset)
           
static int H5Pset_fapl_core(int fapl_id, int increment, boolean backing_store)
           
static int H5Pset_fapl_direct(int fapl_id, int alignment, int block_size, int cbuf_size)
          H5Pset_fapl_direct Sets up use of the direct I/O driver.
static int H5Pset_fapl_family(int fapl_id, long memb_size, int memb_fapl_id)
           
static int H5Pset_fapl_log(int fapl_id, java.lang.String logfile, int flags, int buf_size)
           
static int H5Pset_fclose_degree(int plist, int degree)
           
static int H5Pset_fill_time(int plist_id, int fill_time)
           
static int H5Pset_fill_value(int plist_id, int type_id, byte[] value)
          H5Pset_fill_value sets the fill value for a dataset creation property list.
static int H5Pset_fill_value(int plist_id, int type_id, java.lang.Object obj)
          H5Pset_fill_value sets the fill value for a dataset creation property list.
static int H5Pset_filter(int plist, int filter, int flags, int cd_nelmts, int[] cd_values)
          H5Pset_filter adds the specified filter and corresponding properties to the end of an output filter pipeline.
static int H5Pset_fletcher32(int plist)
           
static int H5Pset_gc_references(int fapl_id, boolean gc_ref)
          H5Pset_gc_references Sets the flag for garbage collecting references for the file.
static int H5Pset_hyper_vector_size(int dxpl_id, long vector_size)
           
static int H5Pset_istore_k(int plist, int ik)
          H5Pset_istore_k sets the size of the parameter used to control the B-trees for indexing chunked datasets.
static int H5Pset_layout(int plist, int layout)
          H5Pset_layout sets the type of storage used store the raw data for a dataset.
static int H5Pset_libver_bounds(int fapl_id, int low, int high)
          H5Pset_libver_bounds Sets bounds on library versions, and indirectly format versions, to be used when creating objects
static int H5Pset_link_creation_order(int gcpl_id, int crt_order_flags)
          H5Pset_link_creation_order Sets flags in a group creation property list, gcpl_id, for tracking and/or indexing links on creation order.
static int H5Pset_link_phase_change(int gcpl_id, int max_compact, int min_dense)
          H5Pset_link_phase_change Sets the parameters for conversion between compact and dense groups.
static int H5Pset_local_heap_size_hint(int gcpl_id, int size_hint)
          H5Pset_local_heap_size_hint Specifies the anticipated maximum size of a local heap.
static int H5Pset_nbit(int plist_id)
          H5Pset_nbit Sets up the use of the N-Bit filter.
static int H5Pset_nlinks(int lapl_id, long nlinks)
          H5Pset_nlinks sets the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal.
static int H5Pset_preserve(int plist, boolean status)
          H5Pset_preserve sets the dataset transfer property list status to TRUE or FALSE.
static int H5Pset_scaleoffset(int plist_id, int scale_type, int scale_factor)
          H5Pset_scaleoffset sets the Scale-Offset filter for a dataset.
static int H5Pset_shared_mesg_index(int fcpl_id, int index_num, int mesg_type_flags, int min_mesg_size)
          H5Pset_shared_mesg_index Configures the specified shared object header message index
static int H5Pset_shared_mesg_nindexes(int plist_id, int nindexes)
          H5Pset_shared_mesg_nindexes sets the number of shared object header message indexes in the specified file creation property list.
static int H5Pset_shared_mesg_phase_change(int fcpl_id, int max_list, int min_btree)
          H5Pset_shared_mesg_phase_change sets shared object header message storage phase change thresholds.
static int H5Pset_shuffle(int plist_id)
           
static int H5Pset_sizes(int plist, int sizeof_addr, int sizeof_size)
          H5Pset_sizes sets the byte size of the offsets and lengths used to address objects in an HDF5 file.
static int H5Pset_small_data_block_size(int plist, long size)
          H5Pset_small_data_block_size reserves blocks of size bytes for the contiguous storage of the raw data portion of small datasets.
static int H5Pset_sym_k(int plist, int ik, int lk)
          H5Pset_sym_k sets the size of parameters used to control the symbol table nodes.
static int H5Pset_szip(int plist, int options_mask, int pixels_per_block)
           
static int H5Pset_userblock(int plist, long size)
          H5Pset_userblock sets the user block size of a file creation property list.
static int H5Pset(int plid, java.lang.String name, int value)
          Sets a property list value (support integer only)
static int H5Punregister(int plid, java.lang.String name)
          H5Punregister removes a property from a property list class
static byte[] H5Rcreate(int loc_id, java.lang.String name, int ref_type, int space_id)
          H5Rcreate creates the reference, ref, of the type specified in ref_type, pointing to the object name located at loc_id.
static int H5Rdereference(int dataset, int ref_type, byte[] ref)
          Given a reference to some object, H5Rdereference opens that object and return an identifier.
static long H5Rget_name(int loc_id, int ref_type, byte[] ref, java.lang.String[] name, long size)
          H5Rget_name retrieves a name for the object identified by ref.
static int H5Rget_obj_type(int loc_id, int ref_type, byte[] ref)
          Deprecated. As of HDF5 1.8, replaced by H5Rget_obj_type(int, int, byte[], int[])
static int H5Rget_obj_type(int loc_id, int ref_type, byte[] ref, int[] obj_type)
          H5Rget_obj_type Given a reference to an object ref, H5Rget_obj_type returns the type of the object pointed to.
static int H5Rget_region(int loc_id, int ref_type, byte[] ref)
          Given a reference to an object ref, H5Rget_region creates a copy of the dataspace of the dataset pointed to and defines a selection in the copy which is the region pointed to.
static int H5Sclose(int space_id)
          H5Sclose releases a dataspace.
static int H5Scopy(int space_id)
          H5Scopy creates a new dataspace which is an exact copy of the dataspace identified by space_id.
static int H5Screate_simple(int rank, byte[] dims, byte[] maxdims)
          Deprecated. use H5Screate_simple(int rank, long[] dims, long[] maxdims)
static int H5Screate_simple(int rank, long[] dims, long[] maxdims)
          H5Screate_simple creates a new simple data space and opens it for access.
static int H5Screate(int type)
          H5Screate creates a new dataspace of a particular type.
static int H5Sdecode(byte[] buf)
          H5Sdecode reconstructs the HDF5 data space object and returns a new object handle for it.
static byte[] H5Sencode(int obj_id)
          H5Sencode converts a data space description into binary form in a buffer.
static int H5set_free_list_limits(int reg_global_lim, int reg_list_lim, int arr_global_lim, int arr_list_lim, int blk_global_lim, int blk_list_lim)
           
static int H5Sextent_copy(int dest_space_id, int source_space_id)
          H5Sextent_copy copies the extent from source_space_id to dest_space_id.
static boolean H5Sextent_equal(int first_space_id, int second_space_id)
          H5Sextent_equal determines whether the dataspace extents of two dataspaces, space1_id and space2_id, are equal.
static int H5Sget_select_bounds(int spaceid, long[] start, long[] end)
          H5Sget_select_bounds retrieves the coordinates of the bounding box containing the current selection and places them into user-supplied buffers.
static long H5Sget_select_elem_npoints(int spaceid)
          H5Sget_select_elem_npoints returns the number of element points in the current dataspace selection.
static int H5Sget_select_elem_pointlist(int spaceid, long startpoint, long numpoints, long[] buf)
          H5Sget_select_elem_pointlist returns an array of of element points in the current dataspace selection.
static int H5Sget_select_hyper_blocklist(int spaceid, long startblock, long numblocks, long[] buf)
          H5Sget_select_hyper_blocklist returns an array of hyperslab blocks.
static long H5Sget_select_hyper_nblocks(int spaceid)
          H5Sget_select_hyper_nblocks returns the number of hyperslab blocks in the current dataspace selection.
static long H5Sget_select_npoints(int space_id)
          H5Sget_select_npoints determines the number of elements in the current selection of a dataspace.
static int H5Sget_simple_extent_dims(int space_id, long[] dims, long[] maxdims)
          H5Sget_simple_extent_dims returns the size and maximum sizes of each dimension of a dataspace through the dims and maxdims parameters.
static int H5Sget_simple_extent_ndims(int space_id)
          H5Sget_simple_extent_ndims determines the dimensionality (or rank) of a dataspace.
static long H5Sget_simple_extent_npoints(int space_id)
          H5Sget_simple_extent_npoints determines the number of elements in a dataspace.
static int H5Sget_simple_extent_type(int space_id)
          H5Sget_simple_extent_type queries a dataspace to determine the current class of a dataspace.
static boolean H5Sis_simple(int space_id)
          H5Sis_simple determines whether a dataspace is a simple dataspace.
static int H5Soffset_simple(int space_id, byte[] offset)
          H5Soffset_simple sets the offset of a simple dataspace space_id.
static int H5Soffset_simple(int space_id, long[] offset)
           
static int H5Sselect_all(int space_id)
          H5Sselect_all selects the entire extent of the dataspace space_id.
static int H5Sselect_elements(int space_id, int op, int num_elements, long[][] coord2D)
          H5Sselect_elements selects array elements to be included in the selection for the space_id dataspace.
static int H5Sselect_hyperslab(int space_id, int op, byte[] start, byte[] stride, byte[] count, byte[] block)
          H5Sselect_hyperslab selects a hyperslab region to add to the current selected region for the dataspace specified by space_id.
static int H5Sselect_hyperslab(int space_id, int op, long[] start, long[] stride, long[] count, long[] block)
           
static int H5Sselect_none(int space_id)
          H5Sselect_none resets the selection region for the dataspace space_id to include no elements.
static boolean H5Sselect_valid(int space_id)
          H5Sselect_valid verifies that the selection for the dataspace.
static int H5Sset_extent_none(int space_id)
          H5Sset_extent_none removes the extent from a dataspace and sets the type to H5S_NONE.
static int H5Sset_extent_simple(int space_id, int rank, byte[] current_size, byte[] maximum_size)
           
static int H5Sset_extent_simple(int space_id, int rank, long[] current_size, long[] maximum_size)
          H5Sset_extent_simple sets or resets the size of an existing dataspace.
static int H5Tarray_create(int base, int rank, int[] dims, int[] perms)
          Deprecated. As of HDF5 1.8, replaced by H5Tarray_create(int, int, long[])
static int H5Tarray_create(int base_id, int ndims, long[] dim)
          H5Tarray_create creates a new array datatype object.
static int H5Tclose(int type_id)
          H5Tclose releases a datatype.
static void H5Tcommit_anon(int loc_id, int type_id, int tcpl_id, int tapl_id)
          H5Tcommit_anon commits a transient datatype (not immutable) to a file, turning it into a named datatype with the specified creation and property lists.
static int H5Tcommit(int loc_id, java.lang.String name, int type)
          Deprecated. As of HDF5 1.8, replaced by H5Tcommit(int, String, int, int, int, int)
static void H5Tcommit(int loc_id, java.lang.String name, int type_id, int lcpl_id, int tcpl_id, int tapl_id)
          H5Tcommit saves a transient datatype as an immutable named datatype in a file.
static int H5Tcommit1(int loc_id, java.lang.String name, int type)
           
static boolean H5Tcommitted(int type)
          H5Tcommitted queries a type to determine whether the type specified by the type identifier is a named type or a transient type.
static void H5Tcompiler_conv(int src_id, int dst_id)
          H5Tcompiler_conv finds out whether the library's conversion function from type src_id to type dst_id is a compiler (hard) conversion.
static void H5Tconvert(int src_id, int dst_id, long nelmts, byte[] buf, byte[] background, int plist_id)
          H5Tconvert converts nelmts elements from the type specified by the src_id identifier to type dst_id.
static int H5Tcopy(int type_id)
          H5Tcopy copies an existing datatype.
static int H5Tcreate(int dclass, int size)
          H5Tcreate creates a new dataype of the specified class with the specified number of bytes.
static int H5Tcreate(int type, long size)
          H5Tcreate creates a new dataype of the specified class with the specified number of bytes.
static int H5Tdecode(byte[] buf)
          H5Tdecode reconstructs the HDF5 data type object and returns a new object handle for it.
static boolean H5Tdetect_class(int type_id, int cls)
          H5Tdetect_class determines whether the datatype specified in dtype_id contains any datatypes of the datatype class specified in dtype_class.
static int H5Tencode(int obj_id, byte[] buf, long nalloc)
          H5Tencode converts a data type description into binary form in a buffer.
static int H5Tenum_create(int base_id)
          H5Tenum_create creates a new enumeration datatype based on the specified base datatype, parent_id, which must be an integer type.
static void H5Tenum_insert(int type, java.lang.String name, byte[] value)
          H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.
static int H5Tenum_insert(int type, java.lang.String name, int value)
           
static int H5Tenum_insert(int type, java.lang.String name, int[] value)
          H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.
static java.lang.String H5Tenum_nameof(int type, byte[] value, long size)
          H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.
static int H5Tenum_nameof(int type, int[] value, java.lang.String[] name, int size)
          H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.
static void H5Tenum_valueof(int type, java.lang.String name, byte[] value)
          H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.
static int H5Tenum_valueof(int type, java.lang.String name, int[] value)
          H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.
static boolean H5Tequal(int type_id1, int type_id2)
          H5Tequal determines whether two datatype identifiers refer to the same datatype.
static int H5Tget_array_dims(int dt, int[] dims, int[] perms)
          Deprecated. As of HDF5 1.8
static int H5Tget_array_dims(int type_id, long[] dims)
          H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.
static int H5Tget_array_dims(int type_id, long[] dims, int[] perm)
          Deprecated. As of HDF5 1.8, replaced by H5Tget_array_dims(int, long[])
static int H5Tget_array_dims2(int type_id, long[] dims)
          H5Tget_array_dims2 returns the sizes of the dimensions of the specified array datatype object.
static int H5Tget_array_ndims(int type_id)
          H5Tget_array_ndims returns the rank, the number of dimensions, of an array datatype object.
static java.lang.String H5Tget_class_name(int class_id)
          H5Tget_class_name returns the datatype class identifier.
static int H5Tget_class(int type_id)
          H5Tget_class returns the datatype class identifier.
static int H5Tget_create_plist(int type_id)
          H5Tget_create_plist returns a property list identifier for the datatype creation property list associated with the datatype specified by type_id.
static int H5Tget_cset(int type_id)
          H5Tget_cset retrieves the character set type of a string datatype.
static long H5Tget_ebias_long(int type_id)
          H5Tget_ebias retrieves the exponent bias of a floating-point type.
static int H5Tget_ebias(int type_id)
          H5Tget_ebias retrieves the exponent bias of a floating-point type.
static int H5Tget_fields(int type_id, int[] fields)
          H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.
static void H5Tget_fields(int type_id, long[] fields)
          H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.
static int H5Tget_inpad(int type_id)
          H5Tget_inpad retrieves the internal padding type for unused bits in floating-point datatypes.
static int H5Tget_member_class(int type_id, int membno)
          H5Tget_member_class returns the datatype of the specified member.
static int H5Tget_member_index(int type_id, java.lang.String field_name)
          H5Tget_member_index retrieves the index of a field of a compound datatype.
static java.lang.String H5Tget_member_name(int type_id, int field_idx)
          H5Tget_member_name retrieves the name of a field of a compound datatype or an element of an enumeration datatype.
static long H5Tget_member_offset(int type_id, int membno)
          H5Tget_member_offset returns the byte offset of the specified member of the compound datatype.
static int H5Tget_member_type(int type_id, int field_idx)
          H5Tget_member_type returns the datatype of the specified member.
static void H5Tget_member_value(int type_id, int membno, byte[] value)
          H5Tget_member_value returns the value of the enumeration datatype member memb_no.
static int H5Tget_member_value(int type_id, int membno, int[] value)
          H5Tget_member_value returns the value of the enumeration datatype member memb_no.
static int H5Tget_native_type(int tid)
          H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.
static int H5Tget_native_type(int tid, int direction)
          H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.
static int H5Tget_nmembers(int type_id)
          H5Tget_nmembers retrieves the number of fields a compound datatype has.
static int H5Tget_norm(int type_id)
          H5Tget_norm retrieves the mantissa normalization of a floating-point datatype.
static int H5Tget_offset(int type_id)
          H5Tget_offset retrieves the bit offset of the first significant bit.
static int H5Tget_order(int type_id)
          H5Tget_order returns the byte order of an atomic datatype.
static int H5Tget_pad(int type_id, int[] pad)
          H5Tget_pad retrieves the padding type of the least and most-significant bit padding.
static long H5Tget_precision_long(int type_id)
          H5Tget_precision returns the precision of an atomic datatype.
static int H5Tget_precision(int type_id)
          H5Tget_precision returns the precision of an atomic datatype.
static int H5Tget_sign(int type_id)
          H5Tget_sign retrieves the sign type for an integer type.
static long H5Tget_size_long(int type_id)
          H5Tget_size returns the size of a datatype in bytes.
static int H5Tget_size(int type_id)
          H5Tget_size returns the size of a datatype in bytes.
static int H5Tget_strpad(int type_id)
          H5Tget_strpad retrieves the string padding method for a string datatype.
static int H5Tget_super(int type)
          H5Tget_super returns the type from which TYPE is derived.
static java.lang.String H5Tget_tag(int type)
          H5Tget_tag returns the tag associated with datatype type_id.
static int H5Tinsert(int type_id, java.lang.String name, long offset, int field_id)
          H5Tinsert adds another member to the compound datatype type_id.
static boolean H5Tis_variable_str(int type_id)
          H5Tis_variable_str determines whether the datatype identified in type_id is a variable-length string.
static int H5Tlock(int type_id)
          H5Tlock locks the datatype specified by the type_id identifier, making it read-only and non-destrucible.
static int H5Topen(int loc_id, java.lang.String name)
          Deprecated. As of HDF5 1.8, replaced by H5Topen(int, String, int)
static int H5Topen(int loc_id, java.lang.String name, int tapl_id)
          H5Topen opens a named datatype at the location specified by loc_id and return an identifier for the datatype.
static int H5Tpack(int type_id)
          H5Tpack recursively removes padding from within a compound datatype to make it more efficient (space-wise) to store that data.
static int H5Tset_cset(int type_id, int cset)
          H5Tset_cset the character set to be used.
static int H5Tset_ebias(int type_id, int ebias)
          H5Tset_ebias sets the exponent bias of a floating-point type.
static void H5Tset_ebias(int type_id, long ebias)
          H5Tset_ebias sets the exponent bias of a floating-point type.
static int H5Tset_fields(int type_id, int spos, int epos, int esize, int mpos, int msize)
          H5Tset_fields sets the locations and sizes of the various floating point bit fields.
static void H5Tset_fields(int type_id, long spos, long epos, long esize, long mpos, long msize)
          H5Tset_fields sets the locations and sizes of the various floating point bit fields.
static int H5Tset_inpad(int type_id, int inpad)
          If any internal bits of a floating point type are unused (that is, those significant bits which are not part of the sign, exponent, or mantissa), then H5Tset_inpad will be filled according to the value of the padding value property inpad.
static int H5Tset_norm(int type_id, int norm)
          H5Tset_norm sets the mantissa normalization of a floating-point datatype.
static int H5Tset_offset(int type_id, int offset)
          H5Tset_offset sets the bit offset of the first significant bit.
static void H5Tset_offset(int type_id, long offset)
          H5Tset_offset sets the bit offset of the first significant bit.
static int H5Tset_order(int type_id, int order)
          H5Tset_order sets the byte ordering of an atomic datatype.
static int H5Tset_pad(int type_id, int lsb, int msb)
          H5Tset_pad sets the least and most-significant bits padding types.
static int H5Tset_precision(int type_id, int precision)
          H5Tset_precision sets the precision of an atomic datatype.
static void H5Tset_precision(int type_id, long precision)
          H5Tset_precision sets the precision of an atomic datatype.
static int H5Tset_sign(int type_id, int sign)
          H5Tset_sign sets the sign proprety for an integer type.
static int H5Tset_size(int type_id, int size)
          H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).
static void H5Tset_size(int type_id, long size)
          H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).
static int H5Tset_strpad(int type_id, int strpad)
          H5Tset_strpad defines the storage mechanism for the string.
static int H5Tset_tag(int type, java.lang.String tag)
          H5Tset_tag tags an opaque datatype type_id with a unique ASCII identifier tag.
static int H5Tvlen_create(int base_id)
          H5Tvlen_create creates a new variable-length (VL) dataype.
static int H5Zfilter_avail(int filter)
           
static int H5Zget_filter_info(int filter)
           
static int H5Zunregister(int filter)
           
static void loadH5Lib()
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

LIB_VERSION

public static final int[] LIB_VERSION
The version number of the HDF5 library:
LIB_VERSION[0]: The major version of the library.
LIB_VERSION[1]: The minor version of the library.
LIB_VERSION[2]: The release number of the library.
Make sure to update the verions number when a different library is used.


H5PATH_PROPERTY_KEY

public static final java.lang.String H5PATH_PROPERTY_KEY
See Also:
Constant Field Values

H5_LIBRARY_NAME_PROPERTY_KEY

public static final java.lang.String H5_LIBRARY_NAME_PROPERTY_KEY
See Also:
Constant Field Values

LOGGING_LEVEL

public static int LOGGING_LEVEL
logging level: 0 -- information, 1 -- warning message, 2 -- failure

Constructor Detail

H5

public H5()
Method Detail

loadH5Lib

public static void loadH5Lib()

H5error_off

public static int H5error_off()
Turn off error handling By default, the C library prints the error stack of the HDF-5 C library on stdout. This behavior may be disabled by calling H5error_off().


getOpenIDCount

public static final int getOpenIDCount()
Get number of open IDs.


getOpenID

public static final int getOpenID(int index)
Get the open ID at the specified index.

Parameters:
index - -- an index of the open ID.
Returns:
Returns the open ID at the specified index.

H5open

public static int H5open()
                  throws HDF5LibraryException
H5open initialize the library.

Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5close

public static int H5close()
                   throws HDF5LibraryException
H5close flushes all data to disk, closes all file identifiers, and cleans up all memory used by the library.

Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5get_libversion

public static int H5get_libversion(int[] libversion)
                            throws HDF5LibraryException
H5get_libversion retrieves the major, minor, and release numbers of the version of the HDF library which is linked to the application.

Parameters:
libversion - The version information of the HDF library.
      libversion[0] = The major version of the library.
      libversion[1] = The minor version of the library.
      libversion[2] = The release number of the library.
 
Returns:
a non-negative value if successful, along with the version information.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5check_version

public static int H5check_version(int majnum,
                                  int minnum,
                                  int relnum)
H5check_version verifies that the arguments match the version numbers compiled into the library.

Parameters:
majnum - The major version of the library.
minnum - The minor version of the library.
relnum - The release number of the library.
Returns:
a non-negative value if successful. Upon failure (when the versions do not match), this function causes the application to abort (i.e., crash) See C API function: herr_t H5check_version()

H5garbage_collect

public static int H5garbage_collect()
                             throws HDF5LibraryException
H5garbage_collect collects on all free-lists of all types.

Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eclear

public static int H5Eclear()
                    throws HDF5LibraryException
H5Eclear clears the error stack for the current thread. H5Eclear can fail if there are problems initializing the library.

This may be used by exception handlers to assure that the error condition in the HDF-5 library has been reset.

Returns:
Returns a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Acreate

@Deprecated
public static int H5Acreate(int loc_id,
                                       java.lang.String name,
                                       int type_id,
                                       int space_id,
                                       int create_plist)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Acreate( int, String, int, int, int, int)

H5Acreate creates an attribute which is attached to the object specified with loc_id.

Parameters:
loc_id - IN: Object (dataset, group, or named datatype) to be attached to.
name - IN: Name of attribute to create.
type_id - IN: Identifier of datatype for attribute.
space_id - IN: Identifier of dataspace for attribute.
create_plist - IN: Identifier of creation property list (currently not used).
Returns:
an attribute identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Aopen_name

@Deprecated
public static int H5Aopen_name(int loc_id,
                                          java.lang.String name)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Aopen_by_name(int, String, String, int, int)

H5Aopen_name opens an attribute specified by its name, name, which is attached to the object specified with loc_id.

Parameters:
loc_id - IN: Identifier of a group, dataset, or named datatype atttribute
name - IN: Attribute name.
Returns:
attribute identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Aopen_idx

@Deprecated
public static int H5Aopen_idx(int loc_id,
                                         int idx)
                       throws HDF5LibraryException
Deprecated. As of HDF5 1.8, replaced by H5Aopen_by_idx(int, String, int, int, long, int, int)

H5Aopen_idx opens an attribute which is attached to the object specified with loc_id. The location object may be either a group, dataset, or named datatype, all of which may have any sort of attribute.

Parameters:
loc_id - IN: Identifier of the group, dataset, or named datatype attribute
idx - IN: Index of the attribute to open.
Returns:
attribute identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Awrite

public static int H5Awrite(int attr_id,
                           int mem_type_id,
                           byte[] buf)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Awrite writes an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is written from buf to the file.

Parameters:
attr_id - IN: Identifier of an attribute to write.
mem_type_id - IN: Identifier of the attribute datatype (in memory).
buf - IN: Data to be written.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - data is null.

H5Awrite

public static int H5Awrite(int attr_id,
                           int mem_type_id,
                           java.lang.Object obj)
                    throws HDF5Exception,
                           java.lang.NullPointerException
H5Awrite writes an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is written from data object to the file.

Parameters:
attr_id - IN: Identifier of an attribute to write.
mem_type_id - IN: Identifier of the attribute datatype (in memory).
obj - IN: Data object to be written.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - data object is null. See public synchronized static native int H5Awrite(int attr_id, int mem_type_id, byte[] buf);
HDF5Exception

H5Acopy

public static int H5Acopy(int src_aid,
                          int dst_aid)
                   throws HDF5LibraryException
H5Acopy copies the content of one attribute to another.

Parameters:
src_aid - the identifier of the source attribute
dst_aid - the identifier of the destinaiton attribute
Throws:
HDF5LibraryException

H5Aread

public static int H5Aread(int attr_id,
                          int mem_type_id,
                          byte[] buf)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Aread reads an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is read into buf from the file.

Parameters:
attr_id - IN: Identifier of an attribute to read.
mem_type_id - IN: Identifier of the attribute datatype (in memory).
buf - IN: Buffer for data to be read.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - data buffer is null.

H5Aread

public static int H5Aread(int attr_id,
                          int mem_type_id,
                          java.lang.Object obj)
                   throws HDF5Exception,
                          java.lang.NullPointerException
H5Aread reads an attribute, specified with attr_id. The attribute's memory datatype is specified with mem_type_id. The entire attribute is read into data object from the file.

Parameters:
attr_id - IN: Identifier of an attribute to read.
mem_type_id - IN: Identifier of the attribute datatype (in memory).
obj - IN: Object for data to be read.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - data buffer is null. See public synchronized static native int H5Aread( )
HDF5Exception

H5AreadVL

public static int H5AreadVL(int attr_id,
                            int mem_type_id,
                            java.lang.String[] buf)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Aget_space

public static int H5Aget_space(int attr_id)
                        throws HDF5LibraryException
H5Aget_space retrieves a copy of the dataspace for an attribute.

Parameters:
attr_id - IN: Identifier of an attribute.
Returns:
attribute dataspace identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Aget_type

public static int H5Aget_type(int attr_id)
                       throws HDF5LibraryException
H5Aget_type retrieves a copy of the datatype for an attribute.

Parameters:
attr_id - IN: Identifier of an attribute.
Returns:
a datatype identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Aget_name

public static long H5Aget_name(int attr_id,
                               long buf_size,
                               java.lang.String[] name)
                        throws java.lang.ArrayIndexOutOfBoundsException,
                               java.lang.ArrayStoreException,
                               HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
H5Aget_name retrieves the name of an attribute specified by the identifier, attr_id.

Parameters:
attr_id - IN: Identifier of the attribute.
buf_size - IN: The size of the buffer to store the name in.
name - OUT: Buffer to store name in.
Returns:
the length of the attribute's name if successful.
Throws:
java.lang.ArrayIndexOutOfBoundsException - JNI error writing back array
java.lang.ArrayStoreException - JNI error writing back array
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.
java.lang.IllegalArgumentException - - bub_size <= 0.

H5Aget_name

public static long H5Aget_name(int attr_id,
                               java.lang.String[] name)
                        throws java.lang.ArrayIndexOutOfBoundsException,
                               java.lang.ArrayStoreException,
                               HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
Throws:
java.lang.ArrayIndexOutOfBoundsException
java.lang.ArrayStoreException
HDF5LibraryException
java.lang.NullPointerException
java.lang.IllegalArgumentException

H5Aget_num_attrs

@Deprecated
public static int H5Aget_num_attrs(int loc_id)
                            throws HDF5LibraryException
Deprecated. As of HDF5 1.8, replaced by H5Oget_info( int )

H5Aget_num_attrs returns the number of attributes attached to the object specified by its identifier, loc_id.

Parameters:
loc_id - IN: Identifier of a group, dataset, or named datatype.
Returns:
the number of attributes if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Adelete

public static int H5Adelete(int loc_id,
                            java.lang.String name)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Adelete removes the attribute specified by its name, name, from a dataset, group, or named datatype.

Parameters:
loc_id - IN: Identifier of the dataset, group, or named datatype.
name - IN: Name of the attribute to delete.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Aclose

public static int H5Aclose(int attr_id)
                    throws HDF5LibraryException
H5Aclose terminates access to the attribute specified by its identifier, attr_id.

Parameters:
attr_id - IN: Attribute to release access to.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dcreate

@Deprecated
public static int H5Dcreate(int loc_id,
                                       java.lang.String name,
                                       int type_id,
                                       int space_id,
                                       int create_plist_id)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Dcreate(int, String, int, int, int, int, int)

H5Dcreate creates a data set with a name, name, in the file or in the group specified by the identifier loc_id.

Parameters:
loc_id - Identifier of the file or group to create the dataset within.
name - The name of the dataset to create.
type_id - Identifier of the datatype to use when creating the dataset.
space_id - Identifier of the dataspace to use when creating the dataset.
create_plist_id - Identifier of the set creation property list.
Returns:
a dataset identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Dopen

@Deprecated
public static int H5Dopen(int loc_id,
                                     java.lang.String name)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Dopen(int, String, int)

H5Dopen opens the existing dataset specified by a location identifier and name, loc_id and name, respectively.

Parameters:
loc_id - IN: Location identifier
name - IN: Dataset name
Returns:
a dataset identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Dchdir_ext

public static int H5Dchdir_ext(java.lang.String dir_name)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dgetdir_ext

public static int H5Dgetdir_ext(java.lang.String[] dir_name,
                                int size)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dget_space

public static int H5Dget_space(int dataset_id)
                        throws HDF5LibraryException
H5Dget_space returns an identifier for a copy of the dataspace for a dataset.

Parameters:
dataset_id - Identifier of the dataset to query.
Returns:
a dataspace identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dget_type

public static int H5Dget_type(int dataset_id)
                       throws HDF5LibraryException
H5Dget_type returns an identifier for a copy of the datatype for a dataset.

Parameters:
dataset_id - Identifier of the dataset to query.
Returns:
a datatype identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dget_create_plist

public static int H5Dget_create_plist(int dataset_id)
                               throws HDF5LibraryException
H5Dget_create_plist returns an identifier for a copy of the dataset creation property list for a dataset.

Parameters:
dataset_id - Identifier of the dataset to query.
Returns:
a dataset creation property list identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dread

public static int H5Dread(int dataset_id,
                          int mem_type_id,
                          int mem_space_id,
                          int file_space_id,
                          int xfer_plist_id,
                          byte[] buf,
                          boolean isCriticalPinning)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application memory buffer buf.

Parameters:
dataset_id - Identifier of the dataset read from.
mem_type_id - Identifier of the memory datatype.
mem_space_id - Identifier of the memory dataspace.
file_space_id - Identifier of the dataset's dataspace in the file.
xfer_plist_id - Identifier of a transfer property list for this I/O operation.
buf - Buffer to store data read from the file.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - data buffer is null.

H5Dread

public static int H5Dread(int dataset_id,
                          int mem_type_id,
                          int mem_space_id,
                          int file_space_id,
                          int xfer_plist_id,
                          byte[] buf)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5DreadVL

public static int H5DreadVL(int dataset_id,
                            int mem_type_id,
                            int mem_space_id,
                            int file_space_id,
                            int xfer_plist_id,
                            java.lang.Object[] buf)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread

public static int H5Dread(int dataset_id,
                          int mem_type_id,
                          int mem_space_id,
                          int file_space_id,
                          int xfer_plist_id,
                          java.lang.Object obj,
                          boolean isCriticalPinning)
                   throws HDF5Exception,
                          HDF5LibraryException,
                          java.lang.NullPointerException
H5Dread reads a (partial) dataset, specified by its identifier dataset_id, from the file into the application data object.

Parameters:
dataset_id - Identifier of the dataset read from.
mem_type_id - Identifier of the memory datatype.
mem_space_id - Identifier of the memory dataspace.
file_space_id - Identifier of the dataset's dataspace in the file.
xfer_plist_id - Identifier of a transfer property list for this I/O operation.
obj - Object to store data read from the file.
Returns:
a non-negative value if successful
Throws:
HDF5Exception - - Failure in the data conversion.
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - data object is null.

H5Dread

public static int H5Dread(int dataset_id,
                          int mem_type_id,
                          int mem_space_id,
                          int file_space_id,
                          int xfer_plist_id,
                          java.lang.Object obj)
                   throws HDF5Exception,
                          HDF5LibraryException,
                          java.lang.NullPointerException
Throws:
HDF5Exception
HDF5LibraryException
java.lang.NullPointerException

H5DwriteString

public static int H5DwriteString(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 java.lang.String[] buf)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
H5DwriteString writes a (partial) variable length String dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file.

Parameters:
dataset_id - Identifier of the dataset read from.
mem_type_id - Identifier of the memory datatype.
mem_space_id - Identifier of the memory dataspace.
file_space_id - Identifier of the dataset's dataspace in the file.
xfer_plist_id - Identifier of a transfer property list for this I/O operation.
buf - Buffer with data to be written to the file.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Dwrite

public static int H5Dwrite(int dataset_id,
                           int mem_type_id,
                           int mem_space_id,
                           int file_space_id,
                           int xfer_plist_id,
                           byte[] buf,
                           boolean isCriticalPinning)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory buffer buf into the file.

Parameters:
dataset_id - Identifier of the dataset read from.
mem_type_id - Identifier of the memory datatype.
mem_space_id - Identifier of the memory dataspace.
file_space_id - Identifier of the dataset's dataspace in the file.
xfer_plist_id - Identifier of a transfer property list for this I/O operation.
buf - Buffer with data to be written to the file.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Dwrite

public static int H5Dwrite(int dataset_id,
                           int mem_type_id,
                           int mem_space_id,
                           int file_space_id,
                           int xfer_plist_id,
                           byte[] buf)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite

public static int H5Dwrite(int dataset_id,
                           int mem_type_id,
                           int mem_space_id,
                           int file_space_id,
                           int xfer_plist_id,
                           java.lang.Object obj,
                           boolean isCriticalPinning)
                    throws HDF5Exception,
                           HDF5LibraryException,
                           java.lang.NullPointerException
H5Dwrite writes a (partial) dataset, specified by its identifier dataset_id, from the application memory data object into the file.

Parameters:
dataset_id - Identifier of the dataset read from.
mem_type_id - Identifier of the memory datatype.
mem_space_id - Identifier of the memory dataspace.
file_space_id - Identifier of the dataset's dataspace in the file.
xfer_plist_id - Identifier of a transfer property list for this I/O operation.
obj - Object with data to be written to the file.
Returns:
a non-negative value if successful
Throws:
HDF5Exception - - Failure in the data conversion.
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - data object is null.

H5Dwrite

public static int H5Dwrite(int dataset_id,
                           int mem_type_id,
                           int mem_space_id,
                           int file_space_id,
                           int xfer_plist_id,
                           java.lang.Object obj)
                    throws HDF5Exception,
                           HDF5LibraryException,
                           java.lang.NullPointerException
Throws:
HDF5Exception
HDF5LibraryException
java.lang.NullPointerException

H5Dextend

@Deprecated
public static int H5Dextend(int dataset_id,
                                       byte[] size)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Dset_extent(int, long[])

H5Dextend verifies that the dataset is at least of size size.

Parameters:
dataset_id - IN: Identifier of the dataset.
size - IN: Array containing the new magnitude of each dimension.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size array is null.

H5Dextend

@Deprecated
public static int H5Dextend(int dataset_id,
                                       long[] size)
                     throws HDF5Exception,
                            java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Dset_extent(int, long[])

H5Dextend verifies that the dataset is at least of size size.

Parameters:
dataset_id - IN: Identifier of the dataset.
size - IN: Array containing the new magnitude of each dimension.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size array is null.
HDF5Exception

H5Dclose

public static int H5Dclose(int dataset_id)
                    throws HDF5LibraryException
H5Dclose ends access to a dataset specified by dataset_id and releases resources used by it.

Parameters:
dataset_id - Identifier of the dataset to finish access to.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dget_storage_size

public static long H5Dget_storage_size(int dataset_id)
                                throws HDF5LibraryException
H5Dget_storage_size returns the amount of storage that is required for the dataset.

Parameters:
dataset_id - Identifier of the dataset in question
Returns:
he amount of storage space allocated for the dataset.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dcopy

public static int H5Dcopy(int src_did,
                          int dst_did)
                   throws HDF5LibraryException
H5Dcopy copies the content of one dataset to another dataset.

Parameters:
src_did - the identifier of the source dataset
dst_did - the identifier of the destinaiton dataset
Throws:
HDF5LibraryException

H5Dvlen_get_buf_size

public static int H5Dvlen_get_buf_size(int dataset_id,
                                       int type_id,
                                       int space_id,
                                       int[] size)
                                throws HDF5LibraryException
Throws:
HDF5LibraryException

H5Dvlen_reclaim

public static int H5Dvlen_reclaim(int type_id,
                                  int space_id,
                                  int xfer_plist_id,
                                  byte[] buf)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Fopen

public static int H5Fopen(java.lang.String name,
                          int flags,
                          int access_id)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Fopen opens an existing file and is the primary function for accessing existing HDF5 files.

Parameters:
name - Name of the file to access.
flags - File access flags.
access_id - Identifier for the file access properties list.
Returns:
a file identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Fcreate

public static int H5Fcreate(java.lang.String name,
                            int flags,
                            int create_id,
                            int access_id)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Fcreate is the primary function for creating HDF5 files.

Parameters:
name - Name of the file to access.
flags - File access flags. Possible values include:
  • H5F_ACC_RDWR Allow read and write access to file.
  • H5F_ACC_RDONLY Allow read-only access to file.
  • H5F_ACC_TRUNC Truncate file, if it already exists, erasing all data previously stored in the file.
  • H5F_ACC_EXCL Fail if file already exists.
  • H5F_ACC_DEBUG Print debug information.
  • H5P_DEFAULT Apply default file access and creation properties.
create_id - File creation property list identifier, used when modifying default file meta-data. Use H5P_DEFAULT for default access properties.
access_id - File access property list identifier. If parallel file access is desired, this is a collective call according to the communicator stored in the access_id (not supported in Java). Use H5P_DEFAULT for default access properties.
Returns:
a file identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Fflush

public static int H5Fflush(int object_id,
                           int scope)
                    throws HDF5LibraryException
H5Fflush causes all buffers associated with a file or object to be immediately flushed (written) to disk without removing the data from the (memory) cache.

After this call completes, the file (or object) is in a consistent state and all data written to date is assured to be permanent.

Parameters:
object_id - Identifier of object used to identify the file. object_id can be any object associated with the file, including the file itself, a dataset, a group, an attribute, or a named data type.
scope - specifies the scope of the flushing action, in the case that the HDF-5 file is not a single physical file.

Valid values are:

  • H5F_SCOPE_GLOBAL Flushes the entire virtual file.
  • H5F_SCOPE_LOCAL Flushes only the specified file.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fis_hdf5

public static boolean H5Fis_hdf5(java.lang.String name)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
H5Fis_hdf5 determines whether a file is in the HDF5 format.

Parameters:
name - File name to check format.
Returns:
true if is HDF-5, false if not.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Fget_create_plist

public static int H5Fget_create_plist(int file_id)
                               throws HDF5LibraryException
H5Fget_create_plist returns a file creation property list identifier identifying the creation properties used to create this file.

Parameters:
file_id - Identifier of the file to get creation property list
Returns:
a file creation property list identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fget_access_plist

public static int H5Fget_access_plist(int file_id)
                               throws HDF5LibraryException
H5Fget_access_plist returns the file access property list identifier of the specified file.

Parameters:
file_id - Identifier of file to get access property list of
Returns:
a file access property list identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fclose

public static int H5Fclose(int file_id)
                    throws HDF5LibraryException
H5Fclose terminates access to an HDF5 file.

Parameters:
file_id - Identifier of a file to terminate access to.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fmount

public static int H5Fmount(int loc_id,
                           java.lang.String name,
                           int child_id,
                           int plist_id)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Fmount mounts the file specified by child_id onto the group specified by loc_id and name using the mount properties plist_id.

Parameters:
loc_id - The identifier for the group onto which the file specified by child_id is to be mounted.
name - The name of the group onto which the file specified by child_id is to be mounted.
child_id - The identifier of the file to be mounted.
plist_id - The identifier of the property list to be used.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Funmount

public static int H5Funmount(int loc_id,
                             java.lang.String name)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
Given a mount point, H5Funmount dissassociates the mount point's file from the file mounted there.

Parameters:
loc_id - The identifier for the location at which the specified file is to be unmounted.
name - The name of the file to be unmounted.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Freopen

public static int H5Freopen(int file_id)
                     throws HDF5LibraryException
H5Freopen reopens an HDF5 file.

Parameters:
file_id - Identifier of a file to terminate and reopen access to.
Returns:
a new file identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Gcreate

@Deprecated
public static int H5Gcreate(int loc_id,
                                       java.lang.String name,
                                       long size_hint)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Gcreate(int, String, int, int, int)

H5Gcreate creates a new group with the specified name at the specified location, loc_id.

Parameters:
loc_id - The file or group identifier.
name - The absolute or relative name of the new group.
size_hint - An optional parameter indicating the number of bytes to reserve for the names that will appear in the group.
Returns:
a valid group identifier for the open group if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gopen

@Deprecated
public static int H5Gopen(int loc_id,
                                     java.lang.String name)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Gopen(int, String, int)

H5Gopen opens an existing group with the specified name at the specified location, loc_id.

Parameters:
loc_id - File or group identifier within which group is to be open.
name - Name of group to open.
Returns:
a valid group identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gclose

public static int H5Gclose(int group_id)
                    throws HDF5LibraryException
H5Gclose releases resources used by a group which was opened by a call to H5Gcreate() or H5Gopen().

Parameters:
group_id - Group identifier to release.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Glink

@Deprecated
public static int H5Glink(int loc_id,
                                     int link_type,
                                     java.lang.String current_name,
                                     java.lang.String new_name)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by and #H5Lcreate_soft(String, int, String, int, int)

H5Glink creates a new name for an already existing object.

Parameters:
loc_id - File, group, dataset, or datatype identifier.
link_type - Link type. Possible values are:
  • H5G_LINK_HARD
  • H5G_LINK_SOFT.
current_name - A name of the existing object if link is a hard link. Can be anything for the soft link.
new_name - New name for the object.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - current_name or name is null.

H5Glink2

@Deprecated
public static int H5Glink2(int curr_loc_id,
                                      java.lang.String current_name,
                                      int link_type,
                                      int new_loc_id,
                                      java.lang.String new_name)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
Deprecated. As of HDF5 1.8

H5Glink creates a new name for an already existing object.

Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Gunlink

@Deprecated
public static int H5Gunlink(int loc_id,
                                       java.lang.String name)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Ldelete(int, String, int)

H5Gunlink removes an association between a name and an object.

Parameters:
loc_id - Identifier of the file containing the object.
name - Name of the object to unlink.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gmove

@Deprecated
public static int H5Gmove(int loc_id,
                                     java.lang.String src,
                                     java.lang.String dst)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Lmove(int, String, int,String, int, int)

H5Gmove renames an object within an HDF5 file. The original name, src, is unlinked from the group graph and the new name, dst, is inserted as an atomic operation. Both names are interpreted relative to loc_id, which is either a file or a group identifier.

Parameters:
loc_id - File or group identifier.
src - Object's original name.
dst - Object's new name.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - src or dst is null.

H5Gget_linkval

@Deprecated
public static int H5Gget_linkval(int loc_id,
                                            java.lang.String name,
                                            int size,
                                            java.lang.String[] value)
                          throws java.lang.ArrayIndexOutOfBoundsException,
                                 java.lang.ArrayStoreException,
                                 HDF5LibraryException,
                                 java.lang.NullPointerException,
                                 java.lang.IllegalArgumentException
Deprecated. As of HDF5 1.8, replaced by H5Lget_val(int, String, String[] , int)

H5Gget_linkval returns size characters of the link value through the value argument if loc_id (a file or group identifier) and name specify a symbolic link.

Parameters:
loc_id - IN: Identifier of the file, group, dataset, or datatype.
name - IN: Name of the object whose link value is to be checked.
size - IN: Maximum number of characters of value to be returned.
value - OUT: Link value.
Returns:
a non-negative value, with the link value in value, if successful.
Throws:
java.lang.ArrayIndexOutOfBoundsException - Copy back failed
java.lang.ArrayStoreException - Copy back failed
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.
java.lang.IllegalArgumentException - - size is invalid

H5Gset_comment

@Deprecated
public static int H5Gset_comment(int loc_id,
                                            java.lang.String name,
                                            java.lang.String comment)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Oset_comment(int, String)

H5Gset_comment sets the comment for the the object name to comment. Any previously existing comment is overwritten.

Parameters:
loc_id - IN: Identifier of the file, group, dataset, or datatype.
name - IN: Name of the object whose comment is to be set or reset.
comment - IN: The new comment.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name or comment is null.

H5Gget_comment

@Deprecated
public static int H5Gget_comment(int loc_id,
                                            java.lang.String name,
                                            int bufsize,
                                            java.lang.String[] comment)
                          throws java.lang.ArrayIndexOutOfBoundsException,
                                 java.lang.ArrayStoreException,
                                 HDF5LibraryException,
                                 java.lang.NullPointerException,
                                 java.lang.IllegalArgumentException
Deprecated. As of HDF5 1.8, replaced by H5Oget_comment(int)

H5Gget_comment retrieves the comment for the the object name. The comment is returned in the buffer comment.

Parameters:
loc_id - IN: Identifier of the file, group, dataset, or datatype.
name - IN: Name of the object whose comment is to be set or reset.
bufsize - IN: Anticipated size of the buffer required to hold comment.
comment - OUT: The comment.
Returns:
the number of characters in the comment, counting the null terminator, if successful
Throws:
java.lang.ArrayIndexOutOfBoundsException - - JNI error writing back data
java.lang.ArrayStoreException - - JNI error writing back data
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.
java.lang.IllegalArgumentException - - size < 1, comment is invalid.

H5Iget_type

public static int H5Iget_type(int obj_id)
                       throws HDF5LibraryException
H5Iget_type retrieves the type of the object identified by obj_id.

Parameters:
obj_id - IN: Object identifier whose type is to be determined.
Returns:
the object type if successful; otherwise H5I_BADID.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pcreate

public static int H5Pcreate(int type)
                     throws HDF5LibraryException
H5Pcreate creates a new property as an instance of some property list class.

Parameters:
type - IN: The type of property list to create.
Returns:
a property list identifier (plist) if successful; otherwise Fail (-1).
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pclose

public static int H5Pclose(int plist)
                    throws HDF5LibraryException
H5Pclose terminates access to a property list.

Parameters:
plist - IN: Identifier of the property list to terminate access to.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_class

public static int H5Pget_class(int plist)
                        throws HDF5LibraryException
H5Pget_class returns the property list class for the property list identified by the plist parameter.

Parameters:
plist - IN: Identifier of property list to query.
Returns:
a property list class if successful. Otherwise returns H5P_NO_CLASS (-1).
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pcopy

public static int H5Pcopy(int plist)
                   throws HDF5LibraryException
H5Pcopy copies an existing property list to create a new property list.

Parameters:
plist - IN: Identifier of property list to duplicate.
Returns:
a property list identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_version

public static int H5Pget_version(int plist,
                                 int[] version_info)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException,
                                 java.lang.IllegalArgumentException
H5Pget_version retrieves the version information of various objects for a file creation property list.

Parameters:
plist - IN: Identifier of the file creation property list.
version_info - OUT: version information.
      version_info[0] = boot  // boot block version number
      version_info[1] = freelist  // global freelist version
      version_info[2] = stab  // symbol tabl version number
      version_info[3] = shhdr  // hared object header version
 
Returns:
a non-negative value, with the values of version_info initialized, if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - version_info is null.
java.lang.IllegalArgumentException - - version_info is illegal.

H5Pset_userblock

public static int H5Pset_userblock(int plist,
                                   long size)
                            throws HDF5LibraryException
H5Pset_userblock sets the user block size of a file creation property list.

Parameters:
plist - IN: Identifier of property list to modify.
size - IN: Size of the user-block in bytes.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_userblock

public static int H5Pget_userblock(int plist,
                                   long[] size)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
H5Pget_userblock retrieves the size of a user block in a file creation property list.

Parameters:
plist - IN: Identifier for property list to query.
size - OUT: Pointer to location to return user-block size.
Returns:
a non-negative value and the size of the user block; if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.

H5Pset_small_data_block_size

public static int H5Pset_small_data_block_size(int plist,
                                               long size)
                                        throws HDF5LibraryException
H5Pset_small_data_block_size reserves blocks of size bytes for the contiguous storage of the raw data portion of small datasets.

Parameters:
plist - IN: Identifier of property list to modify.
size - IN: Size of the blocks in bytes.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_small_data_block_size

public static int H5Pget_small_data_block_size(int plist,
                                               long[] size)
                                        throws HDF5LibraryException,
                                               java.lang.NullPointerException
H5Pget_small_data_block_size retrieves the size of a block of small data in a file creation property list.

Parameters:
plist - IN: Identifier for property list to query.
size - OUT: Pointer to location to return block size.
Returns:
a non-negative value and the size of the user block; if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.

H5Pset_sizes

public static int H5Pset_sizes(int plist,
                               int sizeof_addr,
                               int sizeof_size)
                        throws HDF5LibraryException
H5Pset_sizes sets the byte size of the offsets and lengths used to address objects in an HDF5 file.

Parameters:
plist - IN: Identifier of property list to modify.
sizeof_addr - IN: Size of an object offset in bytes.
sizeof_size - IN: Size of an object length in bytes.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_sizes

public static int H5Pget_sizes(int plist,
                               int[] size)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
H5Pget_sizes retrieves the size of the offsets and lengths used in an HDF5 file. This function is only valid for file creation property lists.

Parameters:
plist - IN: Identifier of property list to query.
size - OUT: the size of the offsets and length.
      size[0] = sizeof_addr // offset size in bytes
      size[1] = sizeof_size // length size in bytes
 
Returns:
a non-negative value with the sizes initialized; if successful;
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.
java.lang.IllegalArgumentException - - size is invalid.

H5Pset_sym_k

public static int H5Pset_sym_k(int plist,
                               int ik,
                               int lk)
                        throws HDF5LibraryException
H5Pset_sym_k sets the size of parameters used to control the symbol table nodes.

Parameters:
plist - IN: Identifier for property list to query.
ik - IN: Symbol table tree rank.
lk - IN: Symbol table node size.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_sym_k

public static int H5Pget_sym_k(int plist,
                               int[] size)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
H5Pget_sym_k retrieves the size of the symbol table B-tree 1/2 rank and the symbol table leaf node 1/2 size.

Parameters:
plist - IN: Property list to query.
size - OUT: the symbol table's B-tree 1/2 rank and leaf node 1/2 size.
      size[0] = ik // the symbol table's B-tree 1/2 rank
      size[1] = lk // leaf node 1/2 size
 
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.
java.lang.IllegalArgumentException - - size is invalid.

H5Pset_istore_k

public static int H5Pset_istore_k(int plist,
                                  int ik)
                           throws HDF5LibraryException
H5Pset_istore_k sets the size of the parameter used to control the B-trees for indexing chunked datasets.

Parameters:
plist - IN: Identifier of property list to query.
ik - IN: 1/2 rank of chunked storage B-tree.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_istore_k

public static int H5Pget_istore_k(int plist,
                                  int[] ik)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Pget_istore_k queries the 1/2 rank of an indexed storage B-tree.

Parameters:
plist - IN: Identifier of property list to query.
ik - OUT: Pointer to location to return the chunked storage B-tree 1/2 rank.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - ik array is null.

H5Pset_layout

public static int H5Pset_layout(int plist,
                                int layout)
                         throws HDF5LibraryException
H5Pset_layout sets the type of storage used store the raw data for a dataset.

Parameters:
plist - IN: Identifier of property list to query.
layout - IN: Type of storage layout for raw data.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_layout

public static int H5Pget_layout(int plist)
                         throws HDF5LibraryException
H5Pget_layout returns the layout of the raw data for a dataset.

Parameters:
plist - IN: Identifier for property list to query.
Returns:
the layout type of a dataset creation property list if successful. Otherwise returns H5D_LAYOUT_ERROR (-1).
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_chunk

public static int H5Pset_chunk(int plist,
                               int ndims,
                               byte[] dim)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
H5Pset_chunk sets the size of the chunks used to store a chunked layout dataset.

Parameters:
plist - IN: Identifier for property list to query.
ndims - IN: The number of dimensions of each chunk.
dim - IN: An array containing the size of each chunk.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dims array is null.
java.lang.IllegalArgumentException - - dims <=0

H5Pset_chunk

public static int H5Pset_chunk(int plist,
                               int ndims,
                               long[] dim)
                        throws HDF5Exception,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
Throws:
HDF5Exception
java.lang.NullPointerException
java.lang.IllegalArgumentException

H5Pget_chunk

public static int H5Pget_chunk(int plist,
                               int max_ndims,
                               long[] dims)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
H5Pget_chunk retrieves the size of chunks for the raw data of a chunked layout dataset.

Parameters:
plist - IN: Identifier of property list to query.
max_ndims - IN: Size of the dims array.
dims - OUT: Array to store the chunk dimensions.
Returns:
chunk dimensionality successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dims array is null.
java.lang.IllegalArgumentException - - max_ndims <=0

H5Pset_alignment

public static int H5Pset_alignment(int plist,
                                   long threshold,
                                   long alignment)
                            throws HDF5LibraryException
H5Pset_alignment sets the alignment properties of a file access property list so that any file object >= THRESHOLD bytes will be aligned on an address which is a multiple of ALIGNMENT.

Parameters:
plist - IN: Identifier for a file access property list.
threshold - IN: Threshold value.
alignment - IN: Alignment value.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_alignment

public static int H5Pget_alignment(int plist,
                                   long[] alignment)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException,
                                   java.lang.IllegalArgumentException
H5Pget_alignment retrieves the current settings for alignment properties from a file access property list.

Parameters:
plist - IN: Identifier of a file access property list.
alignment - OUT: threshold value and alignment value.
      alignment[0] = threshold // threshold value
      alignment[1] = alignment // alignment value
 
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - aligment array is null.
java.lang.IllegalArgumentException - - aligment array is invalid.

H5Pset_external

public static int H5Pset_external(int plist,
                                  java.lang.String name,
                                  long offset,
                                  long size)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Pset_external adds an external file to the list of external files.

Parameters:
plist - IN: Identifier of a dataset creation property list.
name - IN: Name of an external file.
offset - IN: Offset, in bytes, from the beginning of the file to the location in the file where the data starts.
size - IN: Number of bytes reserved in the file for the data.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Pget_external_count

public static int H5Pget_external_count(int plist)
                                 throws HDF5LibraryException
H5Pget_external_count returns the number of external files for the specified dataset.

Parameters:
plist - IN: Identifier of a dataset creation property list.
Returns:
the number of external files if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_external

public static int H5Pget_external(int plist,
                                  int idx,
                                  int name_size,
                                  java.lang.String[] name,
                                  long[] size)
                           throws java.lang.ArrayIndexOutOfBoundsException,
                                  java.lang.ArrayStoreException,
                                  HDF5LibraryException,
                                  java.lang.NullPointerException,
                                  java.lang.IllegalArgumentException
H5Pget_external returns information about an external file.

Parameters:
plist - IN: Identifier of a dataset creation property list.
idx - IN: External file index.
name_size - IN: Maximum length of name array.
name - OUT: Name of the external file.
size - OUT: the offset value and the size of the external file data.
      size[0] = offset // a location to return an offset value
      size[1] = size // a location to return the size of
                // the external file data.
 
Returns:
a non-negative value if successful
Throws:
java.lang.ArrayIndexOutOfBoundsException - Fatal error on Copyback
java.lang.ArrayStoreException - Fatal error on Copyback
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name or size is null.
java.lang.IllegalArgumentException - - name_size <= 0 .

H5Pset_fill_value

public static int H5Pset_fill_value(int plist_id,
                                    int type_id,
                                    byte[] value)
                             throws HDF5Exception
H5Pset_fill_value sets the fill value for a dataset creation property list.

Parameters:
plist_id - IN: Property list identifier.
type_id - IN: The datatype identifier of value.
value - IN: The fill value.
Returns:
a non-negative value if successful
Throws:
HDF5Exception - - Error converting data array

H5Pset_fill_value

public static int H5Pset_fill_value(int plist_id,
                                    int type_id,
                                    java.lang.Object obj)
                             throws HDF5Exception
H5Pset_fill_value sets the fill value for a dataset creation property list.

Parameters:
plist_id - IN: Property list identifier.
type_id - IN: The datatype identifier of value.
obj - IN: The fill value.
Returns:
a non-negative value if successful
Throws:
HDF5Exception - - Error converting data array

H5Pget_fill_value

public static int H5Pget_fill_value(int plist_id,
                                    int type_id,
                                    byte[] value)
                             throws HDF5Exception
H5Pget_fill_value queries the fill value property of a dataset creation property list. NOT IMPLEMENTED YET

Parameters:
plist_id - IN: Property list identifier.
type_id - IN: The datatype identifier of value.
value - IN: The fill value.
Returns:
a non-negative value if successful
Throws:
HDF5Exception

H5Pget_fill_value

public static int H5Pget_fill_value(int plist_id,
                                    int type_id,
                                    java.lang.Object obj)
                             throws HDF5Exception
H5Pget_fill_value queries the fill value property of a dataset creation property list. NOT IMPLEMENTED YET

Parameters:
plist_id - IN: Property list identifier.
type_id - IN: The datatype identifier of value.
obj - IN: The fill value.
Returns:
a non-negative value if successful
Throws:
HDF5Exception

H5Pset_filter

public static int H5Pset_filter(int plist,
                                int filter,
                                int flags,
                                int cd_nelmts,
                                int[] cd_values)
                         throws HDF5LibraryException
H5Pset_filter adds the specified filter and corresponding properties to the end of an output filter pipeline.

Parameters:
plist - IN: Property list identifier.
filter - IN: Filter to be added to the pipeline.
flags - IN: Bit vector specifying certain general properties of the filter.
cd_nelmts - IN: Number of elements in cd_values
cd_values - IN: Auxiliary data for the filter.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_nfilters

public static int H5Pget_nfilters(int plist)
                           throws HDF5LibraryException
H5Pget_nfilters returns the number of filters defined in the filter pipeline associated with the property list plist.

Parameters:
plist - IN: Property list identifier.
Returns:
the number of filters in the pipeline if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_filter

@Deprecated
public static int H5Pget_filter(int plist,
                                           int filter_number,
                                           int[] flags,
                                           int[] cd_nelmts,
                                           int[] cd_values,
                                           int namelen,
                                           java.lang.String[] name)
                         throws java.lang.ArrayIndexOutOfBoundsException,
                                java.lang.ArrayStoreException,
                                HDF5LibraryException,
                                java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Pget_filter(int, int, int[], int[], int[], int, String[], int[])

H5Pget_filter returns information about a filter, specified by its filter number, in a filter pipeline, specified by the property list with which it is associated.

Parameters:
plist - IN: Property list identifier.
filter_number - IN: Sequence number within the filter pipeline of the filter for which information is sought.
flags - OUT: Bit vector specifying certain general properties of the filter.
cd_nelmts - IN/OUT: Number of elements in cd_values
cd_values - OUT: Auxiliary data for the filter.
namelen - IN: Anticipated number of characters in name.
name - OUT: Name of the filter.
Returns:
the filter identification number if successful. Otherwise returns H5Z_FILTER_ERROR (-1).
Throws:
java.lang.ArrayIndexOutOfBoundsException - Fatal error on Copyback
java.lang.ArrayStoreException - Fatal error on Copyback
java.lang.NullPointerException - - name or an array is null.
HDF5LibraryException

H5Pset_cache

public static int H5Pset_cache(int plist,
                               int mdc_nelmts,
                               int rdcc_nelmts,
                               int rdcc_nbytes,
                               double rdcc_w0)
                        throws HDF5LibraryException
H5Pset_cache sets the number of elements (objects) in the meta data cache and the total number of bytes in the raw data chunk cache.

Parameters:
plist - IN: Identifier of the file access property list.
mdc_nelmts - IN: Number of elements (objects) in the meta data cache.
rdcc_nbytes - IN: Total size of the raw data chunk cache, in bytes.
rdcc_w0 - IN: Preemption policy.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_cache

public static int H5Pget_cache(int plist,
                               int[] mdc_nelmts,
                               int[] rdcc_nelmts,
                               int[] rdcc_nbytes,
                               double[] rdcc_w0)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Retrieves the maximum possible number of elements in the meta data cache and the maximum possible number of bytes and the RDCC_W0 value in the raw data chunk cache.

Parameters:
plist - IN: Identifier of the file access property list.
mdc_nelmts - IN/OUT: Number of elements (objects) in the meta data cache.
rdcc_nbytes - IN/OUT: Total size of the raw data chunk cache, in bytes.
rdcc_w0 - IN/OUT: Preemption policy.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - an array is null.

H5Pset_buffer

public static int H5Pset_buffer(int plist,
                                int size,
                                byte[] tconv,
                                byte[] bkg)
                         throws HDF5LibraryException,
                                java.lang.IllegalArgumentException
H5Pset_buffer sets type conversion and background buffers. status to TRUE or FALSE. Given a dataset transfer property list, H5Pset_buffer sets the maximum size for the type conversion buffer and background buffer and optionally supplies pointers to application-allocated buffers. If the buffer size is smaller than the entire amount of data being transferred between the application and the file, and a type conversion buffer or background buffer is required, then strip mining will be used. Note that there are minimum size requirements for the buffer. Strip mining can only break the data up along the first dimension, so the buffer must be large enough to accommodate a complete slice that encompasses all of the remaining dimensions. For example, when strip mining a 100x200x300 hyperslab of a simple data space, the buffer must be large enough to hold 1x200x300 data elements. When strip mining a 100x200x300x150 hyperslab of a simple data space, the buffer must be large enough to hold 1x200x300x150 data elements. If tconv and/or bkg are null pointers, then buffers will be allocated and freed during the data transfer.

Parameters:
plist - Identifier for the dataset transfer property list.
size - Size, in bytes, of the type conversion and background buffers.
tconv - byte array of application-allocated type conversion buffer.
bkg - byte array of application-allocated background buffer.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - plist is invalid.

H5Pget_buffer

public static int H5Pget_buffer(int plist,
                                byte[] tconv,
                                byte[] bkg)
                         throws HDF5LibraryException,
                                java.lang.IllegalArgumentException
HH5Pget_buffer gets type conversion and background buffers. Returns buffer size, in bytes, if successful; otherwise 0 on failure.

Parameters:
plist - Identifier for the dataset transfer property list.
tconv - byte array of application-allocated type conversion buffer.
bkg - byte array of application-allocated background buffer.
Returns:
buffer size, in bytes, if successful; otherwise 0 on failure
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - plist is invalid.

H5Pset_preserve

public static int H5Pset_preserve(int plist,
                                  boolean status)
                           throws HDF5LibraryException,
                                  java.lang.IllegalArgumentException
H5Pset_preserve sets the dataset transfer property list status to TRUE or FALSE.

Parameters:
plist - IN: Identifier for the dataset transfer property list.
status - IN: Status of for the dataset transfer property list.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - plist is invalid.

H5Pget_preserve

public static int H5Pget_preserve(int plist)
                           throws HDF5LibraryException
H5Pget_preserve checks the status of the dataset transfer property list.

Parameters:
plist - IN: Identifier for the dataset transfer property list.
Returns:
TRUE or FALSE if successful; otherwise returns a negative value
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_deflate

public static int H5Pset_deflate(int plist,
                                 int level)
                          throws HDF5LibraryException
H5Pset_deflate sets the compression method for a dataset.

Parameters:
plist - IN: Identifier for the dataset creation property list.
level - IN: Compression level.
Returns:
non-negative if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_gc_references

public static int H5Pset_gc_references(int fapl_id,
                                       boolean gc_ref)
                                throws HDF5LibraryException
H5Pset_gc_references Sets the flag for garbage collecting references for the file. Default value for garbage collecting references is off.

Parameters:
fapl_id - IN File access property list
gc_ref - IN set GC on (true) or off (false)
Returns:
non-negative if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_gc_references

public static int H5Pget_gc_references(int fapl_id,
                                       boolean[] gc_ref)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Pget_gc_references Returns the current setting for the garbage collection refernces property from a file access property list.

Note: this routine changed name with HDF5.1.2.2. If using an earlier version, use 'configure --enable-hdf5_1_2_1' so this routine will link to the old name.

Parameters:
fapl_id - IN File access property list
gc_ref - OUT GC is on (true) or off (false)
Returns:
non-negative if succeed
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - array is null.

H5Pget_gc_reference

public static int H5Pget_gc_reference(int fapl_id,
                                      boolean[] gc_ref)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_btree_ratios

public static int H5Pset_btree_ratios(int plist_id,
                                      double left,
                                      double middle,
                                      double right)
                               throws HDF5LibraryException
H5Pset_btree_ratio Sets B-tree split ratios for a dataset transfer property list. The split ratios determine what percent of children go in the first node when a node splits.

Parameters:
plist_id - IN Dataset transfer property list
left - IN split ratio for leftmost nodes
right - IN split ratio for righttmost nodes
middle - IN split ratio for all other nodes
Returns:
non-negative if succeed
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_btree_ratios

public static int H5Pget_btree_ratios(int plist_id,
                                      double[] left,
                                      double[] middle,
                                      double[] right)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
H5Pget_btree_ratio Get the B-tree split ratios for a dataset transfer property list.

Parameters:
plist_id - IN Dataset transfer property list
left - OUT split ratio for leftmost nodes
right - OUT split ratio for righttmost nodes
middle - OUT split ratio for all other nodes
Returns:
non-negative if succeed
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - an input array is null.

H5Rcreate

public static byte[] H5Rcreate(int loc_id,
                               java.lang.String name,
                               int ref_type,
                               int space_id)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
H5Rcreate creates the reference, ref, of the type specified in ref_type, pointing to the object name located at loc_id.

Parameters:
loc_id - IN: Location identifier used to locate the object being pointed to.
name - IN: Name of object at location loc_id.
ref_type - IN: Type of reference.
space_id - IN: Dataspace identifier with selection.
Returns:
the reference (byte[]) if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - an input array is null.
java.lang.IllegalArgumentException - - an input array is invalid.

H5Rdereference

public static int H5Rdereference(int dataset,
                                 int ref_type,
                                 byte[] ref)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException,
                                 java.lang.IllegalArgumentException
Given a reference to some object, H5Rdereference opens that object and return an identifier.

Parameters:
dataset - IN: Dataset containing reference object.
ref_type - IN: The reference type of ref.
ref - IN: reference to an object
Returns:
valid identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - output array is null.
java.lang.IllegalArgumentException - - output array is invalid.

H5Rget_region

public static int H5Rget_region(int loc_id,
                                int ref_type,
                                byte[] ref)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException,
                                java.lang.IllegalArgumentException
Given a reference to an object ref, H5Rget_region creates a copy of the dataspace of the dataset pointed to and defines a selection in the copy which is the region pointed to.

Parameters:
loc_id - IN: loc_id of the reference object.
ref_type - IN: The reference type of ref.
ref - OUT: the reference to the object and region
Returns:
a valid identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - output array is null.
java.lang.IllegalArgumentException - - output array is invalid.

H5Rget_obj_type

@Deprecated
public static int H5Rget_obj_type(int loc_id,
                                             int ref_type,
                                             byte[] ref)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException,
                                  java.lang.IllegalArgumentException
Deprecated. As of HDF5 1.8, replaced by H5Rget_obj_type(int, int, byte[], int[])

Given a reference to an object ref, H5Rget_obj_type returns the type of the object pointed to.

Parameters:
loc_id - IN: loc_id of the reference object.
ref_type - IN: Type of reference to query. *
ref - IN: the reference
Returns:
a valid object type if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - array is null.
java.lang.IllegalArgumentException - - array is invalid.

H5Screate

public static int H5Screate(int type)
                     throws HDF5LibraryException
H5Screate creates a new dataspace of a particular type.

Parameters:
type - IN: The type of dataspace to be created.
Returns:
a dataspace identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Screate_simple

public static int H5Screate_simple(int rank,
                                   long[] dims,
                                   long[] maxdims)
                            throws HDF5Exception,
                                   java.lang.NullPointerException
H5Screate_simple creates a new simple data space and opens it for access.

Parameters:
rank - IN: Number of dimensions of dataspace.
dims - IN: An array of the size of each dimension.
maxdims - IN: An array of the maximum size of each dimension.
Returns:
a dataspace identifier
Throws:
HDF5Exception - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dims or maxdims is null.

_H5Screate_simple

public static int _H5Screate_simple(int rank,
                                    long[] dims,
                                    long[] maxdims)
                             throws HDF5Exception,
                                    java.lang.NullPointerException
Throws:
HDF5Exception
java.lang.NullPointerException

H5Screate_simple

@Deprecated
public static int H5Screate_simple(int rank,
                                              byte[] dims,
                                              byte[] maxdims)
                            throws HDF5Exception,
                                   java.lang.NullPointerException
Deprecated. use H5Screate_simple(int rank, long[] dims, long[] maxdims)

Throws:
HDF5Exception
java.lang.NullPointerException

H5Scopy

public static int H5Scopy(int space_id)
                   throws HDF5LibraryException
H5Scopy creates a new dataspace which is an exact copy of the dataspace identified by space_id.

Parameters:
space_id - Identifier of dataspace to copy.
Returns:
a dataspace identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sselect_elements

public static int H5Sselect_elements(int space_id,
                                     int op,
                                     int num_elements,
                                     long[][] coord2D)
                              throws HDF5Exception,
                                     HDF5LibraryException,
                                     java.lang.NullPointerException
H5Sselect_elements selects array elements to be included in the selection for the space_id dataspace.

Parameters:
space_id - Identifier of the dataspace.
op - operator specifying how the new selection is combined.
num_elements - Number of elements to be selected.
coord2D - A 2-dimensional array specifying the coordinates of the elements.
Returns:
a non-negative value if successful
Throws:
HDF5Exception - - Error in the data conversion
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - cord array is

H5Sselect_all

public static int H5Sselect_all(int space_id)
                         throws HDF5LibraryException
H5Sselect_all selects the entire extent of the dataspace space_id.

Parameters:
space_id - IN: The identifier of the dataspace to be selected.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sselect_none

public static int H5Sselect_none(int space_id)
                          throws HDF5LibraryException
H5Sselect_none resets the selection region for the dataspace space_id to include no elements.

Parameters:
space_id - IN: The identifier of the dataspace to be reset.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sselect_valid

public static boolean H5Sselect_valid(int space_id)
                               throws HDF5LibraryException
H5Sselect_valid verifies that the selection for the dataspace.

Parameters:
space_id - The identifier for the dataspace in which the selection is being reset.
Returns:
true if the selection is contained within the extent and FALSE if it is not or is an error.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sget_simple_extent_npoints

public static long H5Sget_simple_extent_npoints(int space_id)
                                         throws HDF5LibraryException
H5Sget_simple_extent_npoints determines the number of elements in a dataspace.

Parameters:
space_id - ID of the dataspace object to query
Returns:
the number of elements in the dataspace if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sget_select_npoints

public static long H5Sget_select_npoints(int space_id)
                                  throws HDF5LibraryException
H5Sget_select_npoints determines the number of elements in the current selection of a dataspace.

Parameters:
space_id - IN: Identifier of the dataspace object to query
Returns:
the number of elements in the selection if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sget_simple_extent_ndims

public static int H5Sget_simple_extent_ndims(int space_id)
                                      throws HDF5LibraryException
H5Sget_simple_extent_ndims determines the dimensionality (or rank) of a dataspace.

Parameters:
space_id - IN: Identifier of the dataspace
Returns:
the number of dimensions in the dataspace if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sget_simple_extent_dims

public static int H5Sget_simple_extent_dims(int space_id,
                                            long[] dims,
                                            long[] maxdims)
                                     throws HDF5LibraryException,
                                            java.lang.NullPointerException
H5Sget_simple_extent_dims returns the size and maximum sizes of each dimension of a dataspace through the dims and maxdims parameters.

Parameters:
space_id - IN: Identifier of the dataspace object to query
dims - OUT: Pointer to array to store the size of each dimension.
maxdims - OUT: Pointer to array to store the maximum size of each dimension.
Returns:
the number of dimensions in the dataspace if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dims or maxdims is null.

H5Sget_simple_extent_type

public static int H5Sget_simple_extent_type(int space_id)
                                     throws HDF5LibraryException
H5Sget_simple_extent_type queries a dataspace to determine the current class of a dataspace.

Parameters:
space_id - Dataspace identifier.
Returns:
a dataspace class name if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sset_extent_simple

public static int H5Sset_extent_simple(int space_id,
                                       int rank,
                                       long[] current_size,
                                       long[] maximum_size)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Sset_extent_simple sets or resets the size of an existing dataspace.

Parameters:
space_id - Dataspace identifier.
rank - Rank, or dimensionality, of the dataspace.
current_size - Array containing current size of dataspace.
maximum_size - Array containing maximum size of dataspace.
Returns:
a dataspace identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException

H5Sset_extent_simple

public static int H5Sset_extent_simple(int space_id,
                                       int rank,
                                       byte[] current_size,
                                       byte[] maximum_size)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Sis_simple

public static boolean H5Sis_simple(int space_id)
                            throws HDF5LibraryException
H5Sis_simple determines whether a dataspace is a simple dataspace.

Parameters:
space_id - Identifier of the dataspace to query
Returns:
true if is a simple dataspace
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Soffset_simple

public static int H5Soffset_simple(int space_id,
                                   byte[] offset)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
H5Soffset_simple sets the offset of a simple dataspace space_id.

Parameters:
space_id - IN: The identifier for the dataspace object to reset.
offset - IN: The offset at which to position the selection.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - offset array is null.

H5Soffset_simple

public static int H5Soffset_simple(int space_id,
                                   long[] offset)
                            throws HDF5Exception,
                                   java.lang.NullPointerException
Throws:
HDF5Exception
java.lang.NullPointerException

H5Sextent_copy

public static int H5Sextent_copy(int dest_space_id,
                                 int source_space_id)
                          throws HDF5LibraryException
H5Sextent_copy copies the extent from source_space_id to dest_space_id. This action may change the type of the dataspace.

Parameters:
dest_space_id - IN: The identifier for the dataspace from which the extent is copied.
source_space_id - IN: The identifier for the dataspace to which the extent is copied.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sset_extent_none

public static int H5Sset_extent_none(int space_id)
                              throws HDF5LibraryException
H5Sset_extent_none removes the extent from a dataspace and sets the type to H5S_NONE.

Parameters:
space_id - The identifier for the dataspace from which the extent is to be removed.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sselect_hyperslab

public static int H5Sselect_hyperslab(int space_id,
                                      int op,
                                      byte[] start,
                                      byte[] stride,
                                      byte[] count,
                                      byte[] block)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException,
                                      java.lang.IllegalArgumentException
H5Sselect_hyperslab selects a hyperslab region to add to the current selected region for the dataspace specified by space_id. The start, stride, count, and block arrays must be the same size as the rank of the dataspace.

Parameters:
space_id - IN: Identifier of dataspace selection to modify
op - IN: Operation to perform on current selection.
start - IN: Offset of start of hyperslab
stride - IN: Hyperslab stride.
count - IN: Number of blocks included in hyperslab.
block - IN: Size of block in hyperslab.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - an input array is null.
java.lang.NullPointerException - - an input array is invalid.
java.lang.IllegalArgumentException

H5Sselect_hyperslab

public static int H5Sselect_hyperslab(int space_id,
                                      int op,
                                      long[] start,
                                      long[] stride,
                                      long[] count,
                                      long[] block)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException,
                                      java.lang.IllegalArgumentException
Throws:
HDF5LibraryException
java.lang.NullPointerException
java.lang.IllegalArgumentException

H5Sclose

public static int H5Sclose(int space_id)
                    throws HDF5LibraryException
H5Sclose releases a dataspace.

Parameters:
space_id - Identifier of dataspace to release.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sget_select_hyper_nblocks

public static long H5Sget_select_hyper_nblocks(int spaceid)
                                        throws HDF5LibraryException
H5Sget_select_hyper_nblocks returns the number of hyperslab blocks in the current dataspace selection.

Parameters:
spaceid - Identifier of dataspace to release.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sget_select_elem_npoints

public static long H5Sget_select_elem_npoints(int spaceid)
                                       throws HDF5LibraryException
H5Sget_select_elem_npoints returns the number of element points in the current dataspace selection.

Parameters:
spaceid - Identifier of dataspace to release.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sget_select_hyper_blocklist

public static int H5Sget_select_hyper_blocklist(int spaceid,
                                                long startblock,
                                                long numblocks,
                                                long[] buf)
                                         throws HDF5LibraryException,
                                                java.lang.NullPointerException
H5Sget_select_hyper_blocklist returns an array of hyperslab blocks. The block coordinates have the same dimensionality (rank) as the dataspace they are located within. The list of blocks is formatted as follows:
    <"start" coordinate>, immediately followed by
    <"opposite" corner coordinate>, followed by
   the next "start" and "opposite" coordinates,
   etc.
   until all of the selected blocks have been listed.
 

Parameters:
spaceid - Identifier of dataspace to release.
startblock - first block to retrieve
numblocks - number of blocks to retrieve
buf - returns blocks startblock to startblock+num-1, each block is rank * 2 (corners) longs.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Sget_select_elem_pointlist

public static int H5Sget_select_elem_pointlist(int spaceid,
                                               long startpoint,
                                               long numpoints,
                                               long[] buf)
                                        throws HDF5LibraryException,
                                               java.lang.NullPointerException
H5Sget_select_elem_pointlist returns an array of of element points in the current dataspace selection. The point coordinates have the same dimensionality (rank) as the dataspace they are located within, one coordinate per point.

Parameters:
spaceid - Identifier of dataspace to release.
startpoint - first point to retrieve
numpoints - number of points to retrieve
buf - returns points startblock to startblock+num-1, each points is rank longs.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Sget_select_bounds

public static int H5Sget_select_bounds(int spaceid,
                                       long[] start,
                                       long[] end)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Sget_select_bounds retrieves the coordinates of the bounding box containing the current selection and places them into user-supplied buffers.

The start and end buffers must be large enough to hold the dataspace rank number of coordinates.

Parameters:
spaceid - Identifier of dataspace to release.
start - coordinates of lowest corner of bounding box.
end - coordinates of highest corner of bounding box.
Returns:
a non-negative value if successful,with start and end initialized.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - start or end is null.

H5Topen

@Deprecated
public static int H5Topen(int loc_id,
                                     java.lang.String name)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Topen(int, String, int)

H5Topen opens a named datatype at the location specified by loc_id and return an identifier for the datatype.

Parameters:
loc_id - IN: A file, group, or datatype identifier.
name - IN: A datatype name, defined within the file or group identified by loc_id.
Returns:
a named datatype identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tcommit

@Deprecated
public static int H5Tcommit(int loc_id,
                                       java.lang.String name,
                                       int type)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Tcommit(int, String, int, int, int, int)

H5Tcommit commits a transient datatype (not immutable) to a file, turned it into a named datatype.

Parameters:
loc_id - IN: Location identifier.
name - IN: Name given to committed datatype.
type_id - IN: Identifier of datatype to be committed.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tcommit1

public static int H5Tcommit1(int loc_id,
                             java.lang.String name,
                             int type)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Tcommitted

public static boolean H5Tcommitted(int type)
                            throws HDF5LibraryException
H5Tcommitted queries a type to determine whether the type specified by the type identifier is a named type or a transient type.

Parameters:
type_id - IN: Identifier of datatype.
Returns:
true the datatype has been committed
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tcreate

public static int H5Tcreate(int dclass,
                            int size)
                     throws HDF5LibraryException
H5Tcreate creates a new dataype of the specified class with the specified number of bytes.

Parameters:
type - IN: Class of datatype to create.
size - IN: The number of bytes in the datatype to create.
Returns:
datatype identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tcopy

public static int H5Tcopy(int type_id)
                   throws HDF5LibraryException
H5Tcopy copies an existing datatype. The returned type is always transient and unlocked.

Parameters:
type_id - IN: Identifier of datatype to copy. Can be a datatype identifier, a predefined datatype (defined in H5Tpublic.h), or a dataset Identifier.
Returns:
a datatype identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tequal

public static boolean H5Tequal(int type_id1,
                               int type_id2)
                        throws HDF5LibraryException
H5Tequal determines whether two datatype identifiers refer to the same datatype.

Parameters:
type_id1 - IN: Identifier of datatype to compare.
type_id2 - IN: Identifier of datatype to compare.
Returns:
true if the datatype identifiers refer to the same datatype, else false.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tlock

public static int H5Tlock(int type_id)
                   throws HDF5LibraryException
H5Tlock locks the datatype specified by the type_id identifier, making it read-only and non-destrucible.

Parameters:
type_id - IN: Identifier of datatype to lock.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_class

public static int H5Tget_class(int type_id)
                        throws HDF5LibraryException
H5Tget_class returns the datatype class identifier.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
datatype class identifier if successful; otherwise H5T_NO_CLASS(-1).
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_class_name

public static java.lang.String H5Tget_class_name(int class_id)
H5Tget_class_name returns the datatype class identifier.

Parameters:
class_id - IN: Identifier of class from H5Tget_class.
Returns:
class name if successful; otherwise H5T_NO_CLASS.

H5Tget_size

public static int H5Tget_size(int type_id)
                       throws HDF5LibraryException
H5Tget_size returns the size of a datatype in bytes.

Parameters:
type_id - Identifier of datatype to query.
Returns:
the size of the datatype in bytes if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_size

public static int H5Tset_size(int type_id,
                              int size)
                       throws HDF5LibraryException
H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).

Parameters:
type_id - Identifier of datatype to change size.
size - Size in bytes to modify datatype.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_order

public static int H5Tget_order(int type_id)
                        throws HDF5LibraryException
H5Tget_order returns the byte order of an atomic datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
a byte order constant if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_order

public static int H5Tset_order(int type_id,
                               int order)
                        throws HDF5LibraryException
H5Tset_order sets the byte ordering of an atomic datatype.

Parameters:
type_id - IN: Identifier of datatype to set.
order - IN: Byte ordering constant.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_precision

public static int H5Tget_precision(int type_id)
                            throws HDF5LibraryException
H5Tget_precision returns the precision of an atomic datatype.

Parameters:
type_id - Identifier of datatype to query.
Returns:
the number of significant bits if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_precision

public static int H5Tset_precision(int type_id,
                                   int precision)
                            throws HDF5LibraryException
H5Tset_precision sets the precision of an atomic datatype.

Parameters:
type_id - Identifier of datatype to set.
precision - Number of bits of precision for datatype.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_offset

public static int H5Tget_offset(int type_id)
                         throws HDF5LibraryException
H5Tget_offset retrieves the bit offset of the first significant bit.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
a positive offset value if successful; otherwise 0.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_offset

public static int H5Tset_offset(int type_id,
                                int offset)
                         throws HDF5LibraryException
H5Tset_offset sets the bit offset of the first significant bit.

Parameters:
type_id - Identifier of datatype to set.
offset - Offset of first significant bit.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_pad

public static int H5Tget_pad(int type_id,
                             int[] pad)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
H5Tget_pad retrieves the padding type of the least and most-significant bit padding.

Parameters:
type_id - IN: Identifier of datatype to query.
pad - OUT: locations to return least-significant and most-significant bit padding type.
      pad[0] = lsb // least-significant bit padding type
      pad[1] = msb // most-significant bit padding type
 
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - pad is null.

H5Tset_pad

public static int H5Tset_pad(int type_id,
                             int lsb,
                             int msb)
                      throws HDF5LibraryException
H5Tset_pad sets the least and most-significant bits padding types.

Parameters:
type_id - IN: Identifier of datatype to set.
lsb - IN: Padding type for least-significant bits.
msb - IN: Padding type for most-significant bits.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_sign

public static int H5Tget_sign(int type_id)
                       throws HDF5LibraryException
H5Tget_sign retrieves the sign type for an integer type.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
a valid sign type if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_sign

public static int H5Tset_sign(int type_id,
                              int sign)
                       throws HDF5LibraryException
H5Tset_sign sets the sign proprety for an integer type.

Parameters:
type_id - IN: Identifier of datatype to set.
sign - IN: Sign type.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_fields

public static int H5Tget_fields(int type_id,
                                int[] fields)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException,
                                java.lang.IllegalArgumentException
H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
fields - OUT: location of size and bit-position.
      fields[0] = spos  OUT: location to return size of in bits.
      fields[1] = epos  OUT: location to return exponent bit-position.
      fields[2] = esize OUT: location to return size of exponent in bits.
      fields[3] = mpos  OUT: location to return mantissa bit-position.
      fields[4] = msize OUT: location to return size of mantissa in bits.
 
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - fields is null.
java.lang.IllegalArgumentException - - fields array is invalid.

H5Tset_fields

public static int H5Tset_fields(int type_id,
                                int spos,
                                int epos,
                                int esize,
                                int mpos,
                                int msize)
                         throws HDF5LibraryException
H5Tset_fields sets the locations and sizes of the various floating point bit fields.

Parameters:
type_id - Identifier of datatype to set.
spos - Size position.
epos - Exponent bit position.
esize - Size of exponent in bits.
mpos - Mantissa bit position.
msize - Size of mantissa in bits.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_ebias

public static int H5Tget_ebias(int type_id)
                        throws HDF5LibraryException
H5Tget_ebias retrieves the exponent bias of a floating-point type.

Parameters:
type_id - Identifier of datatype to query.
Returns:
the bias if successful; otherwise 0.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_ebias

public static int H5Tset_ebias(int type_id,
                               int ebias)
                        throws HDF5LibraryException
H5Tset_ebias sets the exponent bias of a floating-point type.

Parameters:
type_id - Identifier of datatype to set.
ebias - Exponent bias value.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_norm

public static int H5Tget_norm(int type_id)
                       throws HDF5LibraryException
H5Tget_norm retrieves the mantissa normalization of a floating-point datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
a valid normalization type if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_norm

public static int H5Tset_norm(int type_id,
                              int norm)
                       throws HDF5LibraryException
H5Tset_norm sets the mantissa normalization of a floating-point datatype.

Parameters:
type_id - IN: Identifier of datatype to set.
norm - IN: Mantissa normalization type.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_inpad

public static int H5Tget_inpad(int type_id)
                        throws HDF5LibraryException
H5Tget_inpad retrieves the internal padding type for unused bits in floating-point datatypes.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
a valid padding type if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_inpad

public static int H5Tset_inpad(int type_id,
                               int inpad)
                        throws HDF5LibraryException
If any internal bits of a floating point type are unused (that is, those significant bits which are not part of the sign, exponent, or mantissa), then H5Tset_inpad will be filled according to the value of the padding value property inpad.

Parameters:
type_id - IN: Identifier of datatype to modify.
inpad - IN: Padding type.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_cset

public static int H5Tget_cset(int type_id)
                       throws HDF5LibraryException
H5Tget_cset retrieves the character set type of a string datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
a valid character set type if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_cset

public static int H5Tset_cset(int type_id,
                              int cset)
                       throws HDF5LibraryException
H5Tset_cset the character set to be used.

Parameters:
type_id - IN: Identifier of datatype to modify.
cset - IN: Character set type.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_strpad

public static int H5Tget_strpad(int type_id)
                         throws HDF5LibraryException
H5Tget_strpad retrieves the string padding method for a string datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
a valid string padding type if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_strpad

public static int H5Tset_strpad(int type_id,
                                int strpad)
                         throws HDF5LibraryException
H5Tset_strpad defines the storage mechanism for the string.

Parameters:
type_id - IN: Identifier of datatype to modify.
strpad - IN: String padding type.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_nmembers

public static int H5Tget_nmembers(int type_id)
                           throws HDF5LibraryException
H5Tget_nmembers retrieves the number of fields a compound datatype has.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
number of members datatype has if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_member_name

public static java.lang.String H5Tget_member_name(int type_id,
                                                  int field_idx)
H5Tget_member_name retrieves the name of a field of a compound datatype or an element of an enumeration datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
field_idx - IN: Field index (0-based) of the field name to retrieve.
Returns:
a valid pointer to the name if successful; otherwise null.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_member_index

public static int H5Tget_member_index(int type_id,
                                      java.lang.String field_name)
H5Tget_member_index retrieves the index of a field of a compound datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
field_name - IN: Field name of the field index to retrieve.
Returns:
if field is defined, the index; else negative.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_member_class

public static int H5Tget_member_class(int type_id,
                                      int membno)
                               throws HDF5LibraryException
H5Tget_member_class returns the datatype of the specified member.

Parameters:
type_id - IN: Datatype identifier of compound object.
membno - IN: Compound object member number.
Returns:
the identifier of a copy of the datatype of the field if successful;
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_member_type

public static int H5Tget_member_type(int type_id,
                                     int field_idx)
                              throws HDF5LibraryException
H5Tget_member_type returns the datatype of the specified member.

Parameters:
type_id - IN: Identifier of datatype to query.
field_idx - IN: Field index (0-based) of the field type to retrieve.
Returns:
the identifier of a copy of the datatype of the field if successful;
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_member_offset

public static long H5Tget_member_offset(int type_id,
                                        int membno)
                                 throws HDF5LibraryException
H5Tget_member_offset returns the byte offset of the specified member of the compound datatype. This is the byte offset in the HDF-5 file/library, NOT the offset of any Java object which might be mapped to this data item.

Parameters:
type_id - IN: Identifier of datatype to query.
membno - IN: Field index (0-based) of the field type to retrieve.
Returns:
the offset of the member.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tinsert

public static int H5Tinsert(int type_id,
                            java.lang.String name,
                            long offset,
                            int field_id)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Tinsert adds another member to the compound datatype type_id.

Parameters:
type_id - IN: Identifier of compound datatype to modify.
name - IN: Name of the field to insert.
offset - IN: Offset in memory structure of the field to insert.
field_id - IN: Datatype identifier of the field to insert.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tpack

public static int H5Tpack(int type_id)
                   throws HDF5LibraryException
H5Tpack recursively removes padding from within a compound datatype to make it more efficient (space-wise) to store that data.

WARNING: This call only affects the C-data, even if it succeeds, there may be no visible effect on Java objects.

Parameters:
type_id - IN: Identifier of datatype to modify.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tclose

public static int H5Tclose(int type_id)
                    throws HDF5LibraryException
H5Tclose releases a datatype.

Parameters:
type_id - IN: Identifier of datatype to release.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tenum_create

public static int H5Tenum_create(int base_id)
                          throws HDF5LibraryException
H5Tenum_create creates a new enumeration datatype based on the specified base datatype, parent_id, which must be an integer type.

Parameters:
base_id - IN: Identifier of the parent datatype to release.
Returns:
the datatype identifier for the new enumeration datatype
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tenum_insert

public static int H5Tenum_insert(int type,
                                 java.lang.String name,
                                 int[] value)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.

Parameters:
type - IN: Identifier of datatype.
name - IN: The name of the member
value - IN: The value of the member, data of the correct type
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tenum_insert

public static int H5Tenum_insert(int type,
                                 java.lang.String name,
                                 int value)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Tenum_nameof

public static int H5Tenum_nameof(int type,
                                 int[] value,
                                 java.lang.String[] name,
                                 int size)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.

Parameters:
type - IN: Identifier of datatype.
value - IN: The value of the member, data of the correct
name - OUT: The name of the member
size - IN: The max length of the name
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tenum_valueof

public static int H5Tenum_valueof(int type,
                                  java.lang.String name,
                                  int[] value)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.

Parameters:
type - IN: Identifier of datatype.
name - IN: The name of the member
value - OUT: The value of the member
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tvlen_create

public static int H5Tvlen_create(int base_id)
                          throws HDF5LibraryException
H5Tvlen_create creates a new variable-length (VL) dataype.

Parameters:
base_id - IN: Identifier of parent datatype.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_tag

public static int H5Tset_tag(int type,
                             java.lang.String tag)
                      throws HDF5LibraryException
H5Tset_tag tags an opaque datatype type_id with a unique ASCII identifier tag.

Parameters:
type - IN: Datatype identifier for the opaque datatype to be tagged.
tag - IN: Descriptive ASCII string with which the opaque datatype is to be tagged.
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_tag

public static java.lang.String H5Tget_tag(int type)
                                   throws HDF5LibraryException
H5Tget_tag returns the tag associated with datatype type_id.

Parameters:
type - IN: Identifier of datatype.
Returns:
the tag
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_super

public static int H5Tget_super(int type)
                        throws HDF5LibraryException
H5Tget_super returns the type from which TYPE is derived.

Parameters:
type - IN: Identifier of datatype.
Returns:
the parent type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_member_value

public static int H5Tget_member_value(int type_id,
                                      int membno,
                                      int[] value)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
H5Tget_member_value returns the value of the enumeration datatype member memb_no.

Parameters:
type_id - IN: Identifier of datatype.
membno - IN: The name of the member
value - OUT: The value of the member
Returns:
a non-negative value if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - value is null.

H5Tarray_create

@Deprecated
public static int H5Tarray_create(int base,
                                             int rank,
                                             int[] dims,
                                             int[] perms)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Tarray_create(int, int, long[])

H5Tarray_create creates a new array datatype object.

Parameters:
base - IN: Datatype identifier for the array base datatype.
rank - IN: Rank of the array.
dims - IN: Size of each array dimension.
perms - IN: Dimension permutation. (Currently not implemented.)
Returns:
a valid datatype identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dims is null.

H5Tget_array_ndims

public static int H5Tget_array_ndims(int type_id)
                              throws HDF5LibraryException
H5Tget_array_ndims returns the rank, the number of dimensions, of an array datatype object.

Parameters:
type_id - IN: Datatype identifier of array object.
Returns:
the rank of the array
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_array_dims

@Deprecated
public static int H5Tget_array_dims(int dt,
                                               int[] dims,
                                               int[] perms)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
Deprecated. As of HDF5 1.8

H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.

Parameters:
type_id - IN: Datatype identifier of array object.
dims - OUT: Sizes of array dimensions.
perm[] - OUT: Dimension permutations. (This parameter is not used.)
Returns:
the non-negative number of dimensions of the array type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dims is null.

H5Gget_num_objs

@Deprecated
public static int H5Gget_num_objs(int loc_id,
                                             long[] num_obj)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Gget_info(int)

Returns number of objects in the group specified by its identifier

Parameters:
loc_id - Identifier of the group or the file
num_obj - Number of objects in the group
Returns:
positive value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Gget_objname_by_idx

@Deprecated
public static long H5Gget_objname_by_idx(int group_id,
                                                    long idx,
                                                    java.lang.String[] name,
                                                    long size)
                                  throws HDF5LibraryException,
                                         java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Lget_name_by_idx(int, String, int, int, long, int)

Returns a name of an object specified by an index.

Parameters:
group_id - Group or file identifier
idx - Transient index identifying object
name - the object name
size - Name length
Returns:
the size of the object name if successful, or 0 if no name is associated with the group identifier. Otherwise returns a negative value
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Gget_objtype_by_idx

@Deprecated
public static int H5Gget_objtype_by_idx(int group_id,
                                                   long idx)
                                 throws HDF5LibraryException,
                                        java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Oget_info(int)

Returns the type of an object specified by an index.

Parameters:
group_id - Group or file identifier.
idx - Transient index identifying object.
Returns:
Returns the type of the object if successful. Otherwise returns a negative value
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Tget_native_type

public static int H5Tget_native_type(int tid,
                                     int direction)
                              throws HDF5LibraryException
H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.

Parameters:
type_id - IN: Identifier of datatype to query.
direction - IN: Direction of search.
Returns:
the native datatype identifier for the specified dataset datatype.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Gn_members_long

public static long H5Gn_members_long(int loc_id,
                                     java.lang.String name)
                              throws HDF5LibraryException,
                                     java.lang.NullPointerException
H5Gn_members report the number of objects in a Group. The 'objects' include everything that will be visited by H5Giterate. Each link is returned, so objects with multiple links will be counted once for each link.

Parameters:
loc_id - file or group ID.
name - name of the group to iterate, relative to the loc_id
Returns:
the number of members in the group or -1 if error.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gn_members

public static int H5Gn_members(int loc_id,
                               java.lang.String name)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
H5Gn_members report the number of objects in a Group. The 'objects' include everything that will be visited by H5Giterate. Each link is returned, so objects with multiple links will be counted once for each link.

Parameters:
loc_id - file or group ID.
name - name of the group to iterate, relative to the loc_id
Returns:
the number of members in the group or -1 if error.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gget_obj_info_idx

public static int H5Gget_obj_info_idx(int loc_id,
                                      java.lang.String name,
                                      int idx,
                                      java.lang.String[] oname,
                                      int[] type)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
H5Gget_obj_info_idx report the name and type of object with index 'idx' in a Group. The 'idx' corresponds to the index maintained by H5Giterate. Each link is returned, so objects with multiple links will be counted once for each link.

Parameters:
loc_id - IN: file or group ID.
name - IN: name of the group to iterate, relative to the loc_id
idx - IN: the index of the object to iterate.
oname - the name of the object [OUT]
type - the type of the object [OUT]
Returns:
non-negative if successful, -1 if not.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gget_obj_info_all

public static int H5Gget_obj_info_all(int loc_id,
                                      java.lang.String name,
                                      java.lang.String[] oname,
                                      int[] otype,
                                      long[] ref)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
retrieves information of all objects under the group (name) located in the file or group specified by loc_id.

Parameters:
loc_id - IN: File or group identifier
name - IN: Name of group for which information is to be retrieved
objNames - OUT: Names of all objects under the group, name.
objTypes - OUT: Types of all objects under the group, name.
Returns:
the number of items found
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gget_obj_info_all

public static int H5Gget_obj_info_all(int loc_id,
                                      java.lang.String name,
                                      java.lang.String[] oname,
                                      int[] otype,
                                      int[] ltype,
                                      long[] ref,
                                      int indx_type)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Gget_objinfo

@Deprecated
public static int H5Gget_objinfo(int loc_id,
                                            java.lang.String name,
                                            boolean follow_link,
                                            long[] fileno,
                                            long[] objno,
                                            int[] link_info,
                                            long[] mtime)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException,
                                 java.lang.IllegalArgumentException
Deprecated. As of HDF5 1.8, replaced by and #H5Oget_info(int)

H5Gget_objinfo returns information about the specified object.

Parameters:
loc_id - IN: File, group, dataset, or datatype identifier.
name - IN: Name of the object for which status is being sought.
follow_link - IN: Link flag.
fileno - OUT: file id numbers.
objno - OUT: object id numbers.
link_info - OUT: link information.
          link_info[0] = nlink
          link_info[1] = type
          link_info[2] = linklen
 
mtime - OUT: modification time
Returns:
a non-negative value if successful, with the fields of link_info and mtime (if non-null) initialized.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name or array is null.
java.lang.IllegalArgumentException - - bad argument.

H5Gget_objinfo

@Deprecated
public static int H5Gget_objinfo(int loc_id,
                                            java.lang.String name,
                                            boolean follow_link,
                                            HDF5GroupInfo info)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Deprecated. As of HDF5 1.8

H5Gget_objinfo returns information about the specified object in an HDF5GroupInfo object.

Parameters:
loc_id - IN: File, group, dataset, or datatype identifier.
name - IN: Name of the object for which status is being sought.
follow_link - IN: Link flag.
info - OUT: the HDF5GroupInfo object to store the object infomation
Returns:
a non-negative value if successful, with the fields of HDF5GroupInfo object (if non-null) initialized.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.
See Also:
See public synchronized static native int H5Gget_objinfo();

H5Tget_native_type

public static int H5Tget_native_type(int tid)
                              throws HDF5LibraryException
H5Tget_native_type returns the equivalent native datatype for the datatype specified in type_id.

Parameters:
type_id - IN: Identifier of datatype to query. Direction of search is assumed to be in ascending order.
Returns:
the native datatype identifier for the specified dataset datatype.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_alloc_time

public static int H5Pset_alloc_time(int plist_id,
                                    int alloc_time)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_alloc_time

public static int H5Pget_alloc_time(int plist_id,
                                    int[] alloc_time)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_fill_time

public static int H5Pset_fill_time(int plist_id,
                                   int fill_time)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_fill_time

public static int H5Pget_fill_time(int plist_id,
                                   int[] fill_time)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pfill_value_defined

public static int H5Pfill_value_defined(int plist_id,
                                        int[] status)
                                 throws HDF5LibraryException,
                                        java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_fletcher32

public static int H5Pset_fletcher32(int plist)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_edc_check

public static int H5Pset_edc_check(int plist,
                                   int check)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_edc_check

public static int H5Pget_edc_check(int plist)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_shuffle

public static int H5Pset_shuffle(int plist_id)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_szip

public static int H5Pset_szip(int plist,
                              int options_mask,
                              int pixels_per_block)
                       throws HDF5LibraryException,
                              java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dget_space_status

public static int H5Dget_space_status(int dset_id,
                                      int[] status)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
H5Dget_space_status determines whether space has been allocated for the dataset dset_id.

Parameters:
dset_id - IN: Identifier of the dataset to query.
Returns:
the space allocation status
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException

H5Iget_name

public static long H5Iget_name(int obj_id,
                               java.lang.String[] name,
                               long size)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5set_free_list_limits

public static int H5set_free_list_limits(int reg_global_lim,
                                         int reg_list_lim,
                                         int arr_global_lim,
                                         int arr_list_lim,
                                         int blk_global_lim,
                                         int blk_list_lim)
                                  throws HDF5LibraryException
Throws:
HDF5LibraryException

H5Fget_obj_ids

public static int H5Fget_obj_ids(int file_id,
                                 int types,
                                 int max,
                                 int[] obj_id_list)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.

Parameters:
file_id - IN: File identifier for a currently-open HDF5 file
types - IN: Type of object for which identifiers are to be returned.
max_objs - IN: Maximum number of object identifiers to place into obj_id_list.
obj_id_list - OUT: Pointer to the returned list of open object identifiers.
Returns:
the number of objects placed into obj_id_list.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - obj_id_list is null.

H5Fget_obj_count

public static int H5Fget_obj_count(int file_id,
                                   int types)
                            throws HDF5LibraryException
H5Fget_obj_count returns the number of open object identifiers for the file.

Parameters:
file_id - IN: File identifier for a currently-open HDF5 file
types - IN: Type of object for which identifiers are to be returned.
  • H5F_OBJ_FILE Files only
  • H5F_OBJ_DATASET Datasets only
  • H5F_OBJ_GROUP Groups only
  • H5F_OBJ_DATATYPE Named datatypes only
  • H5F_OBJ_ATTR Attributes only
  • H5F_OBJ_ALL All of the above
  • H5F_OBJ_LOCAL Restrict search to objects opened through current file identifier.
Returns:
the number of open objects.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tis_variable_str

public static boolean H5Tis_variable_str(int type_id)
                                  throws HDF5LibraryException
H5Tis_variable_str determines whether the datatype identified in type_id is a variable-length string.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
true if type_id is a variable-length string.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Zfilter_avail

public static int H5Zfilter_avail(int filter)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Zunregister

public static int H5Zunregister(int filter)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pmodify_filter

public static int H5Pmodify_filter(int plist,
                                   int filter,
                                   int flags,
                                   long cd_nelmts,
                                   int[] cd_values)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_filter_by_id

public static int H5Pget_filter_by_id(int plist_id,
                                      int filter,
                                      int[] flags,
                                      long[] cd_nelmts,
                                      int[] cd_values,
                                      long namelen,
                                      java.lang.String[] name)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pall_filters_avail

public static boolean H5Pall_filters_avail(int dcpl_id)
                                    throws HDF5LibraryException,
                                           java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_hyper_vector_size

public static int H5Pset_hyper_vector_size(int dxpl_id,
                                           long vector_size)
                                    throws HDF5LibraryException,
                                           java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_hyper_vector_size

public static int H5Pget_hyper_vector_size(int dxpl_id,
                                           long[] vector_size)
                                    throws HDF5LibraryException,
                                           java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Tdetect_class

public static boolean H5Tdetect_class(int type_id,
                                      int cls)
                               throws HDF5LibraryException
H5Tdetect_class determines whether the datatype specified in dtype_id contains any datatypes of the datatype class specified in dtype_class.

Parameters:
type_id - IN: Identifier of datatype to query.
cls - IN: Identifier of datatype cls.
Returns:
true if the datatype specified in dtype_id contains any datatypes of the datatype class
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dread_short

public static int H5Dread_short(int dataset_id,
                                int mem_type_id,
                                int mem_space_id,
                                int file_space_id,
                                int xfer_plist_id,
                                short[] buf,
                                boolean isCriticalPinning)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_short

public static int H5Dread_short(int dataset_id,
                                int mem_type_id,
                                int mem_space_id,
                                int file_space_id,
                                int xfer_plist_id,
                                short[] buf)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_int

public static int H5Dread_int(int dataset_id,
                              int mem_type_id,
                              int mem_space_id,
                              int file_space_id,
                              int xfer_plist_id,
                              int[] buf,
                              boolean isCriticalPinning)
                       throws HDF5LibraryException,
                              java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_int

public static int H5Dread_int(int dataset_id,
                              int mem_type_id,
                              int mem_space_id,
                              int file_space_id,
                              int xfer_plist_id,
                              int[] buf)
                       throws HDF5LibraryException,
                              java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_long

public static int H5Dread_long(int dataset_id,
                               int mem_type_id,
                               int mem_space_id,
                               int file_space_id,
                               int xfer_plist_id,
                               long[] buf,
                               boolean isCriticalPinning)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_long

public static int H5Dread_long(int dataset_id,
                               int mem_type_id,
                               int mem_space_id,
                               int file_space_id,
                               int xfer_plist_id,
                               long[] buf)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_float

public static int H5Dread_float(int dataset_id,
                                int mem_type_id,
                                int mem_space_id,
                                int file_space_id,
                                int xfer_plist_id,
                                float[] buf,
                                boolean isCriticalPinning)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_float

public static int H5Dread_float(int dataset_id,
                                int mem_type_id,
                                int mem_space_id,
                                int file_space_id,
                                int xfer_plist_id,
                                float[] buf)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_double

public static int H5Dread_double(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 double[] buf,
                                 boolean isCriticalPinning)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_double

public static int H5Dread_double(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 double[] buf)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_string

public static int H5Dread_string(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 java.lang.String[] buf)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dread_reg_ref

public static int H5Dread_reg_ref(int dataset_id,
                                  int mem_type_id,
                                  int mem_space_id,
                                  int file_space_id,
                                  int xfer_plist_id,
                                  java.lang.String[] buf)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_short

public static int H5Dwrite_short(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 short[] buf,
                                 boolean isCriticalPinning)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_short

public static int H5Dwrite_short(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 short[] buf)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_int

public static int H5Dwrite_int(int dataset_id,
                               int mem_type_id,
                               int mem_space_id,
                               int file_space_id,
                               int xfer_plist_id,
                               int[] buf,
                               boolean isCriticalPinning)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_int

public static int H5Dwrite_int(int dataset_id,
                               int mem_type_id,
                               int mem_space_id,
                               int file_space_id,
                               int xfer_plist_id,
                               int[] buf)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_long

public static int H5Dwrite_long(int dataset_id,
                                int mem_type_id,
                                int mem_space_id,
                                int file_space_id,
                                int xfer_plist_id,
                                long[] buf,
                                boolean isCriticalPinning)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_long

public static int H5Dwrite_long(int dataset_id,
                                int mem_type_id,
                                int mem_space_id,
                                int file_space_id,
                                int xfer_plist_id,
                                long[] buf)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_float

public static int H5Dwrite_float(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 float[] buf,
                                 boolean isCriticalPinning)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_float

public static int H5Dwrite_float(int dataset_id,
                                 int mem_type_id,
                                 int mem_space_id,
                                 int file_space_id,
                                 int xfer_plist_id,
                                 float[] buf)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_double

public static int H5Dwrite_double(int dataset_id,
                                  int mem_type_id,
                                  int mem_space_id,
                                  int file_space_id,
                                  int xfer_plist_id,
                                  double[] buf,
                                  boolean isCriticalPinning)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Dwrite_double

public static int H5Dwrite_double(int dataset_id,
                                  int mem_type_id,
                                  int mem_space_id,
                                  int file_space_id,
                                  int xfer_plist_id,
                                  double[] buf)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_fclose_degree

public static int H5Pset_fclose_degree(int plist,
                                       int degree)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_fclose_degree

public static int H5Pget_fclose_degree(int plist_id)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Iget_ref

public static int H5Iget_ref(int obj_id)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Iinc_ref

public static int H5Iinc_ref(int obj_id)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Idec_ref

public static int H5Idec_ref(int obj_id)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_fapl_family

public static int H5Pset_fapl_family(int fapl_id,
                                     long memb_size,
                                     int memb_fapl_id)
                              throws HDF5LibraryException,
                                     java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_fapl_family

public static int H5Pget_fapl_family(int fapl_id,
                                     long[] memb_size,
                                     int[] memb_fapl_id)
                              throws HDF5LibraryException,
                                     java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_fapl_core

public static int H5Pset_fapl_core(int fapl_id,
                                   int increment,
                                   boolean backing_store)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_fapl_core

public static int H5Pget_fapl_core(int fapl_id,
                                   int[] increment,
                                   boolean[] backing_store)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_family_offset

public static int H5Pset_family_offset(int fapl_id,
                                       long offset)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pget_family_offset

public static long H5Pget_family_offset(int fapl_id)
                                 throws HDF5LibraryException,
                                        java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Pset_fapl_log

public static int H5Pset_fapl_log(int fapl_id,
                                  java.lang.String logfile,
                                  int flags,
                                  int buf_size)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Fget_name

public static java.lang.String H5Fget_name(int obj_id,
                                           int size)
                                    throws HDF5LibraryException
Throws:
HDF5LibraryException

H5Fget_filesize

public static long H5Fget_filesize(int file_id)
                            throws HDF5LibraryException
Throws:
HDF5LibraryException

H5Iget_file_id

public static int H5Iget_file_id(int obj_id)
                          throws HDF5LibraryException
Throws:
HDF5LibraryException

H5Premove_filter

public static int H5Premove_filter(int obj_id,
                                   int filter)
                            throws HDF5LibraryException
Throws:
HDF5LibraryException

H5Zget_filter_info

public static int H5Zget_filter_info(int filter)
                              throws HDF5LibraryException
Throws:
HDF5LibraryException

H5INcreate

public static int H5INcreate(java.lang.String grp_name,
                             int grp_loc_id,
                             int property_list,
                             int data_loc_id,
                             java.lang.String data_loc_name,
                             java.lang.String field_name,
                             long max_mem_size)

H5INquery

public static int H5INquery(int dset_id,
                            java.lang.String[] keys,
                            java.lang.Object ubounds,
                            java.lang.Object lbounds,
                            int nkeys)

H5Pset

public static int H5Pset(int plid,
                         java.lang.String name,
                         int value)
                  throws HDF5LibraryException
Sets a property list value (support integer only)

Parameters:
plid - IN: Property list identifier to modify
name - IN: Name of property to modify
value - IN: value to set the property to
Returns:
a non-negative value if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Pexist

public static int H5Pexist(int plid,
                           java.lang.String name)
                    throws HDF5LibraryException
H5Pexist determines whether a property exists within a property list or class

Parameters:
plid - IN: Identifier for the property to query
name - IN: Name of property to check for
Returns:
a positive value if the property exists in the property object; zero if the property does not exist; a negative value if failed
Throws:
HDF5LibraryException

H5Pget_size

public static long H5Pget_size(int plid,
                               java.lang.String name)
                        throws HDF5LibraryException
H5Pget_size retrieves the size of a property's value in bytes

Parameters:
plid - IN: Identifier of property object to query
name - IN: Name of property to query
Returns:
size of a property's value if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Pget_nprops

public static long H5Pget_nprops(int plid)
                          throws HDF5LibraryException
H5Pget_nprops retrieves the number of properties in a property list or class

Parameters:
plid - IN: Identifier of property object to query
Returns:
number of properties if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Pget_class_name

public static java.lang.String H5Pget_class_name(int plid)
                                          throws HDF5LibraryException
H5Pget_class_name retrieves the name of a generic property list class

Parameters:
plid - IN: Identifier of property object to query
Returns:
name of a property list if successful; null if failed
Throws:
HDF5LibraryException

H5Pget_class_parent

public static int H5Pget_class_parent(int plid)
                               throws HDF5LibraryException
H5Pget_class_parent retrieves an identifier for the parent class of a property class

Parameters:
plid - IN: Identifier of the property class to query
Returns:
a valid parent class object identifier if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Pisa_class

public static int H5Pisa_class(int plist,
                               int pclass)
                        throws HDF5LibraryException
H5Pisa_class checks to determine whether a property list is a member of the specified class

Parameters:
plist - IN: Identifier of the property list
pclass - IN: Identifier of the property class
Returns:
a positive value if equal; zero if unequal; a negative value if failed
Throws:
HDF5LibraryException

H5Pget

public static int H5Pget(int plid,
                         java.lang.String name)
                  throws HDF5LibraryException
H5Pget retrieves a copy of the value for a property in a property list (support integer only)

Parameters:
plid - IN: Identifier of property object to query
name - IN: Name of property to query
Returns:
value for a property if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Pequal

public static int H5Pequal(int plid1,
                           int plid2)
                    throws HDF5LibraryException
H5Pequal determines if two property lists or classes are equal

Parameters:
plid1 - IN: First property object to be compared
plid2 - IN: Second property object to be compared
Returns:
positive value if equal; zero if unequal, a negative value if failed
Throws:
HDF5LibraryException

H5Pcopy_prop

public static int H5Pcopy_prop(int dst_id,
                               int src_id,
                               java.lang.String name)
                        throws HDF5LibraryException
H5Pcopy_prop copies a property from one property list or class to another

Parameters:
dst_id - IN: Identifier of the destination property list or class
src_id - IN: Identifier of the source property list or class
name - IN: Name of the property to copy
Returns:
a non-negative value if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Premove

public static int H5Premove(int plid,
                            java.lang.String name)
                     throws HDF5LibraryException
H5Premove removes a property from a property list

Parameters:
plid - IN: Identifier of the property list to modify
name - IN: Name of property to remove
Returns:
a non-negative value if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Punregister

public static int H5Punregister(int plid,
                                java.lang.String name)
                         throws HDF5LibraryException
H5Punregister removes a property from a property list class

Parameters:
plid - IN: Property list class from which to remove permanent property
name - IN: Name of property to remove
Returns:
a non-negative value if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Pclose_class

public static int H5Pclose_class(int plid)
                          throws HDF5LibraryException
Closes an existing property list class

Parameters:
plid - IN: Property list class to close
Returns:
a non-negative value if successful; a negative value if failed
Throws:
HDF5LibraryException

H5Eregister_class

public static int H5Eregister_class(java.lang.String cls_name,
                                    java.lang.String lib_name,
                                    java.lang.String version)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Eregister_class registers a client library or application program to the HDF5 error API so that the client library or application program can report errors together with HDF5 library.

Parameters:
cls_name - IN: Name of the error class.
lib_name - IN: Name of the client library or application to which the error class belongs.
version - IN: Version of the client library or application to which the error class belongs.
Returns:
a class identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Eunregister_class

public static void H5Eunregister_class(int class_id)
                                throws HDF5LibraryException
H5Eunregister_class removes the error class specified by class_id.

Parameters:
class_id - IN: Error class identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eclose_msg

public static void H5Eclose_msg(int err_id)
                         throws HDF5LibraryException
H5Eclose_msg closes an error message identifier, which can be either a major or minor message.

Parameters:
err_id - IN: Error message identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Ecreate_msg

public static int H5Ecreate_msg(int cls_id,
                                int msg_type,
                                java.lang.String msg)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
H5Ecreate_msg adds an error message to an error class defined by client library or application program.

Parameters:
cls_id - IN: Error class identifier.
msg_type - IN: The type of the error message.
msg - IN: The error message.
Returns:
a message identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - msg is null.

H5Ecreate_stack

public static int H5Ecreate_stack()
                           throws HDF5LibraryException
H5Ecreate_stack creates a new empty error stack and returns the new stack's identifier.

Parameters:
none -
Returns:
an error stack identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eget_current_stack

public static int H5Eget_current_stack()
                                throws HDF5LibraryException
H5Eget_current_stack copies the current error stack and returns an error stack identifier for the new copy.

Parameters:
none -
Returns:
an error stack identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eclose_stack

public static void H5Eclose_stack(int stack_id)
                           throws HDF5LibraryException
H5Eclose_stack closes the object handle for an error stack and releases its resources.

Parameters:
stack_id - IN: Error stack identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eget_class_name

public static java.lang.String H5Eget_class_name(int class_id)
                                          throws HDF5LibraryException,
                                                 java.lang.NullPointerException
H5Eget_class_name retrieves the name of the error class specified by the class identifier.

Parameters:
class_id - IN: Error class identifier.
Returns:
the name of the error class
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException

H5Eset_current_stack

public static void H5Eset_current_stack(int stack_id)
                                 throws HDF5LibraryException
H5Eset_current_stack replaces the content of the current error stack with a copy of the content of the error stack specified by estack_id.

Parameters:
stack_id - IN: Error stack identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Epop

public static void H5Epop(int stack_id,
                          long count)
                   throws HDF5LibraryException
H5Epop deletes the number of error records specified in count from the top of the error stack specified by estack_id (including major, minor messages and description).

Parameters:
stack_id - IN: Error stack identifier.
count - IN: Version of the client library or application to which the error class belongs.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eprint2

public static void H5Eprint2(int err_stack,
                             java.lang.Object stream)
                      throws HDF5LibraryException
H5Eprint2 prints the error stack specified by estack_id on the specified stream, stream.

Parameters:
stack_id - IN: Error stack identifier.If the identifier is H5E_DEFAULT, the current error stack will be printed.
stream - IN: File pointer, or stderr if null.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eclear

public static void H5Eclear(int err_stack)
                     throws HDF5LibraryException
H5Eclear clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.

Parameters:
stack_id - IN: Error stack identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eclear2

public static void H5Eclear2(int err_stack)
                      throws HDF5LibraryException
H5Eclear2 clears the error stack specified by estack_id, or, if estack_id is set to H5E_DEFAULT, the error stack for the current thread.

Throws:
HDF5LibraryException
See Also:
static void H5Eclear(int err_stack)

H5Eauto_is_v2

public static boolean H5Eauto_is_v2(int err_stack)
                             throws HDF5LibraryException
H5Eauto_is_v2 determines whether the error auto reporting function for an error stack conforms to the H5E_auto2_t typedef or the H5E_auto1_t typedef.

Parameters:
stack_id - IN: Error stack identifier.
Returns:
boolean true if the error stack conforms to H5E_auto2_t and false if it conforms to H5E_auto1_t.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eget_msg

public static java.lang.String H5Eget_msg(int msg_id,
                                          int[] type_list)
                                   throws HDF5LibraryException
H5Eget_msg retrieves the error message including its length and type.

Parameters:
msg_id - IN: Name of the error class.
type - OUT: The type of the error message. Valid values are H5E_MAJOR and H5E_MINOR.
Returns:
the error message
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Eget_num

public static long H5Eget_num(int stack_id)
                       throws HDF5LibraryException,
                              java.lang.NullPointerException
H5Eget_num retrieves the number of error records in the error stack specified by estack_id (including major, minor messages and description).

Parameters:
stack_id - IN: Error stack identifier.
Returns:
the number of error messages
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException

H5Eprint1

@Deprecated
public static void H5Eprint1(java.lang.Object stream)
                      throws HDF5LibraryException
Deprecated. As of HDF5 1.8, replaced by H5Eprint2(int, Object)

H5Eprint1 prints the error stack specified by estack_id on the specified stream, stream.

Parameters:
stream - IN: File pointer, or stderr if null.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fget_intent

public static int H5Fget_intent(int file_id)
                         throws HDF5LibraryException
H5Fget_intent retrieves the intended access mode flag passed with H5Fopen when the file was opened.

Parameters:
file_id - IN: File identifier for a currently-open HDF5 file
Returns:
the intended access mode flag, as originally passed with H5Fopen.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fget_obj_count_long

public static long H5Fget_obj_count_long(int file_id,
                                         int types)
                                  throws HDF5LibraryException
H5Fget_obj_count returns the number of open object identifiers for the file.

Parameters:
file_id - IN: File identifier for a currently-open HDF5 file
types - IN: Type of object for which identifiers are to be returned.
  • H5F_OBJ_FILE Files only
  • H5F_OBJ_DATASET Datasets only
  • H5F_OBJ_GROUP Groups only
  • H5F_OBJ_DATATYPE Named datatypes only
  • H5F_OBJ_ATTR Attributes only
  • H5F_OBJ_ALL All of the above
  • H5F_OBJ_LOCAL Restrict search to objects opened through current file identifier.
Returns:
the number of open objects.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fget_obj_ids_long

public static long H5Fget_obj_ids_long(int file_id,
                                       int types,
                                       long max_objs,
                                       int[] obj_id_list)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Fget_obj_ids returns the list of identifiers for all open HDF5 objects fitting the specified criteria.

Parameters:
file_id - IN: File identifier for a currently-open HDF5 file
types - IN: Type of object for which identifiers are to be returned.
max_objs - IN: Maximum number of object identifiers to place into obj_id_list.
obj_id_list - OUT: Pointer to the returned list of open object identifiers.
Returns:
the number of objects placed into obj_id_list.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - obj_id_list is null.

H5Fget_freespace

public static long H5Fget_freespace(int file_id)
                             throws HDF5LibraryException
H5Fget_freespace returns the amount of space that is unused by any objects in the file.

Parameters:
file_id - IN: File identifier for a currently-open HDF5 file
Returns:
the amount of free space in the file
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fget_mdc_hit_rate

public static double H5Fget_mdc_hit_rate(int file_id)
                                  throws HDF5LibraryException
H5Fget_mdc_hit_rate queries the metadata cache of the target file to obtain its hit rate (cache hits / (cache hits + cache misses)) since the last time hit rate statistics were reset.

Parameters:
file_id - IN: Identifier of the target file.
Returns:
the double in which the hit rate is returned.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fget_mdc_size

public static int H5Fget_mdc_size(int file_id,
                                  long[] metadata_cache)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException,
                                  java.lang.IllegalArgumentException
H5Fget_mdc_size queries the metadata cache of the target file for the desired size information.

Parameters:
file_id - IN: Identifier of the target file.
metadata_cache - OUT: Current metadata cache information
  • metadata_cache[0] = max_size_ptr // current cache maximum size
  • metadata_cache[1] = min_clean_size_ptr // current cache minimum clean size
  • metadata_cache[2] = cur_size_ptr // current cache size
Returns:
current number of entries in the cache
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - metadata_cache is null.
java.lang.IllegalArgumentException

H5Freset_mdc_hit_rate_stats

public static void H5Freset_mdc_hit_rate_stats(int file_id)
                                        throws HDF5LibraryException
H5Freset_mdc_hit_rate_stats resets the hit rate statistics counters in the metadata cache associated with the specified file.

Parameters:
file_id - IN: Identifier of the target file.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Fget_name

public static java.lang.String H5Fget_name(int obj_id)
                                    throws HDF5LibraryException
H5Fget_name retrieves the name of the file to which the object obj_id belongs.

Parameters:
obj_id - IN: Identifier of the object for which the associated filename is sought.
Returns:
the filename.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Gcreate

public static int H5Gcreate(int loc_id,
                            java.lang.String name,
                            int lcpl_id,
                            int gcpl_id,
                            int gapl_id)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Gcreate creates a new group with the specified name at the specified location, loc_id.

Parameters:
loc_id - IN: The file or group identifier.
name - IN: The absolute or relative name of the new group.
lcpl_id - IN: Identifier of link creation property list.
gcpl_id - IN: Identifier of group creation property list.
gapl_id - IN: Identifier of group access property list. (No group access properties have been implemented at this time; use H5P_DEFAULT.)
Returns:
a valid group identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

_H5Gcreate2

public static int _H5Gcreate2(int loc_id,
                              java.lang.String name,
                              int lcpl_id,
                              int gcpl_id,
                              int gapl_id)
                       throws HDF5LibraryException,
                              java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Gcreate_anon

public static int H5Gcreate_anon(int loc_id,
                                 int gcpl_id,
                                 int gapl_id)
                          throws HDF5LibraryException
H5Gcreate_anon creates a new empty group in the file specified by loc_id.

Parameters:
loc_id - IN: File or group identifier specifying the file in which the new group is to be created.
gcpl_id - IN: Identifier of group creation property list.
gapl_id - IN: Identifier of group access property list. (No group access properties have been implemented at this time; use H5P_DEFAULT.)
Returns:
a valid group identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

_H5Gcreate_anon

public static int _H5Gcreate_anon(int loc_id,
                                  int gcpl_id,
                                  int gapl_id)
                           throws HDF5LibraryException
Throws:
HDF5LibraryException

H5Gopen

public static int H5Gopen(int loc_id,
                          java.lang.String name,
                          int gapl_id)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Gopen opens an existing group, name, at the location specified by loc_id.

Parameters:
loc_id - IN: File or group identifier specifying the location of the group to be opened.
name - IN: Name of group to open.
gapl_id - IN: Identifier of group access property list. (No group access properties have been implemented at this time; use H5P_DEFAULT.)
Returns:
a valid group identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

_H5Gopen2

public static int _H5Gopen2(int loc_id,
                            java.lang.String name,
                            int gapl_id)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Gget_create_plist

public static int H5Gget_create_plist(int group_id)
                               throws HDF5LibraryException
H5Gget_create_plist returns an identifier for the group creation property list associated with the group specified by group_id.

Parameters:
group_id - IN: Identifier of the group.
Returns:
an identifier for the group's creation property list
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Gget_info

public static H5G_info_t H5Gget_info(int group_id)
                              throws HDF5LibraryException
H5Gget_info retrieves information about the group specified by group_id. The information is returned in the group_info struct.

Parameters:
group_id - IN: Identifier of the group.
Returns:
a structure in which group information is returned
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Gget_info_by_name

public static H5G_info_t H5Gget_info_by_name(int group_id,
                                             java.lang.String name,
                                             int lapl_id)
                                      throws HDF5LibraryException,
                                             java.lang.NullPointerException
H5Gget_info_by_name retrieves information about the group group_name located in the file or group specified by loc_id.

Parameters:
group_id - IN: File or group identifier.
name - IN: Name of group for which information is to be retrieved.
lapl_id - IN: Link access property list.
Returns:
a structure in which group information is returned
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gget_info_by_idx

public static H5G_info_t H5Gget_info_by_idx(int group_id,
                                            java.lang.String group_name,
                                            int idx_type,
                                            int order,
                                            long n,
                                            int lapl_id)
                                     throws HDF5LibraryException,
                                            java.lang.NullPointerException
H5Gget_info_by_idx retrieves information about a group, according to the group's position within an index.

Parameters:
group_id - IN: File or group identifier.
group_name - IN: Name of group for which information is to be retrieved.
idx_type - IN: Type of index by which objects are ordered
order - IN: Order of iteration within index
n - IN: Attribute's position in index
lapl_id - IN: Link access property list.
Returns:
a structure in which group information is returned
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Gget_obj_info_max

public static int H5Gget_obj_info_max(int loc_id,
                                      java.lang.String[] objNames,
                                      int[] objTypes,
                                      int[] lnkTypes,
                                      long[] ref,
                                      int objMax)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
retrieves information of all objects (recurvisely) under the group (name) located in the file or group specified by loc_id upto maximum specified by objMax.

Parameters:
loc_id - IN: File or group identifier
name - IN: Name of group for which information is to be retrieved
objNames - OUT: Names of all objects under the group, name.
objTypes - OUT: Types of all objects under the group, name.
objMax - IN: Maximum number of all objects under the group, name.
Returns:
the number of items found
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Lcopy

public static void H5Lcopy(int src_loc,
                           java.lang.String src_name,
                           int dst_loc,
                           java.lang.String dst_name,
                           int lcpl_id,
                           int lapl_id)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Lcopy copies a link from one location to another.

Parameters:
src_loc - IN: Location identifier of the source link
src_name - IN: Name of the link to be copied
dst_loc - IN: Location identifier specifying the destination of the copy
dst_name - IN: Name to be assigned to the new copy
lcpl_id - IN: Link creation property list identifier
lapl_id - IN: Link access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Lcreate_external

public static void H5Lcreate_external(java.lang.String file_name,
                                      java.lang.String obj_name,
                                      int link_loc_id,
                                      java.lang.String link_name,
                                      int lcpl_id,
                                      int lapl_id)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
H5Lcreate_external creates a new soft link to an external object, which is an object in a different HDF5 file from the location of the link.

Parameters:
file_name - IN: Name of the target file containing the target object.
obj_name - IN: Path within the target file to the target object.
link_loc_id - IN: The file or group identifier for the new link.
link_name - IN: The name of the new link.
lcpl_id - IN: Link creation property list identifier
lapl_id - IN: Link access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Lcreate_hard

public static void H5Lcreate_hard(int cur_loc,
                                  java.lang.String cur_name,
                                  int dst_loc,
                                  java.lang.String dst_name,
                                  int lcpl_id,
                                  int lapl_id)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Lcreate_hard creates a new hard link to a pre-existing object in an HDF5 file.

Parameters:
cur_loc - IN: The file or group identifier for the target object.
cur_name - IN: Name of the target object, which must already exist.
dst_loc - IN: The file or group identifier for the new link.
dst_name - IN: The name of the new link.
lcpl_id - IN: Link creation property list identifier
lapl_id - IN: Link access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - cur_name or dst_name is null.

H5Lcreate_soft

public static void H5Lcreate_soft(java.lang.String link_target,
                                  int link_loc_id,
                                  java.lang.String link_name,
                                  int lcpl_id,
                                  int lapl_id)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Lcreate_soft creates a new soft link to an object in an HDF5 file.

Parameters:
link_target - IN: Path to the target object, which is not required to exist.
link_loc_id - IN: The file or group identifier for the new link.
link_name - IN: The name of the new link.
lcpl_id - IN: Link creation property list identifier
lapl_id - IN: Link access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - link_name is null.

H5Ldelete

public static void H5Ldelete(int loc_id,
                             java.lang.String name,
                             int lapl_id)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
H5Ldelete removes the link specified from a group.

Parameters:
loc_id - IN: Identifier of the file or group containing the object.
name - IN: Name of the link to delete.
lapl_id - IN: Link access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Ldelete_by_idx

public static void H5Ldelete_by_idx(int loc_id,
                                    java.lang.String group_name,
                                    int idx_type,
                                    int order,
                                    long n,
                                    int lapl_id)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Ldelete_by_idx removes the nth link in a group according to the specified order and in the specified index.

Parameters:
loc_id - IN: File or group identifier specifying location of subject group
group_name - IN: Name of subject group
idx_type - IN: Index or field which determines the order
order - IN: Order within field or index
n - IN: Link for which to retrieve information
lapl_id - IN: Link access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - group_name is null.

H5Lexists

public static boolean H5Lexists(int loc_id,
                                java.lang.String name,
                                int lapl_id)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
H5Lexists checks if a link with a particular name exists in a group.

Parameters:
loc_id - IN: Identifier of the file or group to query.
name - IN: The name of the link to check.
lapl_id - IN: Link access property list identifier
Returns:
a boolean, true if the name exists, otherwise false.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Lget_info

public static H5L_info_t H5Lget_info(int loc_id,
                                     java.lang.String name,
                                     int lapl_id)
                              throws HDF5LibraryException,
                                     java.lang.NullPointerException
H5Lget_info returns information about the specified link.

Parameters:
loc_id - IN: Identifier of the file or group.
name - IN: Name of the link for which information is being sought.
lapl_id - IN: Link access property list identifier
Returns:
a buffer(H5L_info_t) for the link information.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Lget_info_by_idx

public static H5L_info_t H5Lget_info_by_idx(int loc_id,
                                            java.lang.String group_name,
                                            int idx_type,
                                            int order,
                                            long n,
                                            int lapl_id)
                                     throws HDF5LibraryException,
                                            java.lang.NullPointerException
H5Lget_info_by_idx opens a named datatype at the location specified by loc_id and return an identifier for the datatype.

Parameters:
loc_id - IN: File or group identifier specifying location of subject group
group_name - IN: Name of subject group
idx_type - IN: Type of index
order - IN: Order within field or index
n - IN: Link for which to retrieve information
lapl_id - IN: Link access property list identifier
Returns:
a buffer(H5L_info_t) for the link information.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - group_name is null.

H5Lget_name_by_idx

public static java.lang.String H5Lget_name_by_idx(int loc_id,
                                                  java.lang.String group_name,
                                                  int idx_type,
                                                  int order,
                                                  long n,
                                                  int lapl_id)
                                           throws HDF5LibraryException,
                                                  java.lang.NullPointerException
H5Lget_name_by_idx retrieves name of the nth link in a group, according to the order within a specified field or index.

Parameters:
loc_id - IN: File or group identifier specifying location of subject group
group_name - IN: Name of subject group
idx_type - IN: Type of index
order - IN: Order within field or index
n - IN: Link for which to retrieve information
lapl_id - IN: Link access property list identifier
Returns:
a String for the link name.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - group_name is null.

H5Lget_val

public static int H5Lget_val(int loc_id,
                             java.lang.String name,
                             java.lang.String[] link_value,
                             int lapl_id)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
H5Lget_val returns the link value of a symbolic link.

Parameters:
loc_id - IN: Identifier of the file or group containing the object.
name - IN: Name of the symbolic link.
link_value - OUT: Path of the symbolic link, or the file_name and path of an external file.
lapl_id - IN: Link access property list identifier
Returns:
the link type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Lget_val_by_idx

public static int H5Lget_val_by_idx(int loc_id,
                                    java.lang.String group_name,
                                    int idx_type,
                                    int order,
                                    long n,
                                    java.lang.String[] link_value,
                                    int lapl_id)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Lget_val_by_idx retrieves value of the nth link in a group, according to the order within an index.

Parameters:
loc_id - IN: File or group identifier specifying location of subject group
group_name - IN: Name of subject group
idx_type - IN: Type of index
order - IN: Order within field or index
n - IN: Link for which to retrieve information
link_value - OUT: Path of the symbolic link, or the file_name and path of an external file.
lapl_id - IN: Link access property list identifier
Returns:
the link type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - group_name is null.

H5Lmove

public static void H5Lmove(int src_loc,
                           java.lang.String src_name,
                           int dst_loc,
                           java.lang.String dst_name,
                           int lcpl_id,
                           int lapl_id)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Lmove renames a link within an HDF5 file.

Parameters:
src_loc - IN: Original file or group identifier.
src_name - IN: Original link name.
dst_loc - IN: Destination file or group identifier.
dst_name - IN: New link name.
lcpl_id - IN: Link creation property list identifier to be associated with the new link.
lapl_id - IN: Link access property list identifier to be associated with the new link.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Lvisit

public static int H5Lvisit(int grp_id,
                           int idx_type,
                           int order,
                           H5L_iterate_cb op,
                           H5L_iterate_t op_data)
                    throws HDF5LibraryException
H5Lvisit recursively visits all links starting from a specified group.

Parameters:
grp_id - IN: Identifier specifying subject group
idx_type - IN: Type of index
order - IN: Order of iteration within index
op - IN: Callback function passing data regarding the link to the calling application
op_data - IN: User-defined pointer to data required by the application for its processing of the link
Returns:
returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Lvisit_by_name

public static int H5Lvisit_by_name(int loc_id,
                                   java.lang.String group_name,
                                   int idx_type,
                                   int order,
                                   H5L_iterate_cb op,
                                   H5L_iterate_t op_data,
                                   int lapl_id)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
H5Lvisit_by_name recursively visits all links starting from a specified group.

Parameters:
loc_id - IN: Identifier specifying subject group
group_name - IN: Name of subject group
idx_type - IN: Type of index
order - IN: Order of iteration within index
op - IN: Callback function passing data regarding the link to the calling application
op_data - IN: User-defined pointer to data required by the application for its processing of the link
Returns:
returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - group_name is null.

H5Literate

public static int H5Literate(int grp_id,
                             int idx_type,
                             int order,
                             long idx,
                             H5L_iterate_cb op,
                             H5L_iterate_t op_data)
                      throws HDF5LibraryException
H5Literate iterates through links in a group.

Parameters:
grp_id - IN: Identifier specifying subject group
idx_type - IN: Type of index
order - IN: Order of iteration within index
idx - IN: Iteration position at which to start
op - IN: Callback function passing data regarding the link to the calling application
op_data - IN: User-defined pointer to data required by the application for its processing of the link
Returns:
returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Literate_by_name

public static int H5Literate_by_name(int loc_id,
                                     java.lang.String group_name,
                                     int idx_type,
                                     int order,
                                     long idx,
                                     H5L_iterate_cb op,
                                     H5L_iterate_t op_data,
                                     int lapl_id)
                              throws HDF5LibraryException,
                                     java.lang.NullPointerException
H5Literate_by_name iterates through links in a group.

Parameters:
grp_id - IN: Identifier specifying subject group
group_name - IN: Name of subject group
idx_type - IN: Type of index
order - IN: Order of iteration within index
idx - IN: Iteration position at which to start
op - IN: Callback function passing data regarding the link to the calling application
op_data - IN: User-defined pointer to data required by the application for its processing of the link
lapl_id - IN: Link access property list identifier
Returns:
returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - group_name is null.

H5Sextent_equal

public static boolean H5Sextent_equal(int first_space_id,
                                      int second_space_id)
                               throws HDF5LibraryException
H5Sextent_equal determines whether the dataspace extents of two dataspaces, space1_id and space2_id, are equal.

Parameters:
first_space_id - IN: The identifier for the first dataspace.
second_space_id - IN: The identifier for the seconddataspace.
Returns:
true if successful, else false
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Sencode

public static byte[] H5Sencode(int obj_id)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException
H5Sencode converts a data space description into binary form in a buffer.

Parameters:
obj_id - IN: Identifier of the object to be encoded.
Returns:
the buffer for the object to be encoded into.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException

H5Sdecode

public static int H5Sdecode(byte[] buf)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Sdecode reconstructs the HDF5 data space object and returns a new object handle for it.

Parameters:
buf - IN: Buffer for the data space object to be decoded.
Returns:
a new object handle
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Tcreate

public static int H5Tcreate(int type,
                            long size)
                     throws HDF5LibraryException
H5Tcreate creates a new dataype of the specified class with the specified number of bytes.

Parameters:
type - IN: Class of datatype to create.
size - IN: The number of bytes in the datatype to create.
Returns:
datatype identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tcommit

public static void H5Tcommit(int loc_id,
                             java.lang.String name,
                             int type_id,
                             int lcpl_id,
                             int tcpl_id,
                             int tapl_id)
                      throws HDF5LibraryException,
                             java.lang.NullPointerException
H5Tcommit saves a transient datatype as an immutable named datatype in a file.

Parameters:
loc_id - IN: Location identifier.
name - IN: Name given to committed datatype.
type_id - IN: Identifier of datatype to be committed.
lcpl_id - IN: Link creation property list.
tcpl_id - IN: Datatype creation property list.
tapl_id - IN: Datatype access property list.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Topen

public static int H5Topen(int loc_id,
                          java.lang.String name,
                          int tapl_id)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Topen opens a named datatype at the location specified by loc_id and return an identifier for the datatype.

Parameters:
loc_id - IN: A file, group, or datatype identifier.
name - IN: A datatype name, defined within the file or group identified by loc_id.
tapl_id - IN: Datatype access property list.
Returns:
a named datatype identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tcommit_anon

public static void H5Tcommit_anon(int loc_id,
                                  int type_id,
                                  int tcpl_id,
                                  int tapl_id)
                           throws HDF5LibraryException
H5Tcommit_anon commits a transient datatype (not immutable) to a file, turning it into a named datatype with the specified creation and property lists.

Parameters:
loc_id - IN: Location identifier.
type_id - IN: Identifier of datatype to be committed.
tcpl_id - IN: Datatype creation property list.
tapl_id - IN: Datatype access property list.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_create_plist

public static int H5Tget_create_plist(int type_id)
                               throws HDF5LibraryException
H5Tget_create_plist returns a property list identifier for the datatype creation property list associated with the datatype specified by type_id.

Parameters:
type_id - IN: Identifier of datatype.
Returns:
a datatype property list identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tencode

public static int H5Tencode(int obj_id,
                            byte[] buf,
                            long nalloc)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Tencode converts a data type description into binary form in a buffer.

Parameters:
obj_id - IN: Identifier of the object to be encoded.
buf - OUT: Buffer for the object to be encoded into. If the provided buffer is NULL, only the size of buffer needed is returned.
nalloc - IN: The size of the allocated buffer.
Returns:
the size needed for the allocated buffer.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Tdecode

public static int H5Tdecode(byte[] buf)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Tdecode reconstructs the HDF5 data type object and returns a new object handle for it.

Parameters:
buf - IN: Buffer for the data type object to be decoded.
Returns:
a new object handle
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Tenum_insert

public static void H5Tenum_insert(int type,
                                  java.lang.String name,
                                  byte[] value)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Tenum_insert inserts a new enumeration datatype member into an enumeration datatype.

Parameters:
type - IN: Identifier of datatype.
name - IN: The name of the member
value - IN: The value of the member, data of the correct type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Tenum_nameof

public static java.lang.String H5Tenum_nameof(int type,
                                              byte[] value,
                                              long size)
                                       throws HDF5LibraryException,
                                              java.lang.NullPointerException
H5Tenum_nameof finds the symbol name that corresponds to the specified value of the enumeration datatype type.

Parameters:
type - IN: Identifier of datatype.
value - IN: The value of the member, data of the correct
size - IN: The probable length of the name
Returns:
the symbol name.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - value is null.

H5Tenum_valueof

public static void H5Tenum_valueof(int type,
                                   java.lang.String name,
                                   byte[] value)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
H5Tenum_valueof finds the value that corresponds to the specified name of the enumeration datatype type.

Parameters:
type - IN: Identifier of datatype.
name - IN: The name of the member
value - OUT: The value of the member
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException

H5Tarray_create

public static int H5Tarray_create(int base_id,
                                  int ndims,
                                  long[] dim)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Tarray_create creates a new array datatype object.

Parameters:
base_id - IN: Datatype identifier for the array base datatype.
ndims - IN: Rank of the array.
dim - IN: Size of each array dimension.
Returns:
a valid datatype identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dim is null.

H5Tget_array_dims

public static int H5Tget_array_dims(int type_id,
                                    long[] dims)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.

Parameters:
type_id - IN: Datatype identifier of array object.
dims - OUT: Sizes of array dimensions.
Returns:
the non-negative number of dimensions of the array type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - dims is null.

H5Tget_array_dims2

public static int H5Tget_array_dims2(int type_id,
                                     long[] dims)
                              throws HDF5LibraryException,
                                     java.lang.NullPointerException
H5Tget_array_dims2 returns the sizes of the dimensions of the specified array datatype object.

Throws:
HDF5LibraryException
java.lang.NullPointerException
See Also:
static int H5Tget_array_dims(int type_id, long[] dims)

H5Tget_size_long

public static long H5Tget_size_long(int type_id)
                             throws HDF5LibraryException
H5Tget_size returns the size of a datatype in bytes.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
the size of the datatype in bytes
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_precision_long

public static long H5Tget_precision_long(int type_id)
                                  throws HDF5LibraryException
H5Tget_precision returns the precision of an atomic datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
the number of significant bits if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_fields

public static void H5Tget_fields(int type_id,
                                 long[] fields)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException,
                                 java.lang.IllegalArgumentException
H5Tget_fields retrieves information about the locations of the various bit fields of a floating point datatype.

Parameters:
type_id - IN: Identifier of datatype to query.
fields - OUT: location of size and bit-position.
  • fields[0] = spos OUT: location to return size of in bits.
  • fields[1] = epos OUT: location to return exponent bit-position.
  • fields[2] = esize OUT: location to return size of exponent in bits.
  • fields[3] = mpos OUT: location to return mantissa bit-position.
  • fields[4] = msize OUT: location to return size of mantissa in bits.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - fields is null.
java.lang.IllegalArgumentException - - fields array is invalid.

H5Tget_ebias_long

public static long H5Tget_ebias_long(int type_id)
                              throws HDF5LibraryException
H5Tget_ebias retrieves the exponent bias of a floating-point type.

Parameters:
type_id - IN: Identifier of datatype to query.
Returns:
the bias
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tget_member_value

public static void H5Tget_member_value(int type_id,
                                       int membno,
                                       byte[] value)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Tget_member_value returns the value of the enumeration datatype member memb_no.

Parameters:
type_id - IN: Datatype identifier for the enumeration datatype.
membno - IN: Number of the enumeration datatype member.
value - OUT: The value of the member
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - value is null.

H5Tset_size

public static void H5Tset_size(int type_id,
                               long size)
                        throws HDF5LibraryException
H5Tset_size sets the total size in bytes, size, for an atomic datatype (this operation is not permitted on compound datatypes).

Parameters:
type_id - IN: Identifier of datatype to change size.
size - IN: Size in bytes to modify datatype.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_precision

public static void H5Tset_precision(int type_id,
                                    long precision)
                             throws HDF5LibraryException
H5Tset_precision sets the precision of an atomic datatype.

Parameters:
type_id - IN: Identifier of datatype to set.
precision - IN: Number of bits of precision for datatype.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_offset

public static void H5Tset_offset(int type_id,
                                 long offset)
                          throws HDF5LibraryException
H5Tset_offset sets the bit offset of the first significant bit.

Parameters:
type_id - IN: Identifier of datatype to set.
offset - IN: Offset of first significant bit.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_fields

public static void H5Tset_fields(int type_id,
                                 long spos,
                                 long epos,
                                 long esize,
                                 long mpos,
                                 long msize)
                          throws HDF5LibraryException
H5Tset_fields sets the locations and sizes of the various floating point bit fields.

Parameters:
type_id - IN: Identifier of datatype to set.
spos - IN: Size position.
epos - IN: Exponent bit position.
esize - IN: Size of exponent in bits.
mpos - IN: Mantissa bit position.
msize - IN: Size of mantissa in bits.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tset_ebias

public static void H5Tset_ebias(int type_id,
                                long ebias)
                         throws HDF5LibraryException
H5Tset_ebias sets the exponent bias of a floating-point type.

Parameters:
type_id - IN: Identifier of datatype to set.
ebias - IN: Exponent bias value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tcompiler_conv

public static void H5Tcompiler_conv(int src_id,
                                    int dst_id)
                             throws HDF5LibraryException
H5Tcompiler_conv finds out whether the library's conversion function from type src_id to type dst_id is a compiler (hard) conversion.

Parameters:
src_id - IN: Identifier of source datatype.
dst_id - IN: Identifier of destination datatype.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Tconvert

public static void H5Tconvert(int src_id,
                              int dst_id,
                              long nelmts,
                              byte[] buf,
                              byte[] background,
                              int plist_id)
                       throws HDF5LibraryException,
                              java.lang.NullPointerException
H5Tconvert converts nelmts elements from the type specified by the src_id identifier to type dst_id.

Parameters:
src_id - IN: Identifier of source datatype.
dst_id - IN: Identifier of destination datatype.
nelmts - IN: Size of array buf.
buf - IN: Array containing pre- and post-conversion values.
background - IN: Optional background buffer.
plist_id - IN: Dataset transfer property list identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Tget_array_dims

@Deprecated
public static int H5Tget_array_dims(int type_id,
                                               long[] dims,
                                               int[] perm)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
Deprecated. As of HDF5 1.8, replaced by H5Tget_array_dims(int, long[])

H5Tget_array_dims returns the sizes of the dimensions of the specified array datatype object.

Parameters:
type_id - IN: Datatype identifier of array object.
dims - OUT: Sizes of array dimensions.
perm - OUT: Dimension permutation. (Currently not implemented.)
Returns:
the non-negative number of dimensions of the array type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException

H5Dcreate

public static int H5Dcreate(int loc_id,
                            java.lang.String name,
                            int type_id,
                            int space_id,
                            int lcpl_id,
                            int dcpl_id,
                            int dapl_id)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Dcreate creates a new dataset named name at the location specified by loc_id.

Parameters:
loc_id - IN: Location identifier
name - IN: Dataset name
type_id - IN: Datatype identifier
space_id - IN: Dataspace identifier
lcpl_id - IN: Identifier of link creation property list.
dcpl_id - IN: Identifier of dataset creation property list.
dapl_id - IN: Identifier of dataset access property list.
Returns:
a dataset identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Dcreate_anon

public static int H5Dcreate_anon(int loc_id,
                                 int type_id,
                                 int space_id,
                                 int dcpl_id,
                                 int dapl_id)
                          throws HDF5LibraryException
H5Dcreate_anon creates a dataset in the file specified by loc_id.

Parameters:
loc_id - IN: Location identifier
type_id - IN: Datatype identifier
space_id - IN: Dataspace identifier
lcpl_id - IN: Identifier of link creation property list.
dcpl_id - IN: Identifier of dataset creation property list.
dapl_id - IN: Identifier of dataset access property list.
Returns:
a dataset identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dopen

public static int H5Dopen(int loc_id,
                          java.lang.String name,
                          int dapl_id)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Dopen opens the existing dataset specified by a location identifier and name, loc_id and name, respectively.

Parameters:
loc_id - IN: Location identifier
name - IN: Dataset name
dapl_id - IN: Identifier of dataset access property list.
Returns:
a dataset identifier if successful
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Dget_space_status

public static int H5Dget_space_status(int dset_id)
                               throws HDF5LibraryException
H5Dget_space_status determines whether space has been allocated for the dataset dset_id.

Parameters:
dset_id - IN: Identifier of the dataset to query.
Returns:
the space allocation status
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dget_access_plist

public static int H5Dget_access_plist(int dset_id)
                               throws HDF5LibraryException
H5Dget_access_plist returns an identifier for a copy of the dataset access property list for a dataset.

Parameters:
dset_id - IN: Identifier of the dataset to query.
Returns:
a dataset access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dget_offset

public static long H5Dget_offset(int dset_id)
                          throws HDF5LibraryException
H5Dget_offset returns the address in the file of the dataset dset_id.

Parameters:
dset_id - IN: Identifier of the dataset in question
Returns:
the offset in bytes.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Dvlen_get_buf_size

public static long H5Dvlen_get_buf_size(int dset_id,
                                        int type_id,
                                        int space_id)
                                 throws HDF5LibraryException
H5Dvlen_get_buf_size determines the number of bytes required to store the VL data from the dataset, using the space_id for the selection in the dataset on disk and the type_id for the memory representation of the VL data in memory.

Parameters:
dset_id - IN: Identifier of the dataset read from.
type_id - IN: Identifier of the datatype.
space_id - IN: Identifier of the dataspace.
Returns:
the size in bytes of the memory buffer required to store the VL data.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Dfill

public static void H5Dfill(byte[] fill,
                           int fill_type,
                           byte[] buf,
                           int buf_type,
                           int space)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Dfill explicitly fills the dataspace selection in memory, space_id, with the fill value specified in fill.

Parameters:
fill - IN: Pointer to the fill value to be used.
fill_type - IN: Fill value datatype identifier.
buf - IN/OUT: Pointer to the memory buffer containing the selection to be filled.
buf_type - IN: Datatype of dataspace elements to be filled.
space - IN: Dataspace describing memory buffer and containing the selection to be filled.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - buf is null.

H5Dset_extent

public static void H5Dset_extent(int dset_id,
                                 long[] size)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
H5Dset_extent sets the current dimensions of the chunked dataset dset_id to the sizes specified in size.

Parameters:
dset_id - IN: Chunked dataset identifier.
size - IN: Array containing the new magnitude of each dimension of the dataset.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.

H5Rget_name

public static long H5Rget_name(int loc_id,
                               int ref_type,
                               byte[] ref,
                               java.lang.String[] name,
                               long size)
                        throws HDF5LibraryException,
                               java.lang.NullPointerException,
                               java.lang.IllegalArgumentException
H5Rget_name retrieves a name for the object identified by ref.

Parameters:
loc_id - IN: Identifier for the dataset containing the reference or for the group that dataset is in.
ref_type - IN: Type of reference.
ref - IN: An object or dataset region reference.
name - OUT: A name associated with the referenced object or dataset region.
size - IN: The size of the name buffer.
Returns:
Returns the length of the name if successful, returning 0 (zero) if no name is associated with the identifier. Otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.
java.lang.IllegalArgumentException - - Argument is illegal.

H5Rget_obj_type

public static int H5Rget_obj_type(int loc_id,
                                  int ref_type,
                                  byte[] ref,
                                  int[] obj_type)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException,
                                  java.lang.IllegalArgumentException
H5Rget_obj_type Given a reference to an object ref, H5Rget_obj_type returns the type of the object pointed to.

Parameters:
loc_id - IN: loc_id of the reference object.
ref_type - IN: Type of reference to query.
ref - IN: the reference
obj_type - OUT:Type of referenced object
Returns:
Returns the object type, which is the same as obj_type[0]. The return value is the same as the HDF5 1.6 version.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - array is null.
java.lang.IllegalArgumentException - - array is invalid.

H5Pget_nlinks

public static long H5Pget_nlinks(int lapl_id)
                          throws HDF5LibraryException
H5Pget_nlinks retrieves the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal. This value is retrieved from the link access property list lapl_id.

Parameters:
lapl_id - IN: File access property list identifier
Returns:
Returns a Maximum number of links to traverse.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_nlinks

public static int H5Pset_nlinks(int lapl_id,
                                long nlinks)
                         throws HDF5LibraryException,
                                java.lang.IllegalArgumentException
H5Pset_nlinks sets the maximum number of soft or user-defined link traversals allowed, nlinks, before the library assumes it has found a cycle and aborts the traversal. This value is set in the link access property list lapl_id.

Parameters:
fapl_id - IN: File access property list identifier
nlinks - IN: Maximum number of links to traverse
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Argument is Illegal

H5Pget_libver_bounds

public static int H5Pget_libver_bounds(int fapl_id,
                                       int[] libver)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Pget_libver_bounds retrieves the lower and upper bounds on the HDF5 Library versions that indirectly determine the object formats versions used when creating objects in the file.

Parameters:
fapl_id - IN: File access property list identifier
libver - The earliest/latest version of the library that will be used for writing objects.
      libver[0] =  The earliest version of the library that will be used for writing objects
      libver[1] =  The latest version of the library that will be used for writing objects.
      
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.

H5Pset_libver_bounds

public static int H5Pset_libver_bounds(int fapl_id,
                                       int low,
                                       int high)
                                throws HDF5LibraryException,
                                       java.lang.IllegalArgumentException
H5Pset_libver_bounds Sets bounds on library versions, and indirectly format versions, to be used when creating objects

Parameters:
fapl_id - IN: File access property list identifier
low - IN: The earliest version of the library that will be used for writing objects
high - IN: The latest version of the library that will be used for writing objects.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Argument is Illegal

H5Pget_link_creation_order

public static int H5Pget_link_creation_order(int gcpl_id)
                                      throws HDF5LibraryException
H5Pget_link_creation_order queries the group creation property list, gcpl_id, and returns a flag indicating whether link creation order is tracked and/or indexed in a group.

Parameters:
gcpl_id - IN: Group creation property list identifier
Returns:
crt_order_flags -Creation order flag(s)
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_link_creation_order

public static int H5Pset_link_creation_order(int gcpl_id,
                                             int crt_order_flags)
                                      throws HDF5LibraryException
H5Pset_link_creation_order Sets flags in a group creation property list, gcpl_id, for tracking and/or indexing links on creation order.

Parameters:
gcpl_id - IN: Group creation property list identifier
crt_order_flags - IN: Creation order flag(s)
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_attr_creation_order

public static int H5Pget_attr_creation_order(int ocpl_id)
                                      throws HDF5LibraryException
H5Pget_attr_creation_order retrieves the settings for tracking and indexing attribute creation order on an object

Parameters:
ocpl_id - IN: Object (group or dataset) creation property list identifier
Returns:
Flags specifying whether to track and index attribute creation order
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_attr_creation_order

public static int H5Pset_attr_creation_order(int ocpl_id,
                                             int crt_order_flags)
                                      throws HDF5LibraryException
H5Pset_attr_creation_order sets flags specifying whether to track and index attribute creation order on an object.

Parameters:
ocpl_id - IN: Object creation property list identifier
crt_order_flags - IN: Flags specifying whether to track and index attribute creation order
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_copy_object

public static void H5Pset_copy_object(int ocp_plist_id,
                                      int copy_options)
                               throws HDF5LibraryException
H5Pset_copy_object Sets properties to be used when an object is copied.

Parameters:
ocp_plist_id - IN: Object copy property list identifier
copy_options - IN: Copy option(s) to be set
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_copy_object

public static int H5Pget_copy_object(int ocp_plist_id)
                              throws HDF5LibraryException
H5Pget_copy_object retrieves the properties to be used when an object is copied.

Parameters:
ocp_plist_id - IN: Object copy property list identifier
Returns:
Copy option(s) set in the object copy property list
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_create_intermediate_group

public static int H5Pset_create_intermediate_group(int lcpl_id,
                                                   boolean crt_intermed_group)
                                            throws HDF5LibraryException
H5Pset_create_intermediate_group specifies in property list whether to create missing intermediate groups

Parameters:
lcpl_id - IN: Link creation property list identifier
crt_intermed_group - IN: Flag specifying whether to create intermediate groups upon the creation of an object
Returns:
a non-negative valule if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_create_intermediate_group

public static boolean H5Pget_create_intermediate_group(int lcpl_id)
                                                throws HDF5LibraryException
H5Pget_create_intermediate_group determines whether property is set to enable creating missing intermediate groups.

Parameters:
lcpl_id - IN: Link creation property list identifier
Returns:
Boolean true or false
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_data_transform

public static int H5Pset_data_transform(int plist_id,
                                        java.lang.String expression)
                                 throws HDF5LibraryException,
                                        java.lang.NullPointerException
H5Pset_data_transform sets a data transform expression

Parameters:
plist_id - IN: Identifier of the property list or class
expression - IN: Pointer to the null-terminated data transform expression
Returns:
a non-negative valule if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - expression is null.

H5Pget_data_transform

public static long H5Pget_data_transform(int plist_id,
                                         java.lang.String[] expression,
                                         long size)
                                  throws HDF5LibraryException,
                                         java.lang.IllegalArgumentException
H5Pget_data_transform retrieves the data transform expression previously set in the dataset transfer property list plist_id by H5Pset_data_transform.

Parameters:
plist_id - IN: Identifier of the property list or class
size - IN: Number of bytes of the transform expression to copy to
expression - OUT: A data transform expression
Returns:
The size of the transform expression if successful; 0(zero) if no transform expression exists. Otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Size is <= 0.

H5Pget_elink_acc_flags

public static int H5Pget_elink_acc_flags(int lapl_id)
                                  throws HDF5LibraryException
H5Pget_elink_acc_flags retrieves the external link traversal file access flag from the specified link access property list.

Parameters:
lapl_id - IN: Link access property list identifier
Returns:
File access flag for link traversal.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_elink_acc_flags

public static int H5Pset_elink_acc_flags(int lapl_id,
                                         int flags)
                                  throws HDF5LibraryException,
                                         java.lang.IllegalArgumentException
H5Pset_elink_acc_flags Sets the external link traversal file access flag in a link access property list.

Parameters:
lapl_id - IN: Link access property list identifier
flags - IN: The access flag for external link traversal.
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Invalid Flag values.

H5Pset_link_phase_change

public static int H5Pset_link_phase_change(int gcpl_id,
                                           int max_compact,
                                           int min_dense)
                                    throws HDF5LibraryException,
                                           java.lang.IllegalArgumentException
H5Pset_link_phase_change Sets the parameters for conversion between compact and dense groups.

Parameters:
gcpl_id - IN: Group creation property list identifier
max_compact - IN: Maximum number of links for compact storage(Default: 8)
min_dense - IN: Minimum number of links for dense storage(Default: 6)
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Invalid values of max_compact and min_dense.

H5Pget_link_phase_change

public static int H5Pget_link_phase_change(int gcpl_id,
                                           int[] links)
                                    throws HDF5LibraryException,
                                           java.lang.NullPointerException
H5Pget_link_phase_change Queries the settings for conversion between compact and dense groups.

Parameters:
gcpl_id - IN: Group creation property list identifier
links - The max. no. of compact links & the min. no. of dense links, which are used for storing groups
      links[0] =  The maximum number of links for compact storage
      links[1] =  The minimum number of links for dense storage
      
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.

H5Pget_attr_phase_change

public static int H5Pget_attr_phase_change(int ocpl_id,
                                           int[] attributes)
                                    throws HDF5LibraryException,
                                           java.lang.NullPointerException
H5Pget_attr_phase_change retrieves attribute storage phase change thresholds.

Parameters:
ocpl_id - IN: : Object (dataset or group) creation property list identifier
attributes - The maximun and minimum no. of attributes to be stored.
      attributes[0] =  The maximum number of attributes to be stored in compact storage
      attributes[1] =  The minimum number of attributes to be stored in dense storage 
      
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.

H5Pget_shared_mesg_phase_change

public static int H5Pget_shared_mesg_phase_change(int fcpl_id,
                                                  int[] size)
                                           throws HDF5LibraryException,
                                                  java.lang.NullPointerException
H5Pget_shared_mesg_phase_change retrieves shared object header message phase change information.

Parameters:
fcpl_id - IN: : File creation property list identifier
size - The threshold values for storage of shared object header message indexes in a file.
      size[0] =  Threshold above which storage of a shared object header message index shifts from list to B-tree 
      size[1] =  Threshold below which storage of a shared object header message index reverts to list format  
      
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - size is null.

H5Pset_shared_mesg_phase_change

public static int H5Pset_shared_mesg_phase_change(int fcpl_id,
                                                  int max_list,
                                                  int min_btree)
                                           throws HDF5LibraryException,
                                                  java.lang.IllegalArgumentException
H5Pset_shared_mesg_phase_change sets shared object header message storage phase change thresholds.

Parameters:
fcpl_id - IN: File creation property list identifier
max_list - IN: Threshold above which storage of a shared object header message index shifts from list to B-tree
min_btree - IN: Threshold below which storage of a shared object header message index reverts to list format
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Invalid values of max_list and min_btree.

H5Pget_shared_mesg_nindexes

public static int H5Pget_shared_mesg_nindexes(int fcpl_id)
                                       throws HDF5LibraryException
H5Pget_shared_mesg_nindexes retrieves number of shared object header message indexes in file creation property list.

Parameters:
fcpl_id - IN: : File creation property list identifier
Returns:
nindexes, the number of shared object header message indexes available in files created with this property list
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_shared_mesg_nindexes

public static int H5Pset_shared_mesg_nindexes(int plist_id,
                                              int nindexes)
                                       throws HDF5LibraryException,
                                              java.lang.IllegalArgumentException
H5Pset_shared_mesg_nindexes sets the number of shared object header message indexes in the specified file creation property list.

Parameters:
plist_id - IN: File creation property list
nindexes - IN: Number of shared object header message indexes to be available in files created with this property list
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Invalid value of nindexes

H5Pset_shared_mesg_index

public static int H5Pset_shared_mesg_index(int fcpl_id,
                                           int index_num,
                                           int mesg_type_flags,
                                           int min_mesg_size)
                                    throws HDF5LibraryException,
                                           java.lang.IllegalArgumentException
H5Pset_shared_mesg_index Configures the specified shared object header message index

Parameters:
fcpl_id - IN: File creation property list identifier.
index_num - IN: Index being configured.
mesg_type_flags - IN: Types of messages that should be stored in this index.
min_mesg_size - IN: Minimum message size.
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Invalid value of nindexes

H5Pget_shared_mesg_index

public static int H5Pget_shared_mesg_index(int fcpl_id,
                                           int index_num,
                                           int[] mesg_info)
                                    throws HDF5LibraryException,
                                           java.lang.NullPointerException,
                                           java.lang.IllegalArgumentException
H5Pget_shared_mesg_index Retrieves the configuration settings for a shared message index.

Parameters:
fcpl_id - IN: File creation property list identifier
index_num - IN: Index being configured.
mesg_info - The message type and minimum message size
      mesg_info[0] =  Types of messages that may be stored in this index.
      mesg_info[1] =  Minimum message size.  
      
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - mesg_info is null.
java.lang.IllegalArgumentException - - Invalid value of nindexes

H5Pset_local_heap_size_hint

public static int H5Pset_local_heap_size_hint(int gcpl_id,
                                              int size_hint)
                                       throws HDF5LibraryException
H5Pset_local_heap_size_hint Specifies the anticipated maximum size of a local heap.

Parameters:
gcpl_id - IN: Group creation property list identifier
size_hint - IN: Anticipated maximum size in bytes of local heap
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_local_heap_size_hint

public static int H5Pget_local_heap_size_hint(int gcpl_id)
                                       throws HDF5LibraryException
H5Pget_local_heap_size_hint Retrieves the anticipated size of the local heap for original-style groups.

Parameters:
gcpl_id - IN: Group creation property list identifier
Returns:
size_hint, the anticipated size of local heap
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_nbit

public static int H5Pset_nbit(int plist_id)
                       throws HDF5LibraryException
H5Pset_nbit Sets up the use of the N-Bit filter.

Parameters:
plist_id - IN: Dataset creation property list identifier.
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_scaleoffset

public static int H5Pset_scaleoffset(int plist_id,
                                     int scale_type,
                                     int scale_factor)
                              throws HDF5LibraryException,
                                     java.lang.IllegalArgumentException
H5Pset_scaleoffset sets the Scale-Offset filter for a dataset.

Parameters:
plist_id - IN: Dataset creation property list identifier.
scale_type - IN: Flag indicating compression method.
scale_factor - IN: Parameter related to scale.
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Invalid arguments

H5Pset_est_link_info

public static int H5Pset_est_link_info(int gcpl_id,
                                       int est_num_entries,
                                       int est_name_len)
                                throws HDF5LibraryException,
                                       java.lang.IllegalArgumentException
H5Pset_est_link_info Sets estimated number of links and length of link names in a group.

Parameters:
gcpl_id - IN: Group creation property list identifier
est_num_entries - IN: Estimated number of links to be inserted into group
est_name_len - IN: Estimated average length of link names
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.IllegalArgumentException - - Invalid values to est_num_entries and est_name_len.

H5Pget_est_link_info

public static int H5Pget_est_link_info(int gcpl_id,
                                       int[] link_info)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Pget_est_link_info Queries data required to estimate required local heap or object header size.

Parameters:
gcpl_id - IN: Group creation property list identifier
link_info - Estimated number of links to be inserted into group And the estimated average length of link names
      link_info[0] =  Estimated number of links to be inserted into group
      link_info[1] =  Estimated average length of link names   
      
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - link_info is null.

H5Pset_elink_fapl

public static int H5Pset_elink_fapl(int lapl_id,
                                    int fapl_id)
                             throws HDF5LibraryException
H5Pset_elink_fapl Sets a file access property list for use in accessing a file pointed to by an external link.

Parameters:
lapl_id - IN: Link access property list identifier
fapl_id - IN: File access property list identifier
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_elink_fapl

public static int H5Pget_elink_fapl(int lapl_id)
                             throws HDF5LibraryException
H5Pget_elink_fapl Retrieves the file access property list identifier associated with the link access property list.

Parameters:
lapl_id - IN: Link access property list identifier
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pset_elink_prefix

public static int H5Pset_elink_prefix(int lapl_id,
                                      java.lang.String prefix)
                               throws HDF5LibraryException,
                                      java.lang.NullPointerException
H5Pset_elink_prefix Sets prefix to be applied to external link paths.

Parameters:
lapl_id - IN: Link access property list identifier
prefix - IN: Prefix to be applied to external link paths
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - prefix is null.

H5Pget_elink_prefix

public static long H5Pget_elink_prefix(int lapl_id,
                                       java.lang.String[] prefix)
                                throws HDF5LibraryException,
                                       java.lang.NullPointerException
H5Pget_elink_prefix Retrieves prefix applied to external link paths.

Parameters:
lapl_id - IN: Link access property list identifier
prefix - OUT: Prefix applied to external link paths
Returns:
If successful, returns a non-negative value specifying the size in bytes of the prefix without the NULL terminator; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - prefix is null.

H5Pset_fapl_direct

public static int H5Pset_fapl_direct(int fapl_id,
                                     int alignment,
                                     int block_size,
                                     int cbuf_size)
                              throws HDF5LibraryException
H5Pset_fapl_direct Sets up use of the direct I/O driver.

Parameters:
fapl_id - IN: File access property list identifier
alignment - IN: Required memory alignment boundary
block_size - IN: File system block size
cbuf_size - IN: Copy buffer size
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_fapl_direct

public static int H5Pget_fapl_direct(int fapl_id,
                                     int[] info)
                              throws HDF5LibraryException
H5Pget_fapl_direct Retrieve direct I/O settings.

Parameters:
fapl_id - IN: File access property list identifier
info[0] - = alignment OUT: Required memory alignment boundary
info[1] - = block_size OUT: File system block size
info[2] - = cbuf_size OUT: Copy buffer size
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Pget_filter

public static int H5Pget_filter(int plist,
                                int filter_number,
                                int[] flags,
                                int[] cd_nelmts,
                                int[] cd_values,
                                int namelen,
                                java.lang.String[] name,
                                int[] filter_config)
                         throws java.lang.ArrayIndexOutOfBoundsException,
                                java.lang.ArrayStoreException,
                                HDF5LibraryException,
                                java.lang.NullPointerException
H5Pget_filter returns information about a filter, specified by its filter number, in a filter pipeline, specified by the property list with which it is associated.

Parameters:
plist - IN: Property list identifier.
filter_number - IN: Sequence number within the filter pipeline of the filter for which information is sought.
flags - OUT: Bit vector specifying certain general properties of the filter.
cd_nelmts - IN/OUT: Number of elements in cd_values
cd_values - OUT: Auxiliary data for the filter.
namelen - IN: Anticipated number of characters in name.
name - OUT: Name of the filter.
filter_config - OUT:A bit field encoding the returned filter information
Returns:
the filter identification number if successful. Otherwise returns H5Z_FILTER_ERROR (-1).
Throws:
java.lang.ArrayIndexOutOfBoundsException - Fatal error on Copyback
java.lang.ArrayStoreException - Fatal error on Copyback
java.lang.NullPointerException - - name or an array is null.
HDF5LibraryException

H5Iget_type_ref

public static int H5Iget_type_ref(int type)
                           throws HDF5LibraryException
H5Iget_type_ref retrieves the reference count on an ID type. The reference count is used by the library to indicate when an ID type can be destroyed.

Parameters:
type - IN: The identifier of the type whose reference count is to be retrieved
Returns:
The current reference count on success, negative on failure.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Inmembers

public static int H5Inmembers(int type)
                       throws HDF5LibraryException
H5Inmembers returns the number of identifiers of the identifier type specified in type.

Parameters:
type - IN: Identifier for the identifier type whose member count will be retrieved
Returns:
Number of identifiers of the specified identifier type
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Acreate

public static int H5Acreate(int loc_id,
                            java.lang.String attr_name,
                            int type_id,
                            int space_id,
                            int acpl_id,
                            int aapl_id)
                     throws HDF5LibraryException,
                            java.lang.NullPointerException
H5Acreate creates an attribute, attr_name, which is attached to the object specified by the identifier loc_id.

Parameters:
loc_id - IN: Location or object identifier; may be dataset or group
attr_name - IN: Attribute name
type_id - IN: Attribute datatype identifier
space_id - IN: Attribute dataspace identifier
acpl_id - IN: Attribute creation property list identifier
aapl_id - IN: Attribute access property list identifier
Returns:
An attribute identifier if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - Name is null.

H5Aopen

public static int H5Aopen(int obj_id,
                          java.lang.String attr_name,
                          int aapl_id)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Aopen opens an existing attribute, attr_name, that is attached to an object specified an object identifier, object_id.

Parameters:
obj_id - IN: Identifer for object to which attribute is attached
attr_name - IN: Name of attribute to open
aapl_id - IN: Attribute access property list identifier
Returns:
An attribute identifier if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - Name is null.

H5Aopen_by_idx

public static int H5Aopen_by_idx(int loc_id,
                                 java.lang.String obj_name,
                                 int idx_type,
                                 int order,
                                 long n,
                                 int aapl_id,
                                 int lapl_id)
                          throws HDF5LibraryException,
                                 java.lang.NullPointerException
H5Aopen_by_idx opens an existing attribute that is attached to an object specified by location and name, loc_id and obj_name, respectively

Parameters:
loc_id - IN: Location of object to which attribute is attached
obj_name - IN: Name of object to which attribute is attached, relative to location
idx_type - IN: Type of index
order - IN: Index traversal order
n - IN: Attribute's position in index
aapl_id - IN: Attribute access property list
lapl_id - IN: Link access property list
Returns:
An attribute identifier if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - Name is null.

H5Acreate_by_name

public static int H5Acreate_by_name(int loc_id,
                                    java.lang.String obj_name,
                                    java.lang.String attr_name,
                                    int type_id,
                                    int space_id,
                                    int acpl_id,
                                    int aapl_id,
                                    int lapl_id)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Acreate_by_name creates an attribute, attr_name, which is attached to the object specified by loc_id and obj_name.

Parameters:
loc_id - IN: Location or object identifier; may be dataset or group
obj_name - IN: Name, relative to loc_id, of object that attribute is to be attached to
attr_name - IN: Attribute name
type_id - IN: Attribute datatype identifier
space_id - IN: Attribute dataspace identifier
acpl_id - IN: Attribute creation property list identifier (currently not used).
aapl_id - IN: Attribute access property list identifier (currently not used).
lapl_id - IN: Link access property list
Returns:
An attribute identifier if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Aexists_by_name

public static boolean H5Aexists_by_name(int obj_id,
                                        java.lang.String obj_name,
                                        java.lang.String attr_name,
                                        int lapl_id)
                                 throws HDF5LibraryException,
                                        java.lang.NullPointerException
H5Aexists_by_name determines whether the attribute attr_name exists on an object. That object is specified by its location and name, loc_id and obj_name, respectively.

Parameters:
loc_id - IN: Location of object to which attribute is attached .
obj_name - IN: Name, relative to loc_id, of object that attribute is attached to.
attr_name - IN: Name of attribute.
lapl_id - IN: Link access property list identifier.
Returns:
boolean true if an attribute with a given name exists, otherwise returns false.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Arename_by_name

public static int H5Arename_by_name(int loc_id,
                                    java.lang.String obj_name,
                                    java.lang.String old_attr_name,
                                    java.lang.String new_attr_name,
                                    int lapl_id)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Arename_by_name changes the name of attribute that is attached to the object specified by loc_id and obj_name. The attribute named old_attr_name is renamed new_attr_name.

Parameters:
loc_id - IN: Location or object identifier; may be dataset or group
obj_name - IN: Name of object, relative to location, whose attribute is to be renamed
old_attr_name - IN: Prior attribute name
new_attr_name - IN: New attribute name
lapl_id - IN: Link access property list
Returns:
A non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - Name is null.

H5Aget_name_by_idx

public static java.lang.String H5Aget_name_by_idx(int loc_id,
                                                  java.lang.String obj_name,
                                                  int idx_type,
                                                  int order,
                                                  long n,
                                                  int lapl_id)
                                           throws HDF5LibraryException,
                                                  java.lang.NullPointerException
H5Aget_name_by_idx retrieves the name of an attribute that is attached to an object, which is specified by its location and name, loc_id and obj_name, respectively.

Parameters:
attr_id - IN: Attribute identifier
obj_name - IN: Name of object to which attribute is attached, relative to location
idx_type - IN: Type of index
order - IN: Index traversal order
n - IN: Attribute's position in index
lapl_id - IN: Link access property list
Returns:
String for Attribute name.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - obj_name is null.

H5Aget_storage_size

public static long H5Aget_storage_size(int attr_id)
                                throws HDF5LibraryException
H5Aget_storage_size returns the amount of storage that is required for the specified attribute, attr_id.

Parameters:
attr_id - IN: Identifier of the attribute to query.
Returns:
the amount of storage size allocated for the attribute; otherwise returns 0 (zero)
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Aget_info

public static H5A_info_t H5Aget_info(int attr_id)
                              throws HDF5LibraryException
H5Aget_info retrieves attribute information, by attribute identifier.

Parameters:
attr_id - IN: Attribute identifier
Returns:
A buffer(H5A_info_t) for Attribute information
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Aget_info_by_idx

public static H5A_info_t H5Aget_info_by_idx(int loc_id,
                                            java.lang.String obj_name,
                                            int idx_type,
                                            int order,
                                            long n,
                                            int lapl_id)
                                     throws HDF5LibraryException,
                                            java.lang.NullPointerException
H5Aget_info_by_idx Retrieves attribute information, by attribute index position.

Parameters:
loc_id - IN: Location of object to which attribute is attached
obj_name - IN: Name of object to which attribute is attached, relative to location
idx_type - IN: Type of index
order - IN: Index traversal order
n - IN: Attribute's position in index
lapl_id - IN: Link access property list
Returns:
A buffer(H5A_info_t) for Attribute information
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - obj_name is null.

H5Aget_info_by_name

public static H5A_info_t H5Aget_info_by_name(int loc_id,
                                             java.lang.String obj_name,
                                             java.lang.String attr_name,
                                             int lapl_id)
                                      throws HDF5LibraryException,
                                             java.lang.NullPointerException
H5Aget_info_by_name Retrieves attribute information, by attribute name.

Parameters:
loc_id - IN: Location of object to which attribute is attached
obj_name - IN: Name of object to which attribute is attached, relative to location
attr_name - IN: Attribute name
lapl_id - IN: Link access property list
Returns:
A buffer(H5A_info_t) for Attribute information
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - obj_name is null.

H5Adelete_by_name

public static int H5Adelete_by_name(int loc_id,
                                    java.lang.String obj_name,
                                    java.lang.String attr_name,
                                    int lapl_id)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Adelete_by_name removes the attribute attr_name from an object specified by location and name, loc_id and obj_name, respectively.

Parameters:
loc_id - IN: Location or object identifier; may be dataset or group
obj_name - IN: Name of object, relative to location, from which attribute is to be removed
attr_name - IN: Name of attribute to delete
lapl_id - IN: Link access property list identifier.
Returns:
a non-negative value if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Aexists

public static boolean H5Aexists(int obj_id,
                                java.lang.String attr_name)
                         throws HDF5LibraryException,
                                java.lang.NullPointerException
H5Aexists determines whether the attribute attr_name exists on the object specified by obj_id.

Parameters:
obj_id - IN: Object identifier.
attr_name - IN: Name of the attribute.
Returns:
boolean true if an attribute with a given name exists.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - attr_name is null.

H5Adelete_by_idx

public static void H5Adelete_by_idx(int loc_id,
                                    java.lang.String obj_name,
                                    int idx_type,
                                    int order,
                                    long n,
                                    int lapl_id)
                             throws HDF5LibraryException,
                                    java.lang.NullPointerException
H5Adelete_by_idx removes an attribute, specified by its location in an index, from an object.

Parameters:
loc_id - IN: Location or object identifier; may be dataset or group
obj_name - IN: Name of object, relative to location, from which attribute is to be removed
idx_type - IN: Type of index
order - IN: Order in which to iterate over index
n - IN: Offset within index
lapl_id - IN: Link access property list identifier
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - obj_name is null.

H5Aopen_by_name

public static int H5Aopen_by_name(int loc_id,
                                  java.lang.String obj_name,
                                  java.lang.String attr_name,
                                  int aapl_id,
                                  int lapl_id)
                           throws HDF5LibraryException,
                                  java.lang.NullPointerException
H5Aopen_by_name Opens an attribute for an object by object name and attribute name

Parameters:
loc_id - IN: Location from which to find object to which attribute is attached
obj_name - IN: Name of object to which attribute is attached, relative to loc_id
attr_name - IN: Name of attribute to open
aapl_id - IN: Attribute access property list
lapl_id - IN: Link access property list identifier
Returns:
Returns an attribute identifier if successful; otherwise returns a negative value.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - obj_name is null.

H5Oopen

public static int H5Oopen(int loc_id,
                          java.lang.String name,
                          int lapl_id)
                   throws HDF5LibraryException,
                          java.lang.NullPointerException
H5Oopen opens a group, dataset, or named datatype specified by a location and a path name.

Parameters:
loc_id - IN: File or group identifier
name - IN: Relative path to the object
lapl_id - IN: Access property list identifier for the link pointing to the object
Returns:
an object identifier for the opened object
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

_H5Oopen

public static int _H5Oopen(int loc_id,
                           java.lang.String name,
                           int lapl_id)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
Throws:
HDF5LibraryException
java.lang.NullPointerException

H5Ocopy

public static void H5Ocopy(int src_loc_id,
                           java.lang.String src_name,
                           int dst_loc_id,
                           java.lang.String dst_name,
                           int ocpypl_id,
                           int lcpl_id)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Ocopy copies the group, dataset or named datatype specified from the file or group specified by source location to the destination location.

Parameters:
src_loc_id - IN: Object identifier indicating the location of the source object to be copied
src_name - IN: Name of the source object to be copied
dst_loc_id - IN: Location identifier specifying the destination
dst_name - IN: Name to be assigned to the new copy
ocpypl_id - IN: Object copy property list
lcpl_id - IN: Link creation property list for the new hard link
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Oget_info

public static H5O_info_t H5Oget_info(int loc_id)
                              throws HDF5LibraryException,
                                     java.lang.NullPointerException
H5Oget_info retrieves the metadata for an object specified by an identifier.

Parameters:
loc_id - IN: Identifier for target object
Returns:
object information
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Oget_info_by_name

public static H5O_info_t H5Oget_info_by_name(int loc_id,
                                             java.lang.String name,
                                             int lapl_id)
                                      throws HDF5LibraryException,
                                             java.lang.NullPointerException
H5Oget_info_by_name retrieves the metadata for an object, identifying the object by location and relative name.

Parameters:
loc_id - IN: File or group identifier specifying location of group in which object is located
name - IN: Relative name of group
lapl_id - IN: Access property list identifier for the link pointing to the object (Not currently used; pass as H5P_DEFAULT.)
Returns:
object information
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Oget_info_by_idx

public static H5O_info_t H5Oget_info_by_idx(int loc_id,
                                            java.lang.String group_name,
                                            int idx_type,
                                            int order,
                                            long n,
                                            int lapl_id)
                                     throws HDF5LibraryException,
                                            java.lang.NullPointerException
H5Oget_info_by_idx retrieves the metadata for an object, identifying the object by an index position.

Parameters:
loc_id - IN: File or group identifier
group_name - IN: Name of group, relative to loc_id, in which object is located
idx_type - IN: Type of index by which objects are ordered
order - IN: Order of iteration within index
n - IN: Object to open
lapl_id - IN: Access property list identifier for the link pointing to the object (Not currently used; pass as H5P_DEFAULT.)
Returns:
object information
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Olink

public static void H5Olink(int obj_id,
                           int new_loc_id,
                           java.lang.String new_name,
                           int lcpl_id,
                           int lapl_id)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Olink creates a new hard link to an object in an HDF5 file.

Parameters:
obj_id - IN: Object to be linked.
new_loc_id - IN: File or group identifier specifying location at which object is to be linked.
name - IN: Relative name of link to be created.
lcpl_id - IN: Link creation property list identifier.
lapl_id - IN: Access property list identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Oset_comment

public static void H5Oset_comment(int obj_id,
                                  java.lang.String comment)
                           throws HDF5LibraryException
H5Oset_comment sets the comment for the specified object.

Parameters:
obj_id - IN: Identifier of the target object
comment - IN: The new comment.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Oset_comment_by_name

public static void H5Oset_comment_by_name(int loc_id,
                                          java.lang.String name,
                                          java.lang.String comment,
                                          int lapl_id)
                                   throws HDF5LibraryException,
                                          java.lang.NullPointerException
H5Oset_comment_by_name sets the comment for the specified object.

Parameters:
loc_id - IN: Identifier of a file, group, dataset, or named datatype.
name - IN: Relative name of the object whose comment is to be set or reset.
comment - IN: The new comment.
lapl_id - IN: Link access property list identifier.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Oget_comment

public static java.lang.String H5Oget_comment(int obj_id)
                                       throws HDF5LibraryException
H5Oget_comment retrieves the comment for the specified object.

Parameters:
obj_id - IN: File or group identifier
Returns:
the comment
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.

H5Oget_comment_by_name

public static java.lang.String H5Oget_comment_by_name(int loc_id,
                                                      java.lang.String name,
                                                      int lapl_id)
                                               throws HDF5LibraryException,
                                                      java.lang.NullPointerException
H5Oget_comment_by_name retrieves the comment for an object.

Parameters:
loc_id - IN: Identifier of a file, group, dataset, or named datatype.
name - IN: Relative name of the object whose comment is to be set or reset.
lapl_id - IN: Link access property list identifier.
Returns:
the comment
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Ovisit

public static int H5Ovisit(int obj_id,
                           int idx_type,
                           int order,
                           H5O_iterate_cb op,
                           H5O_iterate_t op_data)
                    throws HDF5LibraryException,
                           java.lang.NullPointerException
H5Ovisit recursively visits all objects accessible from a specified object.

Parameters:
obj_id - IN: Identifier of the object at which the recursive iteration begins.
idx_type - IN: Type of index
order - IN: Order of iteration within index
op - IN: Callback function passing data regarding the object to the calling application
op_data - IN: User-defined pointer to data required by the application for its processing of the object
Returns:
returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Ovisit_by_name

public static int H5Ovisit_by_name(int loc_id,
                                   java.lang.String obj_name,
                                   int idx_type,
                                   int order,
                                   H5O_iterate_cb op,
                                   H5O_iterate_t op_data,
                                   int lapl_id)
                            throws HDF5LibraryException,
                                   java.lang.NullPointerException
H5Ovisit_by_name recursively visits all objects starting from a specified object.

Parameters:
loc_id - IN: File or group identifier
obj_name - IN: Relative path to the object
idx_type - IN: Type of index
order - IN: Order of iteration within index
op - IN: Callback function passing data regarding the object to the calling application
op_data - IN: User-defined pointer to data required by the application for its processing of the object
lapl_id - IN: Link access property list identifier
Returns:
returns the return value of the first operator that returns a positive value, or zero if all members were processed with no operator returning non-zero.
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.
java.lang.NullPointerException - - name is null.

H5Oclose

public static int H5Oclose(int object_id)
                    throws HDF5LibraryException
H5Oclose closes the group, dataset, or named datatype specified.

Parameters:
object_id - IN: Object identifier
Returns:
none
Throws:
HDF5LibraryException - - Error from the HDF-5 Library.