read_n_chars

Arguments

Returns

A buffer containing the characters read. The length of the return buffer is equal to the number of characters actually read. This function returns nil if no characters could be read.

Description

This function reads the given number of characters from the file, without any form of translation, and builds a new buffer object in which to store them. If this function reaches the end of the file before all characters are read, then the buffer will be shorter than the requested number of characters.

Example

An input file contains the following:

To be or not to be, that is the question.

Successive calls to read_n_chars will produce:

Gamma> ft = open ("myreadnfile.dat", "r");
#<File:"myreadnfile.dat">
Gamma> read_n_chars(ft,15);
#{To be or not to}
Gamma> read_n_chars(ft,18);
#{ be, that is the q}
Gamma> read_n_chars(ft,18);
#{uestion.}
Gamma> read_n_chars(ft,18);
nil
Gamma>  
		

See Also

read_char