Brendt Wohlberg > File-Properties-0.02 > File::Properties::Generic

Download:
File-Properties-0.02.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.01   Source  

NAME ^

File::Properties::Generic - Perl module representing properties of a generic disk file

SYNOPSIS ^

  use File::Properties::Generic;

  my $fpg = File::Properties::Generic->new('/path/to/file');
  print $fpg->string . "\n";

ABSTRACT ^

  File::Properties::Generic is a Perl module representing properties
  of a generic disk file.

DESCRIPTION ^

  File::Properties::Generic is a Perl module representing properties
  of a generic disk file. On architectures on which stat is fully
  supported, indicated by the value of flag
  $File::Properties::Generic::FullStatSupport, these properties
  include device and inode numbers. This flag is currently only set
  true for Unix operating systems (since others were not available for
  testing); on other platforms on which stat does indeed provide
  meaningful device and inode numbers, this value can be forced by
  including a line

  $File::Properties::Generic::FullStatSupport = 1;

  before initialisation of any File::Properties objects.
new
  my $fpg = File::Properties::Generic->new('/path/to/file');

Constructs a new File::Properties::Generic object.

path
  print "Canonical path: " . $fpg->path . "\n";

Determine the canonical path of the represented file.

device
  print "Device number: " . $fpg->device . "\n";

Determine the device number of the represented file.

inode
  print "Inode number: " . $fpg->inode . "\n";

Determine the inode number of the represented file.

size
  print "File size: " . $fpg->size . "\n";

Determine the size of the represented file.

mtime
  print "Modification time: " . $fpg->mtime . "\n";

Determine the modification time of the represented file.

mode
  print "File mode: " . $fpg->mode . "\n";

Determine the file mode integer (representing permissions and type) for the represented file.

children
  my $chsh = $fpg->children;

If the represented file is a directory, return a hash mapping file names within that directory to corresponding File::Properties::Generic object references.

isreg
  print (($fpg->isreg)?"Is regular file\n":"Not regular file\n");

Determine if the represented file is a regular file.

isdir
  print (($fpg->isdir)?"Is directory\n":"Not directory\n");

Determine if the represented file is a directory.

string
  print $fpg->string . "\n";

Construct a string representing the object data.

SEE ALSO ^

File::Properties, Cwd, File::stat, Fcntl

AUTHOR ^

Brendt Wohlberg <wohl@cpan.org>

COPYRIGHT AND LICENSE ^

Copyright (C) 2010,2011 by Brendt Wohlberg

This library is available under the terms of the GNU General Public License (GPL), described in the LICENSE file included in this distribution.

syntax highlighting: