OLE::Storage::Io - Laola's IO interface
Note: OLE::Storage is doing IO by maintaining lists consisting of ($offset, $length) elements.
O== $Io -> close ([\$streambuf])
Destructor. Flushes cache and closes file.
1== $Io -> flush ()
Flush $Io cache, if caching is turned on.
$name = $Io -> name ()
Returns name of $Io.
O== open ($Startup, $name, [,$mode [,\$streambuf]])
Constructor. Gives access to a file or a buffer. Default $mode is 0, that is read only. In file mode $name is a filepath. In buffer mode a reference to a buffer \$streambuf is mandatory. Errors occuring at Io methods will be reported to Startup object $Startup.
Bit Mode 0 0 read only 1 read/write 4 0 file mode 1 buffer mode
O== $Io -> read ($offset, $len, \$buf [,$var_offset])
Reads $len bytes starting at offset $offset into buffer referenced by \$buf. If $var_offset is given, buffer will be filled from this offset on.
0== $Io -> rw_iolist (
"w", \$buf, $iolistO);
Read Iolist $Io into buffer $buf ("r"), or write buffer to Iolist $Io.
$len = $Io -> size ()
Returns size of $Io in bytes.
O== $Io -> writable ()
$Io is writable (1) or not (0).
O== $Io -> write ($offset, $len, \$buf [,$var_offset])
Writes $len bytes starting at offset $offset from buffer referenced by \$buf to $Io. If $var_offset is given, buffer will be read from this offset on.
Martin Schwartz <firstname.lastname@example.org>