- Created by Mike McGreevy, last modified by Barbara Jones on Jun 25, 2020
H5TB_MAKE_TABLE
Creates and writes a table
Procedure:
H5TB_MAKE_TABLE ( table_title, loc_id, dset_name, nfields, nrecords, type_size, field_names, field_offset, field_types, chunk_size, fill_data, compress, data )
Signature:
herr_t H5TBmake_table( const char *table_title, hid_t loc_id, const char *dset_name, hsize_t nfields,
const hsize_tnrecords, size_t type_size, const char *field_names [ ], const size_t *field_offset,
const hid_t *field_types, hsize_tchunk_size, void *fill_data, int compress, const void *data )
subroutine h5tbmake_table_f(table_title, loc_id, dset_name, nfields, &
nrecords, type_size, field_names, field_offset, &
field_types, chunk_size, compress, errcode)
implicit none
character(LEN=*), intent(IN) :: table_title ! name of the table
integer(HID_T), intent(IN) :: loc_id ! file or group identifier
character(LEN=*), intent(IN) :: dset_name ! name of the dataset
integer(HSIZE_T), intent(IN) :: nfields ! fields
integer(HSIZE_T), intent(IN) :: nrecords ! records
integer(SIZE_T), intent(IN) :: type_size ! type size
character(LEN=*), dimension(nfields), intent(IN) :: field_names
! field names
integer(SIZE_T), dimension(nfields), intent(IN) :: field_offset
! field offset
integer(HID_T), dimension(nfields), intent(IN) :: field_types
! field types
integer(HSIZE_T), intent(IN) :: chunk_size ! chunk size
integer, intent(IN) :: compress ! compress
integer :: errcode ! error code
end subroutine h5tbmake_table_fNote: h5tbmake_table_f only creates the table, it does not write data to it.
Parameters:
const char *table_title | IN: The title of the table |
hid_t loc_id | IN: Identifier of the file or group to create the table within |
const char *dset_name | IN: The name of the dataset to create |
hsize_t nfields | IN: The number of fields |
const hsize_t nrecords | IN: The number of records |
hsize_t type_size | IN: The size in bytes of the structure associated with the table This value is obtained with |
const char *field_names[] | IN: An array containing the names of the fields |
const size_t *field_offset | IN: An array containing the offsets of the fields |
const hid_t *field_types | IN: An array containing the type of the fields |
hsize_t chunk_size | IN: The chunk size |
void *fill_data | IN: Fill values data |
int compress | IN: Flag that turns compression on or off |
const void *data | IN: Buffer with data to be written to the table |
Description:
H5TB_MAKE_TABLE creates and writes a dataset named dset_name attached to the object specified by the identifier loc_id.
Returns:
Returns a non-negative value if successful; otherwise returns a negative value.
Example:
Include Bitbucket Server for Confluence: File content cannot be shown
Unauthenticated access to this resource is not allowed. Please login to Confluence first.Please see Tables for Fortran programming hints.
Include Bitbucket Server for Confluence: File content cannot be shown
Unauthenticated access to this resource is not allowed. Please login to Confluence first.--- Last Modified: June 25, 2020 | 02:53 PM