From f87dbef4ca00da7bb9b89faf3d982156878c600d Mon Sep 17 00:00:00 2001 From: Frank Baker Date: Fri, 10 Jul 1998 12:00:32 -0500 Subject: [svn-r479] Updates for Alpha2. Add missing functions. General technical edit. --- doc/src/RM_H5A.html | 355 ++++++++++++++++------------------ doc/src/RM_H5E.html | 212 ++++++++------------- doc/src/RM_H5F.html | 9 +- doc/src/RM_H5T.html | 534 +++++++++++++++++++++++++++++++++++++++++++++++----- 4 files changed, 735 insertions(+), 375 deletions(-) diff --git a/doc/src/RM_H5A.html b/doc/src/RM_H5A.html index a6738e4..a3b46c1 100644 --- a/doc/src/RM_H5A.html +++ b/doc/src/RM_H5A.html @@ -39,6 +39,23 @@ and information about attributes. +

+The Attribute interface, H5A, is primarily designed to easily allow +small datasets to be attached to primary datasets as metadata information. +Additional goals for the H5A interface include keeping storage requirement +for each attribute to a minimum and easily sharing attributes among +datasets. +

+Because attributes are intended to be small objects, large datasets +intended as additional information for a primary dataset should be +stored as supplemental datasets in a group with the primary dataset. +Attributes can then be attached to the group containing everything +to indicate a particular type of dataset with supplemental datasets +is located in the group. How small is "small" is not defined by the +library and is up to the user's interpretation. +

+See Attributes in the +HDF5 User's Guide for further information.

@@ -46,58 +63,42 @@ and information about attributes.
Signature:
hid_t H5Acreate(hid_t loc_id, const char *name, - hid_t datatype, - hid_t dataspace, + hid_t type_id, + hid_t space_id, hid_t create_plist )
Purpose: -
Creates a dataset as an attribute of another dataset or group. +
Creates a dataset as an attribute of another group, dataset, + or named datatype.
Description: -
SC: H5Acreate creates an attribute which is attached to the object - specified with 'location_id'. The name specified with 'name' for each - attribute for an object must be unique for that object. The 'type_id' - and 'space_id' are created with the H5T and H5S interfaces respectively. - Currently only simple dataspaces are allowed for attribute dataspaces. - The 'create_plist_id' property list is currently un-used, but will be - used int the future for optional properties of attributes. The attribute - identifier returned from this function must be released with H5Aclose or resource - leaks will develop. -

- The link created (see H5G API documentation for more information on - link types) is a hard link, so the attribute may be shared among datasets - and will not be removed from the file until the reference count for the - attribute is reduced to zero. -

- The location object may be either a group or a dataset, both of - which may have any sort of attribute. -

- UG: H5Acreate creates an attribute which is attached to the object - specified with loc_id. The name specified with name - for each attribute for an object must be unique for that object. The type_id - and space_id are created with the H5T and H5S interfaces - respectively. Currently only simple dataspaces are allowed for attribute - dataspaces. The create_plist_id property list is currently - unused, but will be used int the future for optional properties of - attributes. The attribute identifier returned from this function must be released - with H5Aclose or resource leaks will develop. Attempting to create an - attribute with the same name as an already existing attribute will fail, - leaving the pre-existing attribute in place. -

- datatype, dataspace, create_plist in the UG are - type_id, space_id, and create_plist_id, respectively, in the SC -

+

H5Acreate creates an attribute which is attached + to the object specified with loc_id. + loc_id is an identifier of a group, dataset, + or named datatype. The name specified with name + for each attribute for an object must be unique for that object. + The datatype and dataspace identifiers of the attribute, + type_id and space_id, respectively, + are created with the H5T and H5S interfaces, respectively. + Currently only simple dataspaces are allowed for attribute + dataspaces. The create_plist_id property list + is currently unused, but will be used int the future for optional + properties of attributes. The attribute identifier returned from + this function must be released with H5Aclose or + resource leaks will develop. Attempting to create an attribute + with the same name as an already existing attribute will fail, + leaving the pre-existing attribute in place.
Parameters:
hid_t loc_id -
IN: Object (dataset or group) to be attached to +
IN: Object (dataset or group) to be attached to.
const char *name -
IN: Name of attribute to create -
hid_t datatype -
IN: Identifier of datatype for attribute -
hid_t dataspace -
IN: Identifier of dataspace for attribute +
IN: Name of attribute to create. +
hid_t type_id +
IN: Identifier of datatype for attribute. +
hid_t space_id +
IN: Identifier of dataspace for attribute.
hid_t create_plist -
IN: Identifier of creation property list (currently not used) +
IN: Identifier of creation property list (currently not used).
Returns:
Returns an attribute identifier if successful; @@ -113,26 +114,23 @@ and information about attributes. const char *name )
Purpose: -
Opens an attribute for an object by looking up the attribute name. +
Opens an attribute specified by name.
Description: -
SC: H5Aopen_name opens an existing attribute for access. The attribute - name specified is used to look up the corresponding attribute for the - object. The attribute identifier returned from this function must be released with - H5Aclose or resource leaks will develop. -

- The location object may be either a group or a dataset, both of - which may have any sort of attribute. -

- UG: H5Aopen_name opens an attribute which is attached to the object - specified with loc_id. The name specified with name indicates the - attribute to access. The attribute identifier returned from this function must - be released with H5Aclose or resource leaks will develop. +

H5Aopen_name opens an attribute specified by + its name, name, which is attached to the + object specified with loc_id. + The location object may be either a group, dataset, or + named datatype, which may have any sort of attribute. + The attribute identifier returned from this function must + be released with H5Aclose or resource leaks + will develop.
Parameters:
hid_t loc_id -
IN: Object (dataset or group) to be attached to +
IN: Identifier of a group, dataset, or named datatype + atttribute to be attached to.
const char *name -
IN: Name of attribute to locate and open +
IN: Attribute name.
Returns:
Returns attribute identifier if successful; @@ -148,27 +146,24 @@ and information about attributes. unsigned int idx )
Purpose: -
Opens the nth attribute for an object. +
Opens the attribute specified by its index.
Description: -
SC: H5Aopen_idx opens an existing attribute for access. The attribute - index specified is used to look up the corresponding attribute for the - object. The attribute identifier returned from this function must be released with - H5Aclose or resource leaks will develop. -

- The location object may be either a group or a dataset, both of - which may have any sort of attribute. -

- UG: H5Aopen_idx opens an attribute which is attached to the object - specified with loc_id. The attribute specified with idx indicates the - idxth attribute to access, starting with '0'. - The attribute identifier returned from this function must be released with - H5Aclose or resource leaks will develop. +

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. + The attribute specified by the index, idx, + indicates the attribute to access. + The value of idx is a 0-based, non-negative integer. + The attribute identifier returned from this function must be + released with H5Aclose or resource leaks will develop.
Parameters:
hid_t loc_id -
IN: Object (dataset or group) to be attached to +
IN: Identifier of the group, dataset, or named datatype + attribute to be attached to.
unsigned int idx -
IN: Index (0-based) attribute to open +
IN: Index of the attribute to open.
Returns:
Returns attribute identifier if successful; @@ -181,29 +176,24 @@ and information about attributes.
Name: H5Awrite
Signature:
herr_t H5Awrite(hid_t attr_id, - hid_t mem_dt, + hid_t mem_type_id, void *buf )
Purpose: -
Write out data to an attribute. +
Writes data to an attribute.
Description: -
SC: H5Awrite writes a complete attribute to disk. -

- UG: H5Awrite writes an attribute, specified with attr_id, - with mem_type_id specifying the datatype in memory. - The entire attribute is written from buf to the file. - This function returns non-negative on success, negative on failure. -

- mem_dt in SC is mem_type_id in UG. -

+

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:
hid_t attr_id -
IN: Attribute to write -
hid_t mem_dt -
IN: Memory datatype of buffer +
IN: Identifier of an attribute to write. +
hid_t mem_type_id +
IN: Identifier of the attribute datatype (in memory).
void *buf -
IN: Buffer of data to write +
IN: Data to be written.
Returns:
Returns SUCCEED (0) if successful; @@ -216,29 +206,24 @@ and information about attributes.
Name: H5Aread
Signature:
herr_t H5Aread(hid_t attr_id, - hid_t mem_dt, + hid_t mem_type_id, void *buf )
Purpose: -
Read in data from an attribute. +
Reads an attribute.
Description: -
SC: H5Aread reads a complete attribute from disk. -

- UG: H5Aread reads an attribute, specified with attr_id, - with mem_type_id specifying the datatype in memory. - The entire attribute is read into buf from the file. - This function returns non-negative on success, negative on failure. -

- mem_dt in SC is mem_type_id in UG. -

+

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:
hid_t attr_id -
IN: Attribute to read -
hid_t mem_dt -
IN: Memory datatype of buffer +
IN: Identifier of an attribute to read. +
hid_t mem_type_id +
IN: Identifier of the attribute datatype (in memory).
void *buf -
IN: Buffer for data to read +
IN: Buffer for data to be read.
Returns:
Returns SUCCEED (0) if successful; @@ -254,19 +239,17 @@ and information about attributes.
Purpose:
Gets a copy of the dataspace for an attribute.
Description: -
H5Aget_space retrieves a copy of the dataspace for an attribute. - The dataspace identifier returned from this function must be released with H5Sclose +
H5Aget_space retrieves a copy of the dataspace + for an attribute. The dataspace identifier returned from + this function must be released with H5Sclose or resource leaks will develop. -

- (Identical desc in UG and SC.) -

Parameters:
hid_t attr_id -
IN: Attribute to get dataspace of +
IN: Identifier of an attribute.
Returns: -
Returns dataspace identifier if successful; +
Returns attribute dataspace identifier if successful; otherwise FAIL (-1).
@@ -277,18 +260,22 @@ and information about attributes.
Signature:
hid_t H5Aget_type(hid_t attr_id)
Purpose: -
Gets a copy of the datatype for an attribute. +
Gets an attribute datatype.
Description: -
H5Aget_type retrieves a copy of the datatype for an attribute. - The datatype identifier returned from this function must be released with - H5Tclose or resource leaks will develop. +
H5Aget_type retrieves a copy of the datatype + for an attribute.

- (Identical desc in UG and SC.) + The datatype is reopened if it is a named type before returning + it to the application. The datatypes returned by this function + are always read-only. If an error occurs when atomizing the + return datatype, then the datatype is closed.

+ The datatype identifier returned from this function must be + released with H5Tclose or resource leaks will develop.

Parameters:
hid_t attr_id -
IN: Attribute to get datatype of +
IN: Identifier of an attribute.
Returns:
Returns a datatype identifier if successful; @@ -305,24 +292,23 @@ and information about attributes. size_t buf_size )
Purpose: -
Gets a copy of the name for an attribute. +
Gets an attribute name.
Description: -
H5Aget_name retrieves the name of an attribute for an attribute identifier. - Up to 'buf_size' characters are stored in 'buf' followed by a '\0' string - terminator. If the name of the attribute is longer than 'buf_size'-1, - the string terminator is stored in the last position of the buffer to - properly terminate the string. -

- (Identical desc in UG and SC.) -

+

H5Aget_name retrieves the name of an attribute + specified by the identifier, attr_id. + Up to buf_size characters are stored in + buf followed by a \0 string + terminator. If the name of the attribute is longer than + buf_size -1, the string terminator is stored in the + last position of the buffer to properly terminate the string.
Parameters:
hid_t attr_id -
IN: Attribute to get name of +
IN: Identifier of the attribute.
char *buf -
IN: Buffer to store name in +
IN: Buffer to store name in.
size_t buf_size -
IN: The size of the buffer to store the string in +
IN: The size of the buffer to store the name in.
Returns:
Returns the length of the attribute's name, which may be @@ -339,15 +325,14 @@ and information about attributes.
Purpose:
Determines the number of attributes attached to an object.
Description: -
H5Anum_attrs returns the number of attributes attached to the dataset or - group, loc_id. -

- (Identical desc in UG and SC.) -

+

H5Anum_attrs returns the number of attributes + attached to the object specified by its identifier, + loc_id. + The object can be a group, dataset, or named datatype.
Parameters:
hid_t loc_id -
IN: The object, a dataset or group, to be queried +
IN: Identifier of a group, dataset, or named datatype.
Returns:
Returns the number of attributes if successful; @@ -360,49 +345,37 @@ and information about attributes.
Name: H5Aiterate
Signature:
int H5Aiterate(hid_t loc_id, - unsigned * attr_num, + unsigned * idx, H5A_operator_t op, void *op_data )
Purpose:
Calls a user's function for each attribute on an object.
Description: -
SC: H5Aiterate interates over the attributes of dataset or group - specified with 'loc_id'. For each attribute of the object, the - 'op_data' and some additional information (specified below) are passed - to the 'op' function. The iteration begins with the '*attr_number' - object in the group and the next attribute to be processed by the operator - is returned in '*attr_number'. -

- The operation receives the identifier for the group or dataset being iterated - over ('loc_id'), the name of the current attribute about the object - ('attr_name') and the pointer to the operator data passed in to H5Aiterate - ('op_data'). The return values from an operator are: -

-
UG: H5Aiterate interates over the attributes of dataset or group - specified with loc_id. For each attribute of the object, - the operator_data and some additional information (specified below) - are passed to the operator function. The iteration begins with - the *attr_number object in the group and the next attribute to be - processed by the operator is returned in *attr_number. +
H5Aiterate iterates over the attributes of + the object specified by its identifier, loc_id. + The object can be a group, dataset, or named datatype. + For each attribute of the object, the op_data + and some additional information specified below are passed + to the operator function op. + The iteration begins with the attribute specified by its + index, idx; the index for the next attribute + to be processed by the operator, op, is + returned in idx. + If idx is the null pointer, then all attributes + are processed.

- The prototype for H5A_operator_t is:
+ The prototype for H5A_operator_t is:
typedef herr_t (*H5A_operator_t)(hid_t loc_id, - const char *attr_name, void *operator_data); + const char *attr_name, + void *operator_data); +

- The operation receives the identifier for the group or dataset being iterated over - (loc_id), the name of the current attribute about the object (attr_name) - and the pointer to the operator data passed in to H5Aiterate - (operator_data). The return values from an operator are: + The operation receives the identifier for the group, dataset + or named datatype being iterated over, loc_id, the + name of the current attribute about the object, attr_name, + and the pointer to the operator data passed in to H5Aiterate, + op_data. The return values from an operator are:

-
attr_num, op, and op_data in SC are - attr_number, operator, and operator_data, respectively, in UG. -

Parameters:
hid_t loc_id -
IN: Object (dataset or group) to be iterated over -
unsigned * attr_num -
IN/OUT: Starting (IN) & Ending (OUT) attribute number +
IN: Identifier of a group, dataset or named datatype. +
unsigned * idx +
IN/OUT: Starting (IN) and ending (OUT) attribute index.
H5A_operator_t op
IN: User's function to pass each attribute to
void *op_data @@ -444,22 +414,19 @@ and information about attributes.
Purpose:
Deletes an attribute from a location.
Description: -
SC: H5Adelete removes the named attribute from a dataset or group. - This function should not be used when attribute identifiers are open on 'loc_id' - as it may cause the internal indexes of the attributes to change and future - writes to the open attributes to produce incorrect results. -

- UG: H5Adelete removes the named attribute from a dataset or group. - This function should not be used when attribute identifiers are open on loc_id as - it may cause the internal indexes of the attributes to change and future - writes to the open attributes to produce incorrect results. - Returns non-negative on success, negative on failure. +

H5Adelete removes the attribute specified by its + name, name, from a dataset, group, or named datatype. + This function should not be used when attribute identifiers are + open on loc_id as it may cause the internal indexes + of the attributes to change and future writes to the open + attributes to produce incorrect results.
Parameters:
hid_t loc_id -
IN: Object (dataset or group) to have attribute deleted from +
IN: Identifier of the dataset, group, or named datatype + to have the attribute deleted from.
const char *name -
IN: Name of attribute to delete +
IN: Name of the attribute to delete.
Returns:
Returns SUCCEED (0) if successful; @@ -473,18 +440,16 @@ and information about attributes.
Signature:
herr_t H5Aclose(hid_t attr_id)
Purpose: -
Close an attribute identifier. +
Closes the specified attribute.
Description: -
SC: H5Aclose releases an attribute from use. Further use of the - attribute identifier will result in undefined behavior. -

- UG: H5Aclose releases an attribute from use. - Further use of the attribute identifier will result in undefined behavior. - This function returns non-negative on success, negative on failure. +

H5Aclose terminates access to the attribute + specified by its identifier, attr_id. + Further use of the attribute identifier will result in + undefined behavior.
Parameters:
hid_t attr_id -
IN: Attribute to release access to +
IN: Attribute to release access to.
Returns:
Returns SUCCEED (0) if successful; diff --git a/doc/src/RM_H5E.html b/doc/src/RM_H5E.html index 0065e90..4c70b6a 100644 --- a/doc/src/RM_H5E.html +++ b/doc/src/RM_H5E.html @@ -12,30 +12,6 @@ HDF5/H5E Draft API Specification

Error API Functions

These functions provide error handling capabilities in the HDF5 environment. -

-Provides error handling in the form of a stack. The FUNC_ENTER() macro -clears the error stack whenever an API function is entered. When an error -is detected, an entry is pushed onto the stack. As the functions unwind -additional entries are pushed onto the stack. The API function will return -some indication that an error occurred and the application can print the -error stack. -

-Certain API functions in the H5E package (such as H5Eprint()) -do not clear the error stack. Otherwise, any function which -doesn't have an underscore immediately after the package name -will clear the error stack. For instance, H5Fopen() clears -the error stack while H5F_open() does not. -

-An error stack has a fixed maximum size. If this size is -exceeded then the stack will be truncated and only the -inner-most functions will have entries on the stack. This is -expected to be a rare condition. -

-Each thread has its own error stack, but since -multi-threading has not been added to the library yet, this -package maintains a single error stack. The error stack is -statically allocated to reduce the complexity of handling -errors within the H5E package.
@@ -58,6 +34,32 @@ errors within the H5E package.
+

+The Error interface provides error handling in the form of a stack. +The FUNC_ENTER() macro clears the error stack whenever +an interface function is entered. +When an error is detected, an entry is pushed onto the stack. +As the functions unwind, additional entries are pushed onto the stack. +The API function will return some indication that an error occurred and +the application can print the error stack. +

+Certain API functions in the H5E package, such as H5Eprint(), +do not clear the error stack. Otherwise, any function which +does not have an underscore immediately after the package name +will clear the error stack. For instance, H5Fopen() +clears the error stack while H5F_open() does not. +

+An error stack has a fixed maximum size. +If this size is exceeded then the stack will be truncated and only the +inner-most functions will have entries on the stack. +This is expected to be a rare condition. +

+Each thread has its own error stack, but since +multi-threading has not been added to the library yet, this +package maintains a single error stack. The error stack is +statically allocated to reduce the complexity of handling +errors within the H5E package. +

@@ -69,34 +71,19 @@ errors within the H5E package.
Purpose:
Turns automatic error printing on or off.
Description: -
SC: H5Eset_auto turns on or off automatic printing of errors. - When turned on (non-null func pointer), +
H5Eset_auto turns on or off automatic printing of + errors. When turned on (non-null func pointer), any API function which returns an error indication will first call func, passing it client_data as an argument.

- The default values before this function is called are - H5Eprint() with client data being the standard error stream, - stderr. -

- Automatic stack traversal is always in the H5E_WALK_DOWNWARD - direction. -

- UG: If func is not a null pointer, then the function to - which it points will be called automatically when an API - function is about to return an indication of failure. The - function is called with a single argument, the - client_data pointer. When the library is first - initialized the auto printing function is set to - H5Eprint() (cast appropriately) and - client_data is the standard error stream pointer, - stderr. -

- UG signature line reads -
herr_t H5Eset_auto (herr_t(*func)(void*), - void *client_data). -
The UG signature line for H5Eget_auto reads similarly. + When the library is first initialized the auto printing function + is set to H5Eprint() (cast appropriately) and + client_data is the standard error stream pointer, + stderr.

+ Automatic stack traversal is always in the + H5E_WALK_DOWNWARD direction.

Parameters:
H5E_auto_t func @@ -121,14 +108,10 @@ errors within the H5E package.
Returns the current settings for the automatic error stack traversal function and its data.
Description: -
SC: H5Eget_auto returns the current settings for the automatic error stack - traversal function and its data. Either (or both) arguments - may be null in which case the value is not returned. -

- UG: This function returns the current automatic error traversal - settings through the func and client_data - arguments. Either (or both) arguments may be null pointers in - which case the corresponding information is not returned. +

H5Eget_auto returns the current settings for the + automatic error stack traversal function, func, + and its data, client_data. Either (or both) + arguments may be null in which case the value is not returned.
Parameters:
H5E_auto_t * func @@ -151,19 +134,16 @@ errors within the H5E package.
Purpose:
Clears the error stack for the current thread.
Description: -
SC: H5Eclear clears the error stack for the current thread. +
H5Eclear clears the error stack for the current thread.

- This function can fail if there are problems initializing the library. + The stack is also cleared whenever an API function is called, + with certain exceptions (for instance, H5Eprint()).

- UG: The error stack can be explicitly cleared by calling this - function. The stack is also cleared whenever an API function - is called, with certain exceptions (for instance, - H5Eprint()). + H5Eclear can fail if there are problems initializing + the library.

Parameters:
-
paramtype param -
xxx -
Should this say "None"? +
None
Returns:
Returns SUCCEED (0) if successful; @@ -179,18 +159,19 @@ errors within the H5E package.
Purpose:
Prints the error stack in a default manner.
Description: -
SC: H5Eprint prints the error stack in some default way. This is just a - convenience function for H5Ewalk() with a function that - prints error messages. Users are encouraged to write there - own more specific error handlers. +
H5Eprint prints the error stack on the specified + stream, stream. + Even if the error stack is empty, a one-line message will be printed: +
     + HDF5-DIAG: Error detected in thread 0.

- UG: The error stack is printed on the specified stream. Even if - the error stack is empty a one-line message will be printed: - HDF5-DIAG: Error detected in thread 0. + H5Eprint is a convenience function for + H5Ewalk() with a function that prints error messages. + Users are encouraged to write there own more specific error handlers.

Parameters:
FILE * stream -
xxx +
File pointer, or stderr if NULL.
Returns:
Returns SUCCEED (0) if successful; @@ -210,7 +191,7 @@ errors within the H5E package.
Walks the error stack for the current thread, calling a specified function.
Description: -
SC: H5Ewalk walks the error stack for the current thread +
H5Ewalk walks the error stack for the current thread and calls the specified function for each error along the way.

direction determines whether the stack is walked @@ -222,22 +203,13 @@ errors within the H5E package. detected.

func will be called for each error in the error stack. - It's arguments will include an index number (beginning at zero + Its arguments will include an index number (beginning at zero regardless of stack traversal direction), an error stack entry, and the client_data pointer passed to H5E_print.

- H5Ewalk can fail if there are problems initializing the library. -

- UG: The error stack is traversed and func is called for - each member of the stack. Its arguments are an integer - sequence number beginning at zero (regardless of - direction), a pointer to an error description record, - and the client_data pointer. If direction - is H5E_WALK_UPWARD then traversal begins at the - inner-most function that detected the error and concludes with - the API function. The opposite order is - H5E_WALK_DOWNWARD. + H5Ewalk can fail if there are problems initializing + the library.

Parameters:
H5E_direction_t direction @@ -265,26 +237,26 @@ errors within the H5E package.
Default error stack traversal callback function that prints error messages to the specified output stream.
Description: -
H5Ewalk_cb is a default error stack traversal callback function - that prints error messages to the specified output stream. +
H5Ewalk_cb is a default error stack traversal callback + function that prints error messages to the specified output stream. It is not meant to be called directly but rather as an - argument to the H5Ewalk() function. This function is called - also by H5Eprint(). Application writers are encouraged to - use this function as a model for their own error stack - walking functions. + argument to the H5Ewalk() function. + This function is called also by H5Eprint(). + Application writers are encouraged to use this function as a + model for their own error stack walking functions.

- n is a counter for how many times this function has been - called for this particular traversal of the stack. It always - begins at zero for the first error on the stack (either the - top or bottom error, or even both, depending on the traversal - direction and the size of the stack). + n is a counter for how many times this function + has been called for this particular traversal of the stack. + It always begins at zero for the first error on the stack + (either the top or bottom error, or even both, depending on + the traversal direction and the size of the stack).

- ERR_DESC is an error description. It contains all the + err_desc is an error description. It contains all the information about a particular error.

- CLIENT_DATA is the same pointer that was passed as the - CLIENT_DATA argument of H5Ewalk(). It is expected to be a - file pointer (or stderr if null). + client_data is the same pointer that was passed as the + client_data argument of H5Ewalk(). + It is expected to be a file pointer (or stderr if null).

Parameters:
int n @@ -293,7 +265,7 @@ errors within the H5E package.
H5E_error_t *err_desc
Error description.
void *client_data -
A file pointer, or stderr if null. +
A file pointer, or stderr if null.
Returns:
Returns SUCCEED (0) if successful; @@ -307,27 +279,18 @@ errors within the H5E package.
Signature:
const char * H5Eget_major(H5E_major_t n)
Purpose: -
Returns a character string describing a major error. +
Returns a character string describing an error specified by a + major error number.
Description: -
Given a major error number, H5Eget_major returns a constant character string - that describes the error. +
Given a major error number, H5Eget_major returns a + constant character string that describes the error.
Parameters:
H5E_major_t n
Major error number.
Returns: -
Returns a pointer to a character string if successful. - Otherwise returns a pointer to "Invalid major error number". -
- ...or how about... -
- Returns a pointer to a character string describing the error if successful. - Otherwise returns a pointer to "Invalid major error number". -
- ...or ... -
- Returns a character string describing the error if successful. +
Returns a character string describing the error if successful. Otherwise returns "Invalid major error number."
@@ -338,27 +301,18 @@ errors within the H5E package.
Signature:
const char * H5Eget_minor(H5E_minor_t n)
Purpose: -
Returns a character string describing a minor error. +
Returns a character string describing an error specified by a + minor error number.
Description: -
Given a minor error number, H5Eget_minor returns a constant character string - that describes the error. +
Given a minor error number, H5Eget_minor returns a + constant character string that describes the error.
Parameters:
H5E_minor_t n
Minor error number.
Returns: -
Returns a pointer to a character string if successful. - Otherwise returns a pointer to "Invalid minor error number". -
- ...or how about... -
- Returns a pointer to a character string describing the error if successful. - Otherwise returns a pointer to "Invalid minor error number". -
- ...or ... -
- Returns a character string describing the error if successful. +
Returns a character string describing the error if successful. Otherwise returns "Invalid minor error number."
diff --git a/doc/src/RM_H5F.html b/doc/src/RM_H5F.html index 912df51..f8e25f4 100644 --- a/doc/src/RM_H5F.html +++ b/doc/src/RM_H5F.html @@ -24,11 +24,12 @@ documented below.               @@ -70,8 +71,8 @@ documented below. access_template. Use 0 for default access template.
Returns: -
An ID (of type hid_t) for the file upon success, - otherwise negative +
A file identifier if successful; + otherwise FAIL (-1).
diff --git a/doc/src/RM_H5T.html b/doc/src/RM_H5T.html index 46fe6fc..4221e93 100644 --- a/doc/src/RM_H5T.html +++ b/doc/src/RM_H5T.html @@ -17,6 +17,17 @@ of a dataset.
+

+The Datatype interface, H5T, provides a mechanism to describe the + storage format of individual data points of a data set and is + hopefully designed in such a way as to allow new features to be + easily added without disrupting applications that use the data + type interface. A dataset (the H5D interface) is composed of a + collection or raw data points of homogeneous type organized + according to the data space (the H5S interface). + +

+A data type is a collection of data type properties, all of + which can be stored on disk, and which when taken as a whole, + provide complete information for data conversion to or from that + data type. The interface provides functions to set and query + properties of a data type. + +

+A data point is an instance of a datatype, + which is an instance of a type class. We have defined + a set of type classes and properties which can be extended at a + later time. The atomic type classes are those which describe + types which cannot be decomposed at the data type interface + level; all other classes are compound. + +

+See The Datatype Interface (H5T) +in the HDF5 User's Guide for further information. + + +

+
+
Name: H5Topen +
Signature: +
hid_tH5Topen(hid_t loc_id, + const char * name + ) +
Purpose: +
Opens a named datatype. +
Description: +
From UG: H5Topen opens a named datatype at the location + specified by loc_id and returns an identifier + for the data type. The identifier should eventually be closed + by calling H5Tclose() to release resources. + loc_id is either a file or group identifier. +

+ From SC: Opens a named datatype. +

Parameters: +
+
hid_t loc_id +
A file or group identifier. +
const char * name +
A datatype name. +
+
Returns: +
Returns a named datatype identifier if successful; + otherwise FAIL (-1). +
+ + +
+
+
Name: H5Tcommit +
Signature: +
herr_tH5Tcommit(hid_t loc_id, + const char * name, + hid_t type + ) +
Purpose: +
Commits a transient datatype to a file, creating a new named datatype. +
Description: +
From UG: H5Tcommit commits a transient datatype (not immutable) + to a file, turned it into a named datatype. The loc_id + is either a file or group identifier which, when combined with + name, refers to a new named data type. +

+ From SC: Saves a transient data type to a file and turns + the type identifier into a named, immutable type. +

Parameters: +
+
hid_t loc_id +
A file or group identifier. +
const char * name +
A datatype name. +
hid_t type +
A datatype identifier. +
+
Returns: +
Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
+ + +
+
+
Name: H5Tcommitted +
Signature: +
hbool_tH5Tcommitted(hid_t type) +
Purpose: +
Determines whether a datatype is a named type or a transient type. +
Description: +
From UG: H5Tcommitted queries a type to determine whether + it is a named type or a transient type. If this function returns + a positive value, then the type is named (that is, it has been + committed, perhaps by some other application). Datasets which + return committed data types with H5Dget_type() are + able to share the data type with other datasets in the same file. +

+ From SC: Determines whether a data type is committed. +

Parameters: +
+
hid_t type +
Datatype identifier. +
+
Returns: +
From UG: Returns a datatype identifier if successful; + otherwise FAIL (-1). +
From SC: The successful returns values are TRUE if committed, + else FALSE. Otherwise returns FAIL (-1). +
+ + +
+
+
Name: H5Tinsert_array +
Signature: +
herr_tH5Tinsert_array(hid_t parent_id, + const char *name, + size_t offset, + int ndims, + const size_t *dim, + const int *perm, + hid_t member_id + ) +
Purpose: +
Adds a new member to a compound data type. +
Description: +
From SC: H5Tinsert_array adds a new member to the + compound data type parent_id. The new member's name, + name, must be unique within the compound data type. + The offset argument defines the start of + the member in an instance of the compound data type and + member_id is the type of the new member. + The member is an array with ndims dimensionality + and the size of the array is dim. + The total member size should be relatively small +
Parameters: +
+
hid_t parent_id +
+
const char *name +
+
size_t offset +
+
int ndims +
+
const size_t *dim +
+
const int *perm +
+
hid_t member_id +
+
+
Returns: +
Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
+ + +
+
+
Name: H5Tfind +
Signature: +
H5T_conv_t H5Tfind(hid_t src_id, + hid_t dst_id, + H5T_cdata_t **pcdata + ) +
Purpose: +
Finds a conversion function. +
Description: +
From SC: H5Tfind finds a conversion function + that can handle a conversion from type src_id to + type dst_id. + The pcdata argument is a pointer + to a pointer to type conversion data which was created and + initialized by the soft type conversion function of this path + when the conversion function was installed on the path. +
Parameters: +
+
hid_t src_id +
+
hid_t dst_id +
+
H5T_cdata_t **pcdata +
+
+
Returns: +
Returns a pointer to a suitable conversion function if successful. + Otherwise returns FAIL (-1). +
+ + +
+
+
Name: H5Tconvert +
Signature: +
herr_t H5Tconvert(hid_t src_id, + hid_t dst_id, + size_t nelmts, + void *buf, + void *background + ) +
Purpose: +
Converts data from between specified datatypes. +
Description: +
From SC: Convert nelmts elements from type + src_id to type dst_id. + The source elements are packed in buf and on return + the destination will be packed in buf. + That is, the conversion is performed in place. + The optional background buffer is an array of nelmts + values of destination type which are merged with the converted + values to fill in cracks (for instance, background + might be an array of structs with the a and + b fields already initialized and the conversion + of buf supplies the c and d + field values). +
Parameters: +
+
hid_t src_id +
+
hid_t dst_id +
+
size_t nelmts +
+
void *buf +
+
void *background +
+
+
Returns: +
Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
+ +
+
+
Name: H5Tset_overflow +
Signature: +
herr_t H5Tset_overflow(H5T_overflow_t func) +
Purpose: +
Sets the overflow handler to a specified function. +
Description: +
From SC: H5Tset_overflow sets the overflow handler + to be the function specified by func. + func will be called for all data type conversions that + result in an overflow. +

+ See the definition of H5T_overflow_t in + H5Tpublic.h for documentation + of arguments and return values. + The prototype for H5T_overflow_t is as follows:
+ herr_t (*H5T_overflow_t)(hid_t src_id, hid_t dst_id, + void *src_buf, void *dst_buf); + +

+ The NULL pointer may be passed to remove the overflow handler. +

Parameters: +
+
H5T_overflow_t func +
+
+
Returns: +
Returns SUCCEED (0) if successful; + otherwise FAIL (-1). +
+ +
+
+
Name: H5Tget_overflow +
Signature: + + +H5Tget_overflow () +
H5T_overflow_t H5Tget_overflow(void) +
Purpose: +
Returns a pointer to the current global overflow function. +
Description: +
From SC: H5Tset_overflow returns a pointer + to the current global overflow function. + This is an application-defined function that is called whenever a + data type conversion causes an overflow. +
Parameters: +
+
None. +
+
Returns: +
Returns a pointer to an application-defined function if successful. + Otherwise returns NULL; this can happen if no overflow handling + function is registered. +
+ + +
Name: H5Tcreate
Signature:
hid_t H5Tcreate(H5T_class_t class, size_tsize ) +
Purpose: +
Creates a new dataype.
Description: -
This function creates a new dataype of the specified class with the +
H5Tcreate creates a new dataype of the specified class with the specified number of bytes. Currently, only the H5T_COMPOUND datatype class is supported with this function, use H5Tcopy to create integer or floating-point datatypes. The datatype ID @@ -93,14 +409,17 @@ of a dataset.
Datatype ID on success, negative on failure.
+
Name: H5Tcopy
Signature:
hid_t H5Tcopy(hid_t type_id ) +
Purpose: +
Copies an existing datatype.
Description: -
This function copies an existing datatype. The datatype ID returned +
H5Tcopy copies an existing datatype. The datatype ID returned should be released with H5Tclose or resource leaks will occur. Native datatypes supported by the library are:
    @@ -154,6 +473,7 @@ of a dataset.
    Datatype ID on success, negative on failure.
    +
    Name: H5Tequal @@ -161,9 +481,11 @@ of a dataset.
    hbool_t H5Tequal(hid_t type_id1, hid_ttype_id2 ) +
    Purpose: +
    Determines whether two datatype identifiers refer to the same datatype.
    Description: -
    This function determines if two datatype IDs refer to the same - datatype. +
    H5Tequal determines whether two datatype identifiers + refer to the same datatype.
    Parameters:
    hid_t type_id1 @@ -175,14 +497,17 @@ of a dataset.
    TRUE/FALSE/negative
    +
    Name: H5Tlock
    Signature:
    herr_t H5Tlock(hid_t type_id ) +
    Purpose: +
    Locks a type.
    Description: -
    This function locks a type, making it read-only and non-destrucible. +
    H5Tlock locks a type, making it read-only and non-destrucible. This is normally done by the library for predefined data types so the application doesn't inadvertently change or delete a predefined type. Once a data type is locked it can never be unlocked. @@ -195,14 +520,17 @@ of a dataset.
    zero/negative
    +
    Name: H5Tget_class
    Signature:
    H5T_class_t H5Tget_class(hid_t type_id ) +
    Purpose: +
    Returns the base class of a datatype.
    Description: -
    This function returns the base class of a datatype. +
    H5Tget_class returns the base class of a datatype.
    Parameters:
    hid_t type_id @@ -212,14 +540,17 @@ of a dataset.
    Non-negative type class on success, negative on failure.
    +
    Name: H5Tget_size
    Signature:
    size_t H5Tget_size(hid_t type_id ) +
    Purpose: +
    Returns the size of a datatype.
    Description: -
    This function returns the size of a datatype in bytes. +
    H5Tget_size returns the size of a datatype in bytes.
    Parameters:
    hid_t type_id @@ -229,6 +560,7 @@ of a dataset.
    Positve size in bytes on success, 0 on failure.
    +
    Name: H5Tset_size @@ -236,8 +568,11 @@ of a dataset.
    herr_t H5Tset_size(hid_t type_id, size_tsize ) +
    Purpose: +
    Sets the total size for an atomic data type.
    Description: -
    This function sets the total size in bytes for an atomic data type (this +
    H5Tset_size sets the total size in bytes for an + atomic data type (this operation is not permitted on compound data types). If the size is decreased so that the significant bits of the data type extend beyond the edge of the new size, then the `offset' property is decreased @@ -257,14 +592,17 @@ of a dataset.
    zero/negative
    +
    Name: H5Tget_order
    Signature:
    H5T_order_t H5Tget_order(hid_t type_id ) +
    Purpose: +
    Returns the byte order of an atomic datatype.
    Description: -
    This function returns the byte order of an atomic datatype. +
    H5Tget_order returns the byte order of an atomic datatype.
    Parameters:
    hid_t type_id @@ -274,6 +612,7 @@ of a dataset.
    Byte order constant on success, negative on failure
    +
    Name: H5Tset_order @@ -281,8 +620,10 @@ of a dataset.
    herr_t H5Tset_order(hid_t type_id, H5T_order_torder ) +
    Purpose: +
    Sets the byte ordering of an atomic datatype.
    Description: -
    This function sets the byte ordering of an atomic datatype. +
    H5Tset_order sets the byte ordering of an atomic datatype. Byte orderings currently supported are:
      H5T_ORDER_LE @@ -303,14 +644,17 @@ of a dataset.
      zero/negative
      +
      Name: H5Tget_precision
      Signature:
      size_t H5Tget_precision(hid_t type_id ) +
      Purpose: +
      Returns the precision of an atomic data type.
      Description: -
      This function returns the precision of an atomic data type. The +
      H5Tget_precision returns the precision of an atomic data type. The precision is the number of significant bits which, unless padding is present, is 8 times larger than the value returned by H5Tget_size().
      Parameters: @@ -322,6 +666,7 @@ of a dataset.
      Number of significant bits on success, 0 on failure
      +
      Name: H5Tset_precision @@ -329,10 +674,12 @@ of a dataset.
      herr_t H5Tset_precision(hid_t type_id, size_tprecision ) +
      Purpose: +
      Sets the precision of an atomic data type.
      Description: -
      This function sets the precision of an atomic data type. The precision - is the number of significant bits which, unless padding is present, is 8 - times larger than the value returned by H5Tget_size(). +
      H5Tset_precision sets the precision of an atomic data type. + The precision is the number of significant bits which, unless padding + is present, is 8 times larger than the value returned by H5Tget_size().

      If the precision is increased then the offset is decreased and then the size is increased to insure that significant bits do not "hang over" the edge of the data type. @@ -352,14 +699,17 @@ of a dataset.

      zero/negative
      +
      Name: H5Tget_offset
      Signature:
      size_t H5Tget_offset(hid_t type_id ) +
      Purpose: +
      Retrieves the bit offset of the first significant bit.
      Description: -
      This function retrieves the bit offset of the first significant bit. +
      H5Tget_offset retrieves the bit offset of the first significant bit. The signficant bits of an atomic datum can be offset from the beginning of the memory for that datum by an amount of padding. The `offset' property specifies the number of bits of padding that appear to the @@ -415,6 +765,7 @@ of a dataset.
      Positive offset value on success, 0 on failure.
      +
      Name: H5Tset_offset @@ -422,8 +773,10 @@ of a dataset.
      herr_t H5Tset_offset(hid_t type_id, size_t offset ) +
      Purpose: +
      Sets the bit offset of the first significant bit.
      Description: -
      This function sets the bit offset of the first significant bit. The +
      H5Tset_offset sets the bit offset of the first significant bit. The signficant bits of an atomic datum can be offset from the beginning of the memory for that datum by an amount of padding. The `offset' property specifies the number of bits of padding that appear to the @@ -488,6 +841,7 @@ zero.
      zero/negative
      +
      Name: H5Tget_pad @@ -496,8 +850,10 @@ zero. H5T_pad_t * lsb, H5T_pad_t * msb ) +
      Purpose: +
      Retrieves the padding type of the least and most-significant bit padding.
      Description: -
      This function retrieves the padding type of the least and most-significant +
      H5Tget_pad retrieves the padding type of the least and most-significant bit padding. Valid types are:
        H5T_PAD_ZERO @@ -520,6 +876,7 @@ zero.
        zero/negative
        +
        Name: H5Tset_pad @@ -528,8 +885,10 @@ zero. H5T_pad_t lsb, H5T_pad_t msb ) +
        Purpose: +
        Sets the least and most-significant bits padding types.
        Description: -
        This function sets the least and most-significant bits padding types. +
        H5Tset_pad sets the least and most-significant bits padding types.
          H5T_PAD_ZERO
          Set background to zeros. @@ -551,14 +910,17 @@ zero.
          zero/negative
          +
          Name: H5Tget_sign
          Signature:
          H5T_sign_t H5Tget_sign(hid_t type_id ) +
          Purpose: +
          Retrieves the sign type for an integer type.
          Description: -
          This function retrieves the sign type for an integer type. +
          H5Tget_sign retrieves the sign type for an integer type. Valid types are:
            H5T_SGN_NONE @@ -575,6 +937,7 @@ zero.
            Non-negative sign type on success, negative on failure
            +
            Name: H5Tset_sign @@ -582,8 +945,10 @@ zero.
            herr_t H5Tset_sign(hid_t type_id, H5T_sign_t sign ) +
            Purpose: +
            Sets the sign proprety for an integer type.
            Description: -
            This function sets the sign proprety for an integer type. +
            H5Tset_sign sets the sign proprety for an integer type.
              H5T_SGN_NONE
              Unsigned integer type. @@ -601,6 +966,7 @@ zero.
              zero/negative
              +
              Name: H5Tget_fields @@ -611,8 +977,10 @@ zero. size_t * mpos, size_t * msize ) +
              Purpose: +
              Retrieves floating point data type bit field information.
              Description: -
              This function retrieves information about the locations of the various +
              H5Tget_fields retrieves information about the locations of the various bit fields of a floating point data type. The field positions are bit positions in the significant region of the data type. Bits are numbered with the least significant bit number zero. @@ -634,6 +1002,7 @@ zero.
              zero/negative
              +
              Name: H5Tset_fields @@ -644,8 +1013,10 @@ zero. size_t mpos, size_t msize ) +
              Purpose: +
              Sets locations and sizes of floating point bit fields.
              Description: -
              This function sets the locations and sizes of the various floating +
              H5Tset_fields sets the locations and sizes of the various floating point bit fields. The field positions are bit positions in the significant region of the data type. Bits are numbered with the least significant bit number zero. @@ -669,14 +1040,17 @@ zero.
              zero/negative
              +
              Name: H5Tget_ebias
              Signature:
              size_t H5Tget_ebias(hid_t type_id ) +
              Purpose: +
              Retrieves the exponent bias of a floating-point type.
              Description: -
              This function retrieves the exponent bias of a floating-point type. +
              H5Tget_ebias retrieves the exponent bias of a floating-point type.
              Parameters:
              hid_t type_id @@ -686,6 +1060,7 @@ zero.
              Positive value on success, 0 on failure.
              +
              Name: H5Tset_ebias @@ -693,8 +1068,10 @@ zero.
              herr_t H5Tset_ebias(hid_t type_id, size_t ebias ) +
              Purpose: +
              Sets the exponent bias of a floating-point type.
              Description: -
              This function sets the exponent bias of a floating-point type. +
              H5Tset_ebias sets the exponent bias of a floating-point type.
              Parameters:
              hid_t type_id @@ -706,14 +1083,17 @@ zero.
              zero/negative
              +
              Name: H5Tget_norm
              Signature:
              H5T_norm_t H5Tget_norm(hid_t type_id ) +
              Purpose: +
              Retrieves mantissa normalization of a floating-point datatype.
              Description: -
              This function retrieves the mantissa normalization of a floating-point +
              H5Tget_norm retrieves the mantissa normalization of a floating-point datatype. Valid normalization values are:
                H5T_NORM_IMPLIED @@ -732,6 +1112,7 @@ zero.
                Non-negative normalization type on success, negative on failure
                +
                Name: H5Tset_norm @@ -739,8 +1120,10 @@ zero.
                herr_t H5Tset_norm(hid_t type_id, H5T_norm_t norm ) +
                Purpose: +
                Sets the mantissa normalization of a floating-point datatype.
                Description: -
                This function sets the mantissa normalization of a floating-point +
                H5Tset_norm sets the mantissa normalization of a floating-point datatype. Valid normalization values are:
                  H5T_NORM_IMPLIED @@ -761,15 +1144,18 @@ zero.
                  zero/negative
                  +
                  Name: H5Tget_inpad
                  Signature:
                  H5T_pad_t H5Tget_inpad(hid_t type_id ) +
                  Purpose: +
                  Retrieves the internal padding type for unused bits in floating-point datatypes.
                  Description: -
                  This function retrieves the internal padding type for unused bits in - floating-point datatypes. +
                  H5Tget_inpad retrieves the internal padding type for + unused bits in floating-point datatypes. Valid padding values are:
                    H5T_PAD_ZERO @@ -788,6 +1174,7 @@ zero.
                    Non-negative padding type on success, negative on failure
                    +
                    Name: H5Tset_inpad @@ -795,11 +1182,13 @@ zero.
                    herr_t H5Tset_inpad(hid_t type_id, H5T_pad_t inpad ) +
                    Purpose: +
                    Fills unused internal floating point bits.
                    Description:
                    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 they will be filled - according to the value of this property. + sign, exponent, or mantissa), then H5Tset_inpad will be filled + according to the value of the padding value property inpad. Valid padding values are:
                      H5T_PAD_ZERO @@ -820,14 +1209,17 @@ zero.
                      zero/negative
                      +
                      Name: H5Tget_cset
                      Signature:
                      H5T_cset_t H5Tget_cset(hid_t type_id ) +
                      Purpose: +
                      Retrieves the character set type of a string datatype.
                      Description: -
                      This function retrieves the character set type of a string datatype. +
                      H5Tget_cset retrieves the character set type of a string datatype. Valid character set values are:
                        H5T_CSET_ASCII @@ -842,6 +1234,7 @@ zero.
                        Non-negative character set type on success, negative on failure
                        +
                        Name: H5Tset_cset @@ -849,6 +1242,8 @@ zero.
                        herr_t H5Tset_cset(hid_t type_id, H5T_cset_t cset ) +
                        Purpose: +
                        Description:
                        HDF5 is able to distinguish between character sets of different nationalities and to convert between them to the extent possible. @@ -868,14 +1263,17 @@ zero.
                        zero/negative
                        +
                        Name: H5Tget_strpad
                        Signature:
                        H5T_str_t H5Tget_strpad(hid_t type_id ) +
                        Purpose: +
                        Retrieves the string padding method for a string datatype.
                        Description: -
                        This function retrieves the string padding method for a string datatype. +
                        H5Tget_strpad retrieves the string padding method for a string datatype. Valid string padding values are:
                          H5T_STR_NULL @@ -892,6 +1290,7 @@ zero.
                          Non-negative string padding type on success, negative on failure
                          +
                          Name: H5Tset_strpad @@ -899,11 +1298,13 @@ zero.
                          herr_t H5Tset_strpad(hid_t type_id, H5T_str_t strpad ) +
                          Purpose: +
                          Defines the storage mechanism for character strings.
                          Description: -
                          The method used to store character strings differs with the programming - language: C usually null terminates strings while Fortran - left-justifies and space-pads strings. This property defines the - storage mechanism for the string. +
                          The method used to store character strings differs with the + programming language: C usually null terminates strings while + Fortran left-justifies and space-pads strings. + H5Tset_strpad defines the storage mechanism for the string. Valid string padding values are:
                            H5T_STR_NULL @@ -922,14 +1323,17 @@ zero.
                            zero/negative
                            +
                            Name: H5Tget_nmembers
                            Signature:
                            intn H5Tget_nmembers(hid_t type_id ) +
                            Purpose: +
                            Retrieves the number of fields in a compound datatype.
                            Description: -
                            This function retrieves the number of fields a compound datatype has. +
                            H5Tget_nmembers retrieves the number of fields a compound datatype has.
                            Parameters:
                            hid_t type_id @@ -939,6 +1343,7 @@ zero.
                            Number of members datatype has on success, negative on failure
                            +
                            Name: H5Tget_member_name @@ -946,8 +1351,10 @@ zero.
                            char * H5Tget_member_name(hid_t type_id, intn fieldno ) +
                            Purpose: +
                            Retrieves the name of a field of a compound data type.
                            Description: -
                            This function retrieves the name of a field of a compound data type. +
                            H5Tget_member_name retrieves the name of a field of a compound data type. Fields are stored in no particular order with numbers 0 through N-1 where N is the value returned by H5Tget_nmembers(). The name of the field is allocated with malloc() and the caller is responsible for @@ -963,6 +1370,7 @@ zero.
                            Valid pointer on success, NULL on failure
                            +
                            Name: H5Tget_member_dims @@ -972,8 +1380,10 @@ zero. size_t * dims, int * perm ) +
                            Purpose: +
                            Returns the dimensionality of the field.
                            Description: -
                            This function returns the dimensionality of the field. The dimensions +
                            H5Tget_member_dims returns the dimensionality of the field. The dimensions and permuation vector are returned through arguments dims and perm, both arrays of at least four elements. Either (or even both) may be null pointers. @@ -992,6 +1402,7 @@ zero.
                            Number of dimensions on success, negative on failure.
                            +
                            Name: H5Tget_member_type @@ -999,8 +1410,10 @@ zero.
                            hid_t H5Tget_member_type(hid_t type_id, intn fieldno ) +
                            Purpose: +
                            Returns the data type of the specified member.
                            Description: -
                            This function returns the data type of the specified member. The caller +
                            H5Tget_member_type returns the data type of the specified member. The caller should invoke H5Tclose() to release resources associated with the type.
                            Parameters:
                            @@ -1013,6 +1426,7 @@ zero.
                            The ID of a copy of the datatype of the field, negative on failure.
                            +
                            Name: H5Tinsert @@ -1022,8 +1436,10 @@ zero. off_t offset, hid_t field_id ) +
                            Purpose: +
                            Adds a new member to a compound data type.
                            Description: -
                            This function adds another member to the compound data type +
                            H5Tinsert adds another member to the compound data type type_id. The new member has a name which must be unique within the compound data type. The offset argument defines the start of the member in an instance of the compound @@ -1047,14 +1463,17 @@ zero.
                            zero/negative
                            +
                            Name: H5Tpack
                            Signature:
                            herr_t H5Tpack(hid_t type_id ) +
                            Purpose: +
                            Recursively removes padding from within a compound datatype.
                            Description: -
                            This function recursively removes padding from within a compound +
                            H5Tpack recursively removes padding from within a compound datatype to make it more efficient (space-wise) to store that data.
                            Parameters:
                            @@ -1065,6 +1484,7 @@ zero.
                            zero/negative
                            +
                            Name: H5Tregister_hard @@ -1074,8 +1494,10 @@ zero. hid_t dst_id, H5T_conv_t func ) +
                            Purpose: +
                            Registers a hard conversion function.
                            Description: -
                            This function registers a hard conversion function for a data type +
                            H5Tregister_hard registers a hard conversion function for a data type conversion path. The path is specified by the source and destination datatypes src_id and dst_id. A conversion path can only have one hard function, so func replaces any @@ -1103,6 +1525,7 @@ zero.
                            zero/negative
                            +
                            Name: H5Tregister_soft @@ -1112,8 +1535,10 @@ zero. hid_t dst_id, H5T_conv_t func ) +
                            Purpose: +
                            Registers a soft conversion function.
                            Description: -
                            This function registers a soft conversion function by adding it to the +
                            H5Tregister_soft registers a soft conversion function by adding it to the end of the master soft list and replacing the soft function in all applicable existing conversion paths. The name is used only for debugging and should be a short identifier @@ -1136,14 +1561,17 @@ zero.
                            zero/negative
                            +
                            Name: H5Tunregister
                            Signature:
                            herr_t H5Tunregister(H5T_conv_t func ) +
                            Purpose: +
                            Removes a conversion function from all conversion paths.
                            Description: -
                            This function removes a conversion function from all conversion paths. +
                            H5Tunregister removes a conversion function from all conversion paths.

                            The type of the conversion function pointer is declared as: typedef herr_t (*H5T_conv_t) (hid_t src_id, hid_t dst_id, H5T_cdata_t *cdata, size_t nelmts, void *buf, void *bkg); @@ -1156,14 +1584,17 @@ zero.

                            zero/negative
                            +
                            Name: H5Tclose
                            Signature:
                            herr_t H5Tclose(hid_t type_id ) +
                            Purpose: +
                            Releases a datatype.
                            Description: -
                            This function releases a datatype. Further access through the datatype +
                            H5Tclose releases a datatype. Further access through the datatype ID is illegal. Failure to release a datatype with this call will result in resource leaks.
                            Parameters: @@ -1176,6 +1607,15 @@ zero.
                            +
                            +
                            + +Aha!! And here is the reference to sharing and that command that had us +so buffaloed, H5Tshare!
                            +To quote Quincy: "The H5Tshare() and H5Tis_shared() will be removed. Data types +will not be stored in the global heap. A new type of shared +message header will be added to the object headers that points to +another object header instead of the global heap..."
                            @@ -1317,7 +1757,7 @@ Quincey> HDF5 Documentation
                            -Last modified: 29 June 1998 +Last modified: 9 July 1998 -- cgit v0.12