getopt is a C library function used to parse command-line options.
It is also the name of a Unix program for parsing command line arguments in shell scripts.
Contents |
A long standing issue with command line programs was how to specify options; early programs used many ways of doing so, including single character options (-a), multiple options specified together (-abc is equivalent to -a -b -c), multicharacter options (-inum), options with arguments (-a arg, -inum 3, -a=arg), and different prefix characters (-a, +b, /c). The getopt function was written to be a standard mechanism that all programs could use to parse command-line options so that there would be a common interface that everyone could depend on. As such, the original authors picked out of the variations support for single character options, multiple options specified together, and options with arguments (-a arg or -aarg), all controllable by an option string.
getopt was first published by AT&T at the 1985 UNIFORUM conference in Dallas, Texas, with the intent for it to be available in the public domain. Versions of it were subsequently picked up by other flavors of Unix (BSD 4.3, Linux, etc.). It is specified in the POSIX.2 standard as part of the unistd.h header file. Derivatives of getopt have been created for many programming languages to parse command-line options.
A GNU extension, getopt_long, allows parsing of more readable, multicharacter options, which are introduced by two dashes instead of one. The choice of two dashes allows multicharacter options (--inum) to be differentiated from single character options specified together (-abc). The GNU extension also allows an alternative format for options with arguments: --name=arg.
getopt is not a system independent function. The implementation of getopt in GNU C Library does permute the contents of the argument vector as it scans, so that eventually all the non-option arguments are at the end. On the contrary, the implementation of getopt in BSD C Library does not permute the argument vector and returns -1 if it encounters a non-option argument.
#include <stdio.h> /* for printf */ #include <stdlib.h> /* for exit */ #include <unistd.h> /* for getopt */ int main (int argc, char **argv) { int c; int digit_optind = 0; int aopt = 0, bopt = 0; char *copt = 0, *dopt = 0; while ( (c = getopt(argc, argv, "abc:d:012")) != -1) { int this_option_optind = optind ? optind : 1; switch (c) { case '0': case '1': case '2': if (digit_optind != 0 && digit_optind != this_option_optind) printf ("digits occur in two different argv-elements.\n"); digit_optind = this_option_optind; printf ("option %c\n", c); break; case 'a': printf ("option a\n"); aopt = 1; break; case 'b': printf ("option b\n"); bopt = 1; break; case 'c': printf ("option c with value '%s'\n", optarg); copt = optarg; break; case 'd': printf ("option d with value '%s'\n", optarg); dopt = optarg; break; case '?': break; default: printf ("?? getopt returned character code 0%o ??\n", c); } } if (optind < argc) { printf ("non-option ARGV-elements: "); while (optind < argc) printf ("%s ", argv[optind++]); printf ("\n"); } exit (0); }
#include <stdio.h> /* for printf */ #include <stdlib.h> /* for exit */ #include <getopt.h> /* for getopt_long; standard getopt is in unistd.h */ int main (int argc, char **argv) { int c; int digit_optind = 0; int aopt = 0, bopt = 0; char *copt = 0, *dopt = 0; static struct option long_options[] = { {"add", 1, 0, 0}, {"append", 0, 0, 0}, {"delete", 1, 0, 0}, {"verbose", 0, 0, 0}, {"create", 1, 0, 'c'}, {"file", 1, 0, 0}, {NULL, 0, NULL, 0} }; int option_index = 0; while ((c = getopt_long(argc, argv, "abc:d:012", long_options, &option_index)) != -1) { int this_option_optind = optind ? optind : 1; switch (c) { case 0: printf ("option %s", long_options[option_index].name); if (optarg) printf (" with arg %s", optarg); printf ("\n"); break; case '0': case '1': case '2': if (digit_optind != 0 && digit_optind != this_option_optind) printf ("digits occur in two different argv-elements.\n"); digit_optind = this_option_optind; printf ("option %c\n", c); break; case 'a': printf ("option a\n"); aopt = 1; break; case 'b': printf ("option b\n"); bopt = 1; break; case 'c': printf ("option c with value '%s'\n", optarg); copt = optarg; break; case 'd': printf ("option d with value '%s'\n", optarg); dopt = optarg; break; case '?': break; default: printf ("?? getopt returned character code 0%o ??\n", c); } } if (optind < argc) { printf ("non-option ARGV-elements: "); while (optind < argc) printf ("%s ", argv[optind++]); printf ("\n"); } exit (0); }
The Unix shell command program called getopt can be used for parsing command line arguments in shell scripts.
There are two major versions of the getopt shell command program. The original version was implemented by UNIX System Laboratories. There is also a GNU enhanced version that supports additional features (such as long option names and whitespace in parameters).
Command line parsing in shell scripts can also be performed using the getopts built-in shell command. The syntax for using getopts is very different to the syntax of getopt. Although getopts has more features than the original getopt program, it does not have some of the features that the GNU enhanced version of getopt does. For example, getopts does not support long option names. The getopts is a built-in Unix shell command, unlike getopt (either the original version or the GNU enhanced version) which is an external command line program.
The D programming language has a getopt module in the standard library.
Haskell comes with System.Console.GetOpt in the base library which is essentially a Haskell port of the GNU getopt library.[1]
The Java standard library does not have an implementation of getopt in its standard library. Several third party modules exist, including one that uses the GNU extensions.
Lisp has many different dialects with no common standard library. There are some third party implementations of getopt for some dialects of Lisp. Common Lisp has a prominent third party implementation.
Free Pascal has its own implementation as one of its standard units named GetOpts. It's supported on all platforms.
Perl has two separate derivatives of getopt in its standard library: Getopt::Long[2] and Getopt::Std.[3]
PHP has a getopt() function.[4]
Python contains a module in its standard library based on C's getopt and GNU extensions.[5] Python's standard library also contains modules to parse options that are more convenient to use.
Ruby has an implementation of getopt_long in its standard library, GetoptLong. Ruby also has modules in its standard library with a more sophisticated and convenient interface. A third party implementation of the original getopt interface is available.
The .NET Framework does not have getopt functionality in its standard library. Third-party implementations are available.[6]