GET_STRING

Syntax a$ = GET_STRING(#channel)
Location DJToolkit 1.16

Read the next 2 bytes from the file and assuming them to be a QDOS string’s length, read that many characters into a$. The two bytes holding the string’s length are NOT returned in a$, only the data bytes.

The subtle difference between this function and FETCH_BYTES is that this one finds out how many bytes to return from the channel given, FETCH_BYTES needs to be told how many to return by the user. GET_STRING is the same as:

FETCH_BYTES(#channel, GET_WORD(#channel))

WARNING - JM and AH ROMS will give a ‘Buffer overflow’ error if the length of the returned string is more than 128 bytes. This is a fault in QDOS, not DJToolkit. The demos file, supplied with DJToolkit, has a ‘fix’ for this problem.

EXAMPLE

b$ = GET_STRING(#3)

CROSS-REFERENCE

GET_BYTE, GET_FLOAT, GET_LONG, GET_WORD, FETCH_BYTES.