%fgets() Function

The %fgets() function reads characters from the named input stream into var until n-1 characters are read or a new line character is read and transferred to the string.

Syntax

ptr = (char*)%fgets(var, n, (char*)stream)

Description

The string is terminated with a null character (hexadecimal 00). A string of a size at least equal to n must be assigned to var before the call, otherwise the data is truncated. If less than n-1 bytes are returned, the content of the string beyond is undefined, as is usual in C. No data translation occurs.

The pointer returned has no meaning, except for a null value which indicates an error or that end of file has been encountered.

NOTE

The null character may have to be removed explicitly, as in the example.

 

Example(s)

char line[128] ;* make a buffer

pointer=(char*)%fgets(line, 128, (char*)stream)

if pointer#0 then

line=field(line,char(0),1)

print line

end

See Also

%fclose() Function

%fgetc() Function

%fopen() Function

%popen() Function

FlashBASIC C Functions Overview

cfunction Statement