NAME<\/a> IO::AtomicFile \u2212 write a file which is updated atomically<\/p>\n use strict; This module is intended for people who need to update files reliably in the face of unexpected program termination.<\/p>\n For example, you generally don\u2019t want to be halfway in the middle of writing \/etc\/passwd<\/i> and have your program terminate! Even the act of writing a single scalar to a filehandle is not<\/i> atomic.<\/p>\n But this module gives you true atomic updates, via “rename”. When you open a file \/foo\/bar.dat<\/i> via this module, you are actually<\/i> opening a temporary file \/foo\/bar.dat..TMP<\/i>, and writing your output there. The act of closing this file (either explicitly via “close”, or implicitly via the destruction of the object) will cause “rename” to be called… therefore, from the point of view of the outside world, the file\u2019s contents are updated in a single time quantum.<\/p>\n To ensure that problems do not go undetected, the “close” method done by the destructor will raise a fatal exception if the “rename” fails. The explicit “close” just returns “undef”.<\/p>\n You can also decide at any point to trash the file you\u2019ve been building.<\/p>\n IO::AtomicFile inherits all methods from IO::File and implements the following new ones.<\/p>\n close<\/b> This method calls its parent “close” in IO::File and then renames its temporary file as the original file name.<\/p>\n delete<\/b> This method calls its parent “close” in IO::File and then deletes the temporary file.<\/p>\n detach<\/b> This method calls its parent “close” in IO::File. Unlike “delete” in IO::AtomicFile it does not then delete the temporary file.<\/p>\n Eryq (eryq@zeegee.com<\/i>). President, ZeeGee Software Inc (http:\/\/www.zeegee.com<\/i>).<\/p>\n
SYNOPSIS<\/a>
DESCRIPTION<\/a>
METHODS<\/a>
AUTHOR<\/a>
CONTRIBUTORS<\/a>
COPYRIGHT & LICENSE<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
use warnings;
use feature ‘say’;
use IO::AtomicFile;
# Write a temp file, and have it install itself when closed:
my $fh = IO::AtomicFile\u2212>open(“bar.dat”, “w”);
$fh\u2212>say(“Hello!”);
$fh\u2212>close || die “couldn’t install atomic file: $!”;
# Write a temp file, but delete it before it gets installed:
my $fh = IO::AtomicFile\u2212>open(“bar.dat”, “w”);
$fh\u2212>say(“Hello!”);
$fh\u2212>delete;
# Write a temp file, but neither install it nor delete it:
my $fh = IO::AtomicFile\u2212>open(“bar.dat”, “w”);
$fh\u2212>say(“Hello!”);
$fh\u2212>detach;<\/p>\nDESCRIPTION <\/a> <\/h2>\n
METHODS <\/a> <\/h2>\n
$fh\u2212>close();<\/p>\n
$fh\u2212>delete();<\/p>\n
$fh\u2212>detach();<\/p>\nAUTHOR <\/a> <\/h2>\n
CONTRIBUTORS <\/a> <\/h2>\n