home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _1495a4d4dcd212e19f5820c53ba1c37d < prev    next >
Text File  |  2000-03-23  |  3KB  |  97 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Errno - System errno constants</TITLE>
  5. <LINK REL="stylesheet" HREF="../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Errno - System errno constants</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#caveats">CAVEATS</A></LI>
  26.     <LI><A HREF="#author">AUTHOR</A></LI>
  27.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  28. </UL>
  29. <!-- INDEX END -->
  30.  
  31. <HR>
  32. <P>
  33. <H1><A NAME="name">NAME</A></H1>
  34. <P>Errno - System errno constants</P>
  35. <P>
  36. <HR>
  37. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  38. <UL>
  39. <LI>Linux</LI>
  40. <LI>Solaris</LI>
  41. <LI>Windows</LI>
  42. </UL>
  43. <HR>
  44. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  45. <PRE>
  46.     use Errno qw(EINTR EIO :POSIX);</PRE>
  47. <P>
  48. <HR>
  49. <H1><A NAME="description">DESCRIPTION</A></H1>
  50. <P><CODE>Errno</CODE> defines and conditionally exports all the error constants
  51. defined in your system <CODE>errno.h</CODE> include file. It has a single export
  52. tag, <CODE>:POSIX</CODE>, which will export all POSIX defined error numbers.</P>
  53. <P><CODE>Errno</CODE> also makes <CODE>%!</CODE> magic such that each element of <CODE>%!</CODE> has a
  54. non-zero value only if <CODE>$!</CODE> is set to that value. For example:</P>
  55. <PRE>
  56.     use Errno;</PRE>
  57. <PRE>
  58.     unless (open(FH, "/fangorn/spouse")) {
  59.         if ($!{ENOENT}) {
  60.             warn "Get a wife!\n";
  61.         } else {
  62.             warn "This path is barred: $!";
  63.         } 
  64.     }</PRE>
  65. <P>If a specified constant <CODE>EFOO</CODE> does not exist on the system, <CODE>$!{EFOO}</CODE>
  66. returns <CODE>""</CODE>.  You may use <CODE>exists $!{EFOO}</CODE> to check whether the
  67. constant is available on the system.</P>
  68. <P>
  69. <HR>
  70. <H1><A NAME="caveats">CAVEATS</A></H1>
  71. <P>Importing a particular constant may not be very portable, because the
  72. import will fail on platforms that do not have that constant.  A more
  73. portable way to set <CODE>$!</CODE> to a valid value is to use:</P>
  74. <PRE>
  75.     if (exists &Errno::EFOO) {
  76.         $! = &Errno::EFOO;
  77.     }</PRE>
  78. <P>
  79. <HR>
  80. <H1><A NAME="author">AUTHOR</A></H1>
  81. <P>Graham Barr <<A HREF="mailto:gbarr@pobox.com">gbarr@pobox.com</A>></P>
  82. <P>
  83. <HR>
  84. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  85. <P>Copyright (c) 1997-8 Graham Barr. All rights reserved.
  86. This program is free software; you can redistribute it and/or modify it
  87. under the same terms as Perl itself.</P>
  88. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  89. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  90. <STRONG><P CLASS=block> Errno - System errno constants</P></STRONG>
  91. </TD></TR>
  92. </TABLE>
  93.  
  94. </BODY>
  95.  
  96. </HTML>
  97.