This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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



NAME
       Errno - System errno constants

SYNOPSIS
           use Errno qw(EINTR EIO :POSIX);

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

       "Errno" also makes "%!" magic such that each element of "%!" has a non-zero value only if $! is set
       to that value. For example:

           use Errno;

           unless (open(FH, "/fangorn/spouse")) {
               if ($!{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 constant 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 $! to a valid value is to use:

           if (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 redis-tribute redistribute
       tribute it and/or modify it under the same terms as Perl itself.



perl v5.8.8                                      2001-09-21                                       Errno(3pm)