NAME

OLE::Storage::Io - Laola's IO interface

SYNOPSIS

use OLE::Storage::Io();

s.b.

DESCRIPTION

Note: OLE::Storage is doing IO by maintaining lists consisting of ($offset, $length) elements.

close

1||O == $Io -> close ([\$streambuf])

Destructor. Flushes cache and closes file.

flush

1 == $Io -> flush ()

Flush $Io cache, if caching is turned on.

name

$name = $Io -> name ()

Returns name of $Io.

open

$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

read

1||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.

rw_iolist

1||0 == $Io -> rw_iolist ("r"||"w", \$buf, $iolistO);

Read Iolist $Io into buffer $buf ("r"), or write buffer to Iolist $Io.

size

$len = $Io -> size ()

Returns size of $Io in bytes.

writable

1||O == $Io -> writable ()

$Io is writable (1) or not (0).

write

1||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.

SEE ALSO

OLE::Storage::Iolist, Startup

AUTHOR

Martin Schwartz <schwartz@cs.tu-berlin.de>