Perl Programming/Keywords/stat

From Wikibooks, open books for an open world
Jump to navigation Jump to search
Previous: srand Keywords Next: state

The stat keyword[edit | edit source]

stat returns a list with 13 elements with the status information for a file that is either opened with the DIRHANDLE or FILEHANDLE, or by an EXPRESSION. Without the EXPRESSION, $_ is stat. If the operation fails, it returns an empty list.


If the variable list VARIABLES of stat has more than one element, the list has to be placed in brackets. In such a list, undef can be used as a placeholder.

If more than one stat with the same name are declared within the same lexical scope, Perl issues a warning, as it is the case with multiple my declarations, but they are seen as redundant.

stat variables can only be used with the use feature "state" pragma, unless it is written fully as CORE::state.

Syntax[edit | edit source]

  stat FILEHANDLE
  stat EXPRESSION
  stat DIRHANDLE
  stat

Examples[edit | edit source]

($dev, $ino, $mode, $nlink, $uid, $gid, $rdev, $size,
       $atime, $mtime, $ctime, $blksize, $blocks)
           = stat($filename);
Previous: srand Keywords Next: state