use Path::Extended::File; my $file = Path::Extended::File->new('path/to/some.file');
creates an appropriate object. Note that this base class itself doesn't hold anything.
may take an optional hash, and returns an absolute path of the file/directory. Note that back slashes in the path will be converted to forward slashes unless you explicitly set a
native option to true.
may take an optional hash, and returns a relative path of the file/directory (compared to the current directory (Cwd::cwd) by default, but you may change this bahavior by passing a
base option). Note that back slashes in the path will be converted to forward slashes unless you explicitly set a
native option to true.
returns if the path you passed to the constructor was absolute or not (note that the path stored in an object is always absolute).
returns if the object represents directory or not.
does a physical cleanup of the path with Cwd::realpath, that means, resolves a symbolic link if necessary. Note that this method may croak (when the path does not exist).
copies the file/directory to the destination by
moves the file/directory to the destination by
File::Copy::move. If the file/directory is open, it'll automatically close.
renames the file/directory. If the file/directory is open, it'll automatically close. If your OS allows rename of an open file, you may want to use built-in
rename function for better atomicity.
unlinks the file/directory. The same thing can be said as for the
returns true if the file/directory exists.
returns true if the file/directory is readable/writable.
returns true if the file/directory is open.
returns a File::stat object for the file/directory.
returns a Path::Extended::Dir object that points to the parent directory of the file/directory.
explicitly returns a path string.
You may optionally pass a logger object with
log method that accepts
( label => @log_messages ) array arguments to notifty when some (usually unfavorable) thing occurs. By default, a built-in Carp logger will be used. If you want to disable logging, set a false value to
logger. See Log::Dump for details, and for how to use
Kenichi Ishigaki, <firstname.lastname@example.org>
Copyright (C) 2008 by Kenichi Ishigaki.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.