Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5TB_MAKE_TABLE

Creates and writes a table.

Procedure:

H5TB_MAKE_TABLE(table_title, loc_id, table_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_f

Note: h5tbmake_table_f only creates the table, it does not write data to it.

Parameters:
const char *table_titleIN: The title of the table.
hid_t loc_idIN: Identifier of the file or group to create the table within.
const char *table_nameIN: The name of the dataset to create.
hsize_t nfieldsIN: The number of fields.
const hsize_t nrecordsIN: The number of records.
hsize_t type_sizeIN: The size in bytes of the structure associated with the table. This value is obtained with sizeof.
const char *field_names[]    IN: An array containing the names of the fields.
const size_t *field_offsetIN: An array containing the offsets of the fields.
const hid_t *field_typesIN: An array containing the type of the fields.
hsize_t chunk_sizeIN: The chunk size.
void *fill_dataIN: Fill values data.
int compressIN: Flag that turns compression on or off.
const void *dataIN: Buffer with data to be written to the table.

Description:

H5TBmake_table creates and writes a dataset named table_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:

Coming Soon!

--- Last Modified: December 04, 2017 | 07:22 AM