Seth Woolley's Man Viewer

Errno(3)               Perl Programmers Reference Guide               Errno(3)



NAME
       Errno - System errno constants

SYNOPSIS
           use Errno qw(EINTR EIO :POSIX);

DESCRIPTION
       "Errno" defines and conditionally exports all the error(8,n) constants
       defined in(1,8) your system "errno.h" include file. It has a single export
       tag, ":POSIX", which will export all POSIX defined error(8,n) numbers.

       "Errno" also makes "%!" magic(4,5) such that each element of "%!" has a non-
       zero value only if(3,n) $! is set(7,n,1 builtins) to that value. For example:

           use Errno;

           unless (open(2,3,n)(FH, "/fangorn/spouse")) {
               if(3,n) ($!{ENOENT}) {
                   warn "Get a wife!\n";
               } else {
                   warn "This path is barred: $!";
               }
           }

       If a specified constant "EFOO" does not exist on the system, $!{EFOO}
       returns "".  You may use "exists $!{EFOO}" to check whether the con-
       stant is available on the system.

CAVEATS
       Importing a particular constant may not be very portable, because the
       import will fail on platforms that do not have that constant.  A more
       portable way to set(7,n,1 builtins) $! to a valid value is to use:

           if(3,n) (exists &Errno::EFOO) {
               $! = &Errno::EFOO;
           }

AUTHOR
       Graham Barr <gbarr@pobox.com>

COPYRIGHT
       Copyright (c) 1997-8 Graham Barr. All rights reserved.  This program is
       free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.



perl v5.8.5                       2001-09-21                          Errno(3)