RSTATD

Return numeric information about the last record read

xcall RSTATD(size[, term_code])

Arguments

size

The variable that will be returned with the size of the last record read. For READ and READS operations, the returned size doesn’t include the record terminator that ended the input operation. (n)

term_code

(optional) The variable that will be returned with the code of the character that terminated the input operation, loaded left-justified over blanks. Term_code should be at least a three-digit field. (n)

Discussion

The RSTATD subroutine returns the size and terminating character of the last record read by a GET, GETS, READ, READS, W_DISP, W_DISP(WD_READS), or W_FLDS(WF_INPUT) operation, or the character typed in at an ACCEPT statement.

The RSTATD subroutine is similar to the RSTAT subroutine, except that the record terminator is returned as the actual terminating character (an alpha field) in RSTAT.

RSTATD returns a zero in term_code after a READS that does not require an explicit terminator is executed and the input field is full (after auto termination).

The ACCEPT statement reads only one character or control code sequence per execution.

In Synergy .NET, you cannot use RSTATD in multi-threaded scenarios where a channel number has not been not specified.