System.IO.LineIndexedCursor

Description

Line-indexed file reader.

Lazily builds the index with the line numbers while reading the file making it possible to rewind to them quickly later.

Synopsis

Documentation

ADT with methods, hiding the internal state.

Constructors

Fields

getCurrentLine :: IO (Maybe ByteString)
Same as getCurrentLineUnsafe but safely handles EOF.
getCurrentLineUnsafe :: IO ByteString
A wrapper around hGetLine. Throws the same exceptions.
getCurrentLineNumber :: IO Integer
Returns the current line number.
doFullScan :: IO ()
Reads from the latest known line until EOF to build the full index.
goToLine :: Integer -> IO Integer
Rewinds the file handle to the requsted line number. Stops at the EOF if it's too big, returning the reached line number.
getHandle :: Handle
Returns the file Handle.
getCursorState :: IO [Integer]
Returns the current state of the cursor — all known line indexes.

Builds LineIndexedCursor. Resets the file handle's ofsset to the beginning.

Use hSetNewlineMode if you want to configure NewlineMode.

Same as mkLineIndexedCursor but allows to configure the list's capacity.