Next: , Previous: , Up: The File Library   [Index]


11.7.6 Byte Data File Input Functions

f_b_fast

integer f_b_fast(file f, text c, data d);

reads the f file interpreting the C escape sequences for as long as the read unescaped characters do not belong to the c character set and sets d to the read result. The next read will start with the met in c character.

returns the number of read characters (the length of d), -1 if nothing was read (end of file was met)

f_b_fill

void f_b_fill(file f, data d, integer m);

reads m bytes from the f file and sets d to the read result.

If the short read triggered errors are trapped, subsequent reads may see input slips.

f_b_line

integer f_b_line(file f, data d);

reads the f file until the next new line character or until the files expires and sets d to the read result. The next read will start with the character just after the met new line.

returns the number of read characters (the length of d), -1 if nothing was read (end of file was met)

f_b_read

integer f_b_read(file f, data d, integer m);

reads m bytes from the f file (or as many as available if m are not available) and sets d to the read result.

returns the number of read bytes (the length of d, 0 if no data was available), -1 if nothing was read (end of file was met)


Next: , Previous: , Up: The File Library   [Index]