home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _a2aade16f1655e122ca562d6dcbe835b < prev    next >
Text File  |  2000-03-23  |  3KB  |  81 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>getopt - Process single-character switches with switch clustering</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> getopt - Process single-character switches with switch clustering</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. </UL>
  26. <!-- INDEX END -->
  27.  
  28. <HR>
  29. <P>
  30. <H1><A NAME="name">NAME</A></H1>
  31. <P>getopt - Process single-character switches with switch clustering</P>
  32. <P>getopts - Process single-character switches with switch clustering</P>
  33. <P>
  34. <HR>
  35. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  36. <UL>
  37. <LI>Linux</LI>
  38. <LI>Solaris</LI>
  39. <LI>Windows</LI>
  40. </UL>
  41. <HR>
  42. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  43. <PRE>
  44.     use Getopt::Std;</PRE>
  45. <PRE>
  46.     getopt('oDI');    # -o, -D & -I take arg.  Sets opt_* as a side effect.
  47.     getopt('oDI', \%opts);    # -o, -D & -I take arg.  Values in %opts
  48.     getopts('oif:');  # -o & -i are boolean flags, -f takes an argument
  49.                       # Sets opt_* as a side effect.
  50.     getopts('oif:', \%opts);  # options as above. Values in %opts</PRE>
  51. <P>
  52. <HR>
  53. <H1><A NAME="description">DESCRIPTION</A></H1>
  54. <P>The <CODE>getopt()</CODE> functions processes single-character switches with switch
  55. clustering.  Pass one argument which is a string containing all switches
  56. that take an argument.  For each switch found, sets $opt_x (where x is the
  57. switch name) to the value of the argument, or 1 if no argument.  Switches
  58. which take an argument don't care whether there is a space between the
  59. switch and the argument.</P>
  60. <P>Note that, if your code is running under the recommended <CODE>use strict
  61. 'vars'</CODE> pragma, you will need to declare these package variables
  62. with ``our'':</P>
  63. <PRE>
  64.     our($opt_foo, $opt_bar);</PRE>
  65. <P>For those of you who don't like additional global variables being created, <CODE>getopt()</CODE>
  66. and <CODE>getopts()</CODE> will also accept a hash reference as an optional second argument. 
  67. Hash keys will be x (where x is the switch name) with key values the value of
  68. the argument or 1 if no argument is specified.</P>
  69. <P>To allow programs to process arguments that look like switches, but aren't,
  70. both functions will stop processing switches when they see the argument
  71. <CODE>--</CODE>.  The <CODE>--</CODE> will be removed from @ARGV.</P>
  72. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  73. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  74. <STRONG><P CLASS=block> getopt - Process single-character switches with switch clustering</P></STRONG>
  75. </TD></TR>
  76. </TABLE>
  77.  
  78. </BODY>
  79.  
  80. </HTML>
  81.