Next: Output File Functions, Previous: The close Function, Up: File Library Exports
reads the f file until the next zero character or until the files expires and sets s to the read result. The next read will start with the character just after the met zero.
returns the length of s, -1 if nothing was read (end of file was met)
reads the f file for as long as the read characters do not belong to the c character set and sets s to the read result. The next read will start with the met in c character.
returns the length of s, -1 if nothing was read (end of file was met)
reads the f file interpreting the C escape sequences until the next new line character (the next unescaped new line character, that is) or until the files expires and sets s to the read result. The next read will start with the character just after the met (unescaped) new line.
returns the length of s, -1 if nothing was read (end of file was met)
The backslash/new-line sequence is not interpreted as line continuation, it is interpreted as a new-line.
reads the f file interpreting the C escape sequences until the next new line character (the next unescaped new line character, that is) or until the files expires and sets s to the read result. The next read will start with the character just after the met (unescaped) new line.
returns the length of s, -1 if nothing was read (end of file was met)
The backslash/new-line sequence is interpreted as line continuation (and thus ignored), and not as a new-line.
reads the f file until the next new line character or until the files expires and sets s to the read result. The next read will start with the character just after the met new line.
returns the length of s, -1 if nothing was read (end of file was met)
reads the f file interpreting the C escape sequences until the next new line character (the next unescaped new line character, that is) or until the files expires and splits the read result into words in the l list. The next read will start with the character just after the met (unescaped) new line.
returns the sum of the stored word lengths, -1 if nothing was read (end of file was met)
The backslash/new-line sequence is interpreted as line continuation (and thus ignored), and not as a new-line.
Words are split at white space (space and tab characters).
The l list is cleared before storing any strings with it. The read words are appended (as strings, data of the intrinsic `text' type) to the list, in the order in which they are read.
If n is not zero, all but the first n - 1 read words are stored in the l list as a single string - the concatenation of these all but the first n - 1 with a single space character inserted in between two consecutive words.
The list library must be linked in for this function to be available and data of the intrinsic `text' type must be storable with list type objects. More, the text library must be explicitly requested to make available the list related functions and it must be acquainted with the list library.
See File Library Generation Flags.
See x1f4_list_lxfile.
reads the f file for as long as the read characters do not belong to the c character set (read result is discarded). The next read will start with the met in c character.
returns the number of read (discarded) characters (bytes), -1 if end of file was reached before reading any character
reads the f file for as long as the read characters belong to the c character set and sets s to the read result. The next read will start with the met not in c character.
returns the length of s, -1 if nothing was read (end of file was met)
reads a character from the f file without removing it from the read buffer. The next read, if any, will start with the read character (just as if `f_peek' was never called).
returns the read character as a positive value, -1 if none was read
reads the ith subsequent character from the f file without removing it from the read buffer. Calling `f_peep' has no effect on subsequent reads. i needs to be positive and less than the read buffer size. `f_peek(f)' and `f_peep(f, 0)' are equivalent.
See Miscellaneous Definitions.
returns the read character as a positive value, -1 if none was read
reads a character from the f file. The next read will start with the character just after the read one.
returns the read character as a positive value, -1 if none was read
reads the f file for as long as the read characters belong to the c character set (read result is discarded). The next read will start with the met not in c character.
returns the number of read (discarded) characters (bytes), -1 if end of file was reached before reading any character
reads away n bytes from the f file
returns the number of read (discarded) characters (bytes), -1 if end of file was reached before reading any character
reads the f file until the next new line character or until the files expires (read result is discarded). The next read will start with the character just after the met new line.
returns the number of read (discarded) characters (bytes), not including the new line character, -1 if end of file was reached before reading any character (including new line)
skips any character until the first neither space nor tab, reads the f file until the first space, tab or next new line character or until the files expires and sets s to the read result. The next read will start with the met space, tab or new line character, except for when new line was met before reading any non space, tab or new line character, case in which the next read will start with the character after the met new line character.
returns the length of s, -2 if new line was met before reading any non space, tab or new line character, -1 if nothing was read (end of file was met)