Page tree

 

JAVA

FORTRAN

C++

C

 

Link

H5TB_READ_FIELDS_NAME

Reads one or several fields. The fields are identified by name.

Procedure:

H5TB_READ_FIELDS_NAME(loc_id, table_name, field_names, start, nrecords, type_size, field_offset, dst_sizes, data)

Signature:

herr_t H5TBread_fields_name ( hid_t loc_id, const char *table_name, const char * field_names, hsize_t start, hsize_t nrecords, size_t type_size,  const size_t *field_offset, const size_t *dst_sizes, void *data)

subroutine h5tbread_field_name_f(loc_id, dset_name, field_name, start, &
                                 nrecords, type_size, buf, errcode) 
  implicit none
  integer(HID_T), intent(IN) :: loc_id           ! file or group identifier 
  character(LEN=*), intent(IN) :: dset_name      ! name of the dataset 
  character(LEN=*), intent(IN) :: field_name     ! name of the field
  integer(HSIZE_T), intent(IN) :: start          ! start record 
  integer(HSIZE_T), intent(IN) :: nrecords       ! records
  integer(SIZE_T), intent(IN) :: type_size       ! type size
  , intent(IN), dimension(*) :: buf        ! data buffer 
  integer :: errcode                             ! error code
end subroutine h5tbread_field_name_f

Parameters:

hid_t loc_id

    IN: Identifier of the file or group to read the table within.

const char *table_name

    IN: The name of the dataset to read.

const char * field_names

    IN: An array containing the names of the fields to read.

hsize_t  start

    IN: The start record to read from.

hsize_t nrecords

    IN: The number of records to read.

hsize_t type_size

    IN: The size in bytes of the structure associated with the table. This value is obtained with sizeof.

const size_t *field_offset

    IN: An array containing the offsets of the fields.

const size_t *dst_sizes

    IN: An array containing the size in bytes of the fields.

void *data

    OUT: Buffer with data.

Description:

H5TBread_fields_name reads the fields identified by  field_names from 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