Skip to content

IOL( )

Pack All the Values of IOLIST into One String

This Function allows you to pack all the values of an IOLIST into one string with separator characters between the values. If the function is being assigned into a format (i.e. #FMT=IOL(10)), the string is built up like a READ(chan) #FMT without separators.

str-val = IOL(line-number [,ERR=line-ref|ERC=error-code]
str-val
is the value of the string that will receive the IOL ( ) output.
line-number
is an integer representing a valid program line in the program currently loaded in memory. This line must contain an IOLIST definition.
line-ref
is the program line number or label to branch to if an error is produced by this function.
error-code
is a programmer-defined error code. Valid values are positive or negative whole numbers.
IO_STRING = IOL(00200)

defines the string that will receive the output of the IOLIST located on program line 00200.

From the Thoroughbred Basic Language Reference, Volume II: F–Q, version 8.9.1. Open this page in the PDF