NAME

Language::Befunge::IP::lib::FILE - file operations

DESCRIPTION

The FILE fingerprint (0x46494C45) allows to do file operations.

FUNCTIONS

new

Create a new FILE instance.

file operations

Those operations act as r upon failure.

C( $fid )

Close filehandle corresponding to $fid.

D ( $path )

Delete file $path (a 0gnirts).

($fid, $line, $count) = G ( $fid )

Read $line from filehandle corresponding to $fid, and push back the file id, as well as the line read and the $count bytes read.

($fid, $pos) = L( $fid )

Fetch current $pos within the file corresponding to filehandle $fid, and push it back on the stack (as well as $fid again).

$fid = O( $vec, $mode, $path )

Open the file $path (a 0gnirts) with $mode, storing $vec as the i/o buffer. Push back $fid on the stack, the filehandle id. Mode can be one of:

• 0 read
• 1 write
• 2 append
• 3 read/write
• 4 truncate read/write
• 5 append read/write

$fid = P( $fid, $string )

Write $string to file corresponding to $fid.

$fid = R( $fid, $count )

Read $count bytes from file $fid and put it to i/o buffer. Put back $fid on the stack.

$fid = S( $fid, $mode, $pos )

Seek to position $pos in file $fid. $mode can be one of:

• 0 from beginning
• 1 from current location
• 2 from end

* $fid = W( $fid, $count )

Write $count bytes from buffer to file $fid. Put back $fid on the stack.

SEE ALSO

Language::Befunge, http://www.rcfunge98.com/rcsfingers.html#FILE.

AUTHOR

Jerome Quelin, <jquelin@cpan.org>

COPYRIGHT & LICENSE

Copyright (c) 2001-2009 Jerome Quelin, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.