position
Retrieves the current position of the file pointer for which the next operation will occur at.
NOTE: If this is a Write stream and Write.isAppending is true, this will always return the current size.
Return
The current position of the file pointer.
Throws
If the stream is closed.
Sets the FileStream.position to new.
NOTE: If this is a Write stream and Write.isAppending is true, this is silently ignored as data is always written to the end of the File.
NOTE: On Js/WasmJs, if using the :kmp-file:async extension module, this synchronous function can fail to acquire the necessary position lock if an asynchronous FileStream operation is holding it. In that event, an IOException is raised. This is a platform limitation and can be avoided by not intermixing synchronous, and asynchronous functionality.
Return
The FileStream for chaining operations.
Parameters
The new position for the FileStream.
Throws
If new is less than 0.
If an I/O error occurs, or the stream is closed.