Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

getopt::std5.18(3pm) [mojave man page]

Getopt::Std(3pm)					 Perl Programmers Reference Guide					  Getopt::Std(3pm)

NAME

       getopt, getopts - Process single-character switches with switch clustering

SYNOPSIS

	   use Getopt::Std;

	   getopt('oDI');    # -o, -D & -I take arg.  Sets $opt_* as a side effect.
	   getopt('oDI', \%opts);    # -o, -D & -I take arg.  Values in %opts
	   getopts('oif:');  # -o & -i are boolean flags, -f takes an argument
			     # Sets $opt_* as a side effect.
	   getopts('oif:', \%opts);  # options as above. Values in %opts

DESCRIPTION

       The getopt() function processes single-character switches with switch clustering.  Pass one argument which is a string containing all
       switches that take an argument.	For each switch found, sets $opt_x (where x is the switch name) to the value of the argument if an
       argument is expected, or 1 otherwise.  Switches which take an argument don't care whether there is a space between the switch and the
       argument.

       The getopts() function is similar, but you should pass to it the list of all switches to be recognized.	If unspecified switches are found
       on the command-line, the user will be warned that an unknown option was given.  The getopts() function returns true unless an invalid
       option was found.

       Note that, if your code is running under the recommended "use strict 'vars'" pragma, you will need to declare these package variables with
       "our":

	   our($opt_x, $opt_y);

       For those of you who don't like additional global variables being created, getopt() and getopts() will also accept a hash reference as an
       optional second argument.  Hash keys will be x (where x is the switch name) with key values the value of the argument or 1 if no argument
       is specified.

       To allow programs to process arguments that look like switches, but aren't, both functions will stop processing switches when they see the
       argument "--".  The "--" will be removed from @ARGV.

"--help" and "--version"
       If "-" is not a recognized switch letter, getopts() supports arguments "--help" and "--version".  If "main::HELP_MESSAGE()" and/or
       "main::VERSION_MESSAGE()" are defined, they are called; the arguments are the output file handle, the name of option-processing package,
       its version, and the switches string.  If the subroutines are not defined, an attempt is made to generate intelligent messages; for best
       results, define $main::VERSION.

       If embedded documentation (in pod format, see perlpod) is detected in the script, "--help" will also show how to access the documentation.

       Note that due to excessive paranoia, if $Getopt::Std::STANDARD_HELP_VERSION isn't true (the default is false), then the messages are
       printed on STDERR, and the processing continues after the messages are printed.	This being the opposite of the standard-conforming
       behaviour, it is strongly recommended to set $Getopt::Std::STANDARD_HELP_VERSION to true.

       One can change the output file handle of the messages by setting $Getopt::Std::OUTPUT_HELP_VERSION.  One can print the messages of "--help"
       (without the "Usage:" line) and "--version" by calling functions help_mess() and version_mess() with the switches string as an argument.

perl v5.18.2							    2014-01-06							  Getopt::Std(3pm)

Check Out this Related Man Page

AppConfig::Getopt(3)					User Contributed Perl Documentation				      AppConfig::Getopt(3)

NAME

       AppConfig::Getopt - Perl5 module for processing command line arguments via delegation to Getopt::Long.

SYNOPSIS

	   use AppConfig::Getopt;

	   my $state  = AppConfig::State->new(\%cfg);
	   my $getopt = AppConfig::Getopt->new($state);

	   $getopt->parse(@args);	      # read args

OVERVIEW

       AppConfig::Getopt is a Perl5 module which delegates to Johan Vroman's Getopt::Long module to parse command line arguments and update values
       in an AppConfig::State object accordingly.

       AppConfig::Getopt is distributed as part of the AppConfig bundle.

DESCRIPTION

   USING THE AppConfig::Getopt MODULE
       To import and use the AppConfig::Getopt module the following line should appear in your Perl script:

	   use AppConfig::Getopt;

       AppConfig::Getopt is used automatically if you use the AppConfig module and create an AppConfig::Getopt object through the getopt() method.

       AppConfig::Getopt is implemented using object-oriented methods.	A new AppConfig::Getopt object is created and initialised using the new()
       method.	This returns a reference to a new AppConfig::Getopt object.  A reference to an AppConfig::State object should be passed in as the
       first parameter:

	   my $state  = AppConfig::State->new();
	   my $getopt = AppConfig::Getopt->new($state);

       This will create and return a reference to a new AppConfig::Getopt object.

   PARSING COMMAND LINE ARGUMENTS
       The "parse()" method is used to read a list of command line arguments and update the state accordingly.

       The first (non-list reference) parameters may contain a number of configuration strings to pass to Getopt::Long::Configure.  A reference to
       a list of arguments may additionally be passed or @ARGV is used by default.

	   $getopt->parse();			   # uses @ARGV
	   $getopt->parse(@myargs);
	   $getopt->parse(qw(auto_abbrev debug));  # uses @ARGV
	   $getopt->parse(qw(debug), @myargs);

       See Getopt::Long for details of the configuartion options available.

       A Getopt::Long specification string is constructed for each variable defined in the AppConfig::State.  This consists of the name, any
       aliases and the ARGS value for the variable.

       These specification string are then passed to Getopt::Long, the arguments are parsed and the values in the AppConfig::State updated.

       See AppConfig for information about using the AppConfig::Getopt module via the getopt() method.

AUTHOR

       Andy Wardley, <abw@wardley.org>

COPYRIGHT

       Copyright (C) 1997-2007 Andy Wardley.  All Rights Reserved.

       Copyright (C) 1997,1998 Canon Research Centre Europe Ltd.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

ACKNOWLEDGMENTS

       Many thanks are due to Johan Vromans for the Getopt::Long module.  He was kind enough to offer assistance and access to early releases of
       his code to enable this module to be written.

SEE ALSO

       AppConfig, AppConfig::State, AppConfig::Args, Getopt::Long

perl v5.16.3							    2007-05-30						      AppConfig::Getopt(3)
Man Page