MemCom Reference Manual > MemCom ftn Fortran API > Database Manager (DB) > mcf_db_get_stream

Name

mcf_db_get_stream — Read from stream (Fortran API)

Synopsis

subroutine mcf_db_get_stream(handle,address,size,
                             buffer,status)


subroutine mcf_db_get_stream_typed(handle,address,size,
                                   type,buffer,status)


integer*4 handle
integer*8 address
character*4 type
integer*8 size
void buffer(*)
integer*4 status

Description

mcf_stream_get reads a contiguous number of bytes starting at a given file address. mcf_stream_get_typed reads a contiguous number of data elements of type I, J, E, D, C, Z starting at a given file address.

Parameters

handle

Handle of database file on which the set(s) reside (input).

address

Byte address of file identified by handle at which the read operation starts (input).

type

Data type (input). Character string containing "I","J", "E", "D", "C", or "Z".

size

Logical number of data elements to be transferred (input).

buffer

Data buffer (input). The data buffer must be of the correct type. It is the calling function's responsibility to make sure that the data buffer is large enough to hold the requested amount of data.

status

Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued.