FileTools
Position
set or return the current position within a file
Calling Sequence
Parameters
Description
Examples
Position(file, pos)
file
-
filename or file descriptor
pos
(optional) integer offset into the file or infinity
The Position(file) command returns the current position within the specified file. This is the position to which the next write takes place, or from which the next read takes place.
The Position(file, pos) command sets the current position within the specified file and returns that new position.
A specified position of infinity sets the current position to the end of the file.
If file does not refer to an open file, an error is raised.
To determine a position suitable for passing to Position in a text file, call Position. Only values returned by Position(file) are guaranteed to be meaningful when used in Position(file, pos). Counting characters while reading and/or writing is not reliable, because newline characters are translated from/to local conventions, which may use more than a single character. However, Position(file, infinity) is always valid.
testfile≔FileToolsTemporaryFile⁡test
testfile≔/tmp/test
FileToolsTextWriteFile⁡testfile,This is a test.
15
FileToolsTextOpen⁡testfile
FileToolsPosition⁡testfile,∞
See Also
FileTools[AtEndOfFile]
FileTools[Text]
IO_errors
iostatus
Download Help Document