Receive a string.
Receive a string. Unlike v24Read, which tries to read a fixed number of character, v24Gets read characters unless BuffSize characters are fetched, or a end of line (\n) is recieved. At the end of the game, the number of characters read ist returned. If an error occurs, a -1 is returned. The characters are stored in Buffer. The functions ensures a \0 terminated string!Possible error code are V24_OK, V24_E_NULL_POINTER, V24_E_ILLPARM, V24_E_ILLHANDLE or V24_WRITE. To get this error code, use v24QueryErrno.
A string should at least have 1 character and the terminating \0. The parameter BuffSize must therefore be greater than 1! If not, the operation results in a V24_E_ILLPARM error. To read a single character, we have v24Getc.
Implementation note: the current release of the library defines the end of a string as a hard coded constant! Search the internal headers EZV24_END_OF_STRING.