STRPTR buffer LONG maxchars struct CSource * input
FUNCTION
Read an item from a given character source. Items are words or quoted strings seperated by whitespace or '=' just like on the commandline. The seperator is unread and the read string is terminated by a NUL character.
INPUTS
buffer
Buffer to be filled.
maxchars
Size of the buffer. Must be at least 1 (for the terminator).
input
A ready to use CSource structure or NULL which means "read from the input stream".
RESULT
One of ITEM_UNQUOTED - Normal word read. ITEM_QUOTED - Quoted string read. ITEM_NOTHING - End of line found. Nothing read. ITEM_EQUAL - '=' read. Buffer is empty. ITEM_ERROR - An error happened. IoErr() gives additional information in that case.
EXAMPLE
SEE ALSO
NOTES
This function handles conversion of '**', '*"', etc inside quotes.
BUGS
INTERNALS
HISTORY
20.10.1998 hkiel
Amiga Research OS
23.01.1998 hkiel
Made GCC-2.8.0 happy (Changed return type of main() to int, added braces
to avoid ambiguous ŽelseŽ)
27.01.1997 ldp
Polish
09.12.1996 aros
Added empty templates for all missing functions
Moved #include's into first column
24.10.1996 aros
Use the official AROS macros over the __AROS versions.
13.08.1996 digulla
Replaced <dos/dosextens.h> by "dos_intern.h" or added "dos_intern.h"
Replaced __AROS_LA by __AROS_LHA