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


13.8.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.

is 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.

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.

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

f_b_news

integer f_b_news(file f, list l, integer n, integer bits, text separators);

same as ‘f_news’, except the read words are appended as byte arrays (of the ‘data’ type) instead ‘text’ intrinsic strings, nil bytes allowed.

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 not available) and sets d to the read result.

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

f_bb_fill

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

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

f_bb_read

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

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

is the number of read bytes, -1 if nothing was read and the end of file was met.


Next: File Input Skip Functions, Previous: File Input Functions, Up: The File Library   [Index]