_CP_readt

_CP_readt


_CP_readnext Index Level _CP_readv
Syntax int _CP_readt(int type, CPSTR** result)
Category C Interface
Type C Function
Description equivalent to the FlashBASIC statements: readt

Which flavor of "readt" is dependent upon the command "type".

type                 FlashBASIC statement

_CP_READT_ELSE       readt result else * return -1
_CP_READT_L_ELSE     readtl result else * return -1
_CP_READTX_ELSE      readtx result else * return -1
_CP_READT_ONERR      readt result onerr * return -1
_CP_READT_L_ONERR    readtl result onerr * return -1
_CP_READTX_ONERR     readtx result onerr * return -1

This function returns -1 if an error occurs. The error code is contained in _CP_errno.  PE_TAPE indicates a tape error.
Options
See Also C Functions introduction _CP_weof _CP_writet
Example /*The following example prints the next tape block.*/

CPSTR * xx = _CP_str_null;

_CP_readt(_CP_READT_ELSE, xx);
_CP_print(xx);
Warnings The tape must have been already attached.
Compatibility AP 6.1
_CP_readnext Index Level _CP_readv