(C) 1998 AROS - The Amiga Research OS
It is advised to only use ASCII characters with a variable, but this is not required.
If GVF_BINARY_VAR is not specified, this function will stop putting characters into the destination buffer when a '\n' is hit, or the end of the buffer is reached. Otherwise it will complete fill the buffer.
If the value would overflow the user buffer, then the number of characters copied into the buffer will be returned and the buffer truncated.The buffer will be NULL terminated unless GVF_DONT_NULL_TERM is set.
IoErr() will contain either: ERROR_OBJECT_NOT_FOUND if the variable is not defined. ERROR_BAD_NUMBER if the size of the buffer is 0. the total length of the variable otherwise.
Moved #include's into first column