Creates and writes a table


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 )


<pre><code class="language-c">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 )</code></pre>

<pre><code class="language-fortran">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</code></pre>

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

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_size

IN: 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


 H5TB_MAKE_TABLE creates and writes a dataset named table_name attached to the object specified by the identifier loc_id.


Returns a non-negative value if successful; otherwise returns a negative value.