Don't AC_REQUIRE([AC_PROG_CC_STDC]).
[gnulib.git] / lib / getopt.c
blob08ba35be363777fd12e79d7442ff9e15f1aa278c
1 /* Getopt for GNU.
2 NOTE: getopt is now part of the C library, so if you don't know what
3 "Keep this file name-space clean" means, talk to drepper@gnu.org
4 before changing it!
5 Copyright (C) 1987,88,89,90,91,92,93,94,95,96,98,99,2000,2001
6 Free Software Foundation, Inc.
7 This file is part of the GNU C Library.
9 The GNU C Library is free software; you can redistribute it and/or
10 modify it under the terms of the GNU Lesser General Public
11 License as published by the Free Software Foundation; either
12 version 2.1 of the License, or (at your option) any later version.
14 The GNU C Library is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 Lesser General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public
20 License along with the GNU C Library; if not, write to the Free
21 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
22 02111-1307 USA. */
24 /* This tells Alpha OSF/1 not to define a getopt prototype in <stdio.h>.
25 Ditto for AIX 3.2 and <stdlib.h>. */
26 #ifndef _NO_PROTO
27 # define _NO_PROTO
28 #endif
30 #ifdef HAVE_CONFIG_H
31 # include <config.h>
32 #endif
34 #if !defined __STDC__ || !__STDC__
35 /* This is a separate conditional since some stdc systems
36 reject `defined (const)'. */
37 # ifndef const
38 # define const
39 # endif
40 #endif
42 #include <stdio.h>
44 /* Comment out all this code if we are using the GNU C Library, and are not
45 actually compiling the library itself. This code is part of the GNU C
46 Library, but also included in many other GNU distributions. Compiling
47 and linking in this code is a waste when using the GNU C library
48 (especially if it is a shared library). Rather than having every GNU
49 program understand `configure --with-gnu-libc' and omit the object files,
50 it is simpler to just do this in the source for each such file. */
52 #define GETOPT_INTERFACE_VERSION 2
53 #if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2
54 # include <gnu-versions.h>
55 # if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION
56 # define ELIDE_CODE
57 # endif
58 #endif
60 #ifndef ELIDE_CODE
63 /* This needs to come after some library #include
64 to get __GNU_LIBRARY__ defined. */
65 #ifdef __GNU_LIBRARY__
66 /* Don't include stdlib.h for non-GNU C libraries because some of them
67 contain conflicting prototypes for getopt. */
68 # include <stdlib.h>
69 # include <unistd.h>
70 #endif /* GNU C library. */
72 #ifdef VMS
73 # include <unixlib.h>
74 # if HAVE_STRING_H - 0
75 # include <string.h>
76 # endif
77 #endif
79 #ifndef _
80 /* This is for other GNU distributions with internationalized messages. */
81 # if (HAVE_LIBINTL_H && ENABLE_NLS) || defined _LIBC
82 # include <libintl.h>
83 # ifndef _
84 # define _(msgid) gettext (msgid)
85 # endif
86 # else
87 # define _(msgid) (msgid)
88 # endif
89 #endif
91 /* This version of `getopt' appears to the caller like standard Unix `getopt'
92 but it behaves differently for the user, since it allows the user
93 to intersperse the options with the other arguments.
95 As `getopt' works, it permutes the elements of ARGV so that,
96 when it is done, all the options precede everything else. Thus
97 all application programs are extended to handle flexible argument order.
99 Setting the environment variable POSIXLY_CORRECT disables permutation.
100 Then the behavior is completely standard.
102 GNU application programs can use a third alternative mode in which
103 they can distinguish the relative order of options and other arguments. */
105 #include "getopt.h"
107 /* For communication from `getopt' to the caller.
108 When `getopt' finds an option that takes an argument,
109 the argument value is returned here.
110 Also, when `ordering' is RETURN_IN_ORDER,
111 each non-option ARGV-element is returned here. */
113 char *optarg;
115 /* Index in ARGV of the next element to be scanned.
116 This is used for communication to and from the caller
117 and for communication between successive calls to `getopt'.
119 On entry to `getopt', zero means this is the first call; initialize.
121 When `getopt' returns -1, this is the index of the first of the
122 non-option elements that the caller should itself scan.
124 Otherwise, `optind' communicates from one call to the next
125 how much of ARGV has been scanned so far. */
127 /* 1003.2 says this must be 1 before any call. */
128 int optind = 1;
130 /* Formerly, initialization of getopt depended on optind==0, which
131 causes problems with re-calling getopt as programs generally don't
132 know that. */
134 int __getopt_initialized;
136 /* The next char to be scanned in the option-element
137 in which the last option character we returned was found.
138 This allows us to pick up the scan where we left off.
140 If this is zero, or a null string, it means resume the scan
141 by advancing to the next ARGV-element. */
143 static char *nextchar;
145 /* Callers store zero here to inhibit the error message
146 for unrecognized options. */
148 int opterr = 1;
150 /* Set to an option character which was unrecognized.
151 This must be initialized on some systems to avoid linking in the
152 system's own getopt implementation. */
154 int optopt = '?';
156 /* Describe how to deal with options that follow non-option ARGV-elements.
158 If the caller did not specify anything,
159 the default is REQUIRE_ORDER if the environment variable
160 POSIXLY_CORRECT is defined, PERMUTE otherwise.
162 REQUIRE_ORDER means don't recognize them as options;
163 stop option processing when the first non-option is seen.
164 This is what Unix does.
165 This mode of operation is selected by either setting the environment
166 variable POSIXLY_CORRECT, or using `+' as the first character
167 of the list of option characters.
169 PERMUTE is the default. We permute the contents of ARGV as we scan,
170 so that eventually all the non-options are at the end. This allows options
171 to be given in any order, even with programs that were not written to
172 expect this.
174 RETURN_IN_ORDER is an option available to programs that were written
175 to expect options and other ARGV-elements in any order and that care about
176 the ordering of the two. We describe each non-option ARGV-element
177 as if it were the argument of an option with character code 1.
178 Using `-' as the first character of the list of option characters
179 selects this mode of operation.
181 The special argument `--' forces an end of option-scanning regardless
182 of the value of `ordering'. In the case of RETURN_IN_ORDER, only
183 `--' can cause `getopt' to return -1 with `optind' != ARGC. */
185 static enum
187 REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER
188 } ordering;
190 /* Value of POSIXLY_CORRECT environment variable. */
191 static char *posixly_correct;
193 #ifdef __GNU_LIBRARY__
194 /* We want to avoid inclusion of string.h with non-GNU libraries
195 because there are many ways it can cause trouble.
196 On some systems, it contains special magic macros that don't work
197 in GCC. */
198 # include <string.h>
199 # define my_index strchr
200 #else
202 # if HAVE_STRING_H
203 # include <string.h>
204 # else
205 # include <strings.h>
206 # endif
208 /* Avoid depending on library functions or files
209 whose names are inconsistent. */
211 #ifndef getenv
212 extern char *getenv ();
213 #endif
215 static char *
216 my_index (str, chr)
217 const char *str;
218 int chr;
220 while (*str)
222 if (*str == chr)
223 return (char *) str;
224 str++;
226 return 0;
229 /* If using GCC, we can safely declare strlen this way.
230 If not using GCC, it is ok not to declare it. */
231 #ifdef __GNUC__
232 /* Note that Motorola Delta 68k R3V7 comes with GCC but not stddef.h.
233 That was relevant to code that was here before. */
234 # if (!defined __STDC__ || !__STDC__) && !defined strlen
235 /* gcc with -traditional declares the built-in strlen to return int,
236 and has done so at least since version 2.4.5. -- rms. */
237 extern int strlen (const char *);
238 # endif /* not __STDC__ */
239 #endif /* __GNUC__ */
241 #endif /* not __GNU_LIBRARY__ */
243 /* Handle permutation of arguments. */
245 /* Describe the part of ARGV that contains non-options that have
246 been skipped. `first_nonopt' is the index in ARGV of the first of them;
247 `last_nonopt' is the index after the last of them. */
249 static int first_nonopt;
250 static int last_nonopt;
252 #ifdef _LIBC
253 /* Bash 2.0 gives us an environment variable containing flags
254 indicating ARGV elements that should not be considered arguments. */
256 #ifdef USE_NONOPTION_FLAGS
257 /* Defined in getopt_init.c */
258 extern char *__getopt_nonoption_flags;
260 static int nonoption_flags_max_len;
261 static int nonoption_flags_len;
262 #endif
264 static int original_argc;
265 static char *const *original_argv;
267 /* Make sure the environment variable bash 2.0 puts in the environment
268 is valid for the getopt call we must make sure that the ARGV passed
269 to getopt is that one passed to the process. */
270 static void
271 __attribute__ ((unused))
272 store_args_and_env (int argc, char *const *argv)
274 /* XXX This is no good solution. We should rather copy the args so
275 that we can compare them later. But we must not use malloc(3). */
276 original_argc = argc;
277 original_argv = argv;
279 # ifdef text_set_element
280 text_set_element (__libc_subinit, store_args_and_env);
281 # endif /* text_set_element */
283 # ifdef USE_NONOPTION_FLAGS
284 # define SWAP_FLAGS(ch1, ch2) \
285 if (nonoption_flags_len > 0) \
287 char __tmp = __getopt_nonoption_flags[ch1]; \
288 __getopt_nonoption_flags[ch1] = __getopt_nonoption_flags[ch2]; \
289 __getopt_nonoption_flags[ch2] = __tmp; \
291 # else
292 # define SWAP_FLAGS(ch1, ch2)
293 # endif
294 #else /* !_LIBC */
295 # define SWAP_FLAGS(ch1, ch2)
296 #endif /* _LIBC */
298 /* Exchange two adjacent subsequences of ARGV.
299 One subsequence is elements [first_nonopt,last_nonopt)
300 which contains all the non-options that have been skipped so far.
301 The other is elements [last_nonopt,optind), which contains all
302 the options processed since those non-options were skipped.
304 `first_nonopt' and `last_nonopt' are relocated so that they describe
305 the new indices of the non-options in ARGV after they are moved. */
307 #if defined __STDC__ && __STDC__
308 static void exchange (char **);
309 #endif
311 static void
312 exchange (argv)
313 char **argv;
315 int bottom = first_nonopt;
316 int middle = last_nonopt;
317 int top = optind;
318 char *tem;
320 /* Exchange the shorter segment with the far end of the longer segment.
321 That puts the shorter segment into the right place.
322 It leaves the longer segment in the right place overall,
323 but it consists of two parts that need to be swapped next. */
325 #if defined _LIBC && defined USE_NONOPTION_FLAGS
326 /* First make sure the handling of the `__getopt_nonoption_flags'
327 string can work normally. Our top argument must be in the range
328 of the string. */
329 if (nonoption_flags_len > 0 && top >= nonoption_flags_max_len)
331 /* We must extend the array. The user plays games with us and
332 presents new arguments. */
333 char *new_str = malloc (top + 1);
334 if (new_str == NULL)
335 nonoption_flags_len = nonoption_flags_max_len = 0;
336 else
338 memset (__mempcpy (new_str, __getopt_nonoption_flags,
339 nonoption_flags_max_len),
340 '\0', top + 1 - nonoption_flags_max_len);
341 nonoption_flags_max_len = top + 1;
342 __getopt_nonoption_flags = new_str;
345 #endif
347 while (top > middle && middle > bottom)
349 if (top - middle > middle - bottom)
351 /* Bottom segment is the short one. */
352 int len = middle - bottom;
353 register int i;
355 /* Swap it with the top part of the top segment. */
356 for (i = 0; i < len; i++)
358 tem = argv[bottom + i];
359 argv[bottom + i] = argv[top - (middle - bottom) + i];
360 argv[top - (middle - bottom) + i] = tem;
361 SWAP_FLAGS (bottom + i, top - (middle - bottom) + i);
363 /* Exclude the moved bottom segment from further swapping. */
364 top -= len;
366 else
368 /* Top segment is the short one. */
369 int len = top - middle;
370 register int i;
372 /* Swap it with the bottom part of the bottom segment. */
373 for (i = 0; i < len; i++)
375 tem = argv[bottom + i];
376 argv[bottom + i] = argv[middle + i];
377 argv[middle + i] = tem;
378 SWAP_FLAGS (bottom + i, middle + i);
380 /* Exclude the moved top segment from further swapping. */
381 bottom += len;
385 /* Update records for the slots the non-options now occupy. */
387 first_nonopt += (optind - last_nonopt);
388 last_nonopt = optind;
391 /* Initialize the internal data when the first call is made. */
393 #if defined __STDC__ && __STDC__
394 static const char *_getopt_initialize (int, char *const *, const char *);
395 #endif
396 static const char *
397 _getopt_initialize (argc, argv, optstring)
398 int argc;
399 char *const *argv;
400 const char *optstring;
402 /* Start processing options with ARGV-element 1 (since ARGV-element 0
403 is the program name); the sequence of previously skipped
404 non-option ARGV-elements is empty. */
406 first_nonopt = last_nonopt = optind;
408 nextchar = NULL;
410 posixly_correct = getenv ("POSIXLY_CORRECT");
412 /* Determine how to handle the ordering of options and nonoptions. */
414 if (optstring[0] == '-')
416 ordering = RETURN_IN_ORDER;
417 ++optstring;
419 else if (optstring[0] == '+')
421 ordering = REQUIRE_ORDER;
422 ++optstring;
424 else if (posixly_correct != NULL)
425 ordering = REQUIRE_ORDER;
426 else
427 ordering = PERMUTE;
429 #if defined _LIBC && defined USE_NONOPTION_FLAGS
430 if (posixly_correct == NULL
431 && argc == original_argc && argv == original_argv)
433 if (nonoption_flags_max_len == 0)
435 if (__getopt_nonoption_flags == NULL
436 || __getopt_nonoption_flags[0] == '\0')
437 nonoption_flags_max_len = -1;
438 else
440 const char *orig_str = __getopt_nonoption_flags;
441 int len = nonoption_flags_max_len = strlen (orig_str);
442 if (nonoption_flags_max_len < argc)
443 nonoption_flags_max_len = argc;
444 __getopt_nonoption_flags =
445 (char *) malloc (nonoption_flags_max_len);
446 if (__getopt_nonoption_flags == NULL)
447 nonoption_flags_max_len = -1;
448 else
449 memset (__mempcpy (__getopt_nonoption_flags, orig_str, len),
450 '\0', nonoption_flags_max_len - len);
453 nonoption_flags_len = nonoption_flags_max_len;
455 else
456 nonoption_flags_len = 0;
457 #endif
459 return optstring;
462 /* Scan elements of ARGV (whose length is ARGC) for option characters
463 given in OPTSTRING.
465 If an element of ARGV starts with '-', and is not exactly "-" or "--",
466 then it is an option element. The characters of this element
467 (aside from the initial '-') are option characters. If `getopt'
468 is called repeatedly, it returns successively each of the option characters
469 from each of the option elements.
471 If `getopt' finds another option character, it returns that character,
472 updating `optind' and `nextchar' so that the next call to `getopt' can
473 resume the scan with the following option character or ARGV-element.
475 If there are no more option characters, `getopt' returns -1.
476 Then `optind' is the index in ARGV of the first ARGV-element
477 that is not an option. (The ARGV-elements have been permuted
478 so that those that are not options now come last.)
480 OPTSTRING is a string containing the legitimate option characters.
481 If an option character is seen that is not listed in OPTSTRING,
482 return '?' after printing an error message. If you set `opterr' to
483 zero, the error message is suppressed but we still return '?'.
485 If a char in OPTSTRING is followed by a colon, that means it wants an arg,
486 so the following text in the same ARGV-element, or the text of the following
487 ARGV-element, is returned in `optarg'. Two colons mean an option that
488 wants an optional arg; if there is text in the current ARGV-element,
489 it is returned in `optarg', otherwise `optarg' is set to zero.
491 If OPTSTRING starts with `-' or `+', it requests different methods of
492 handling the non-option ARGV-elements.
493 See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above.
495 Long-named options begin with `--' instead of `-'.
496 Their names may be abbreviated as long as the abbreviation is unique
497 or is an exact match for some defined option. If they have an
498 argument, it follows the option name in the same ARGV-element, separated
499 from the option name by a `=', or else the in next ARGV-element.
500 When `getopt' finds a long-named option, it returns 0 if that option's
501 `flag' field is nonzero, the value of the option's `val' field
502 if the `flag' field is zero.
504 The elements of ARGV aren't really const, because we permute them.
505 But we pretend they're const in the prototype to be compatible
506 with other systems.
508 LONGOPTS is a vector of `struct option' terminated by an
509 element containing a name which is zero.
511 LONGIND returns the index in LONGOPT of the long-named option found.
512 It is only valid when a long-named option has been found by the most
513 recent call.
515 If LONG_ONLY is nonzero, '-' as well as '--' can introduce
516 long-named options. */
519 _getopt_internal (argc, argv, optstring, longopts, longind, long_only)
520 int argc;
521 char *const *argv;
522 const char *optstring;
523 const struct option *longopts;
524 int *longind;
525 int long_only;
527 int print_errors = opterr;
528 if (optstring[0] == ':')
529 print_errors = 0;
531 if (argc < 1)
532 return -1;
534 optarg = NULL;
536 if (optind == 0 || !__getopt_initialized)
538 if (optind == 0)
539 optind = 1; /* Don't scan ARGV[0], the program name. */
540 optstring = _getopt_initialize (argc, argv, optstring);
541 __getopt_initialized = 1;
544 /* Test whether ARGV[optind] points to a non-option argument.
545 Either it does not have option syntax, or there is an environment flag
546 from the shell indicating it is not an option. The later information
547 is only used when the used in the GNU libc. */
548 #if defined _LIBC && defined USE_NONOPTION_FLAGS
549 # define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0' \
550 || (optind < nonoption_flags_len \
551 && __getopt_nonoption_flags[optind] == '1'))
552 #else
553 # define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0')
554 #endif
556 if (nextchar == NULL || *nextchar == '\0')
558 /* Advance to the next ARGV-element. */
560 /* Give FIRST_NONOPT & LAST_NONOPT rational values if OPTIND has been
561 moved back by the user (who may also have changed the arguments). */
562 if (last_nonopt > optind)
563 last_nonopt = optind;
564 if (first_nonopt > optind)
565 first_nonopt = optind;
567 if (ordering == PERMUTE)
569 /* If we have just processed some options following some non-options,
570 exchange them so that the options come first. */
572 if (first_nonopt != last_nonopt && last_nonopt != optind)
573 exchange ((char **) argv);
574 else if (last_nonopt != optind)
575 first_nonopt = optind;
577 /* Skip any additional non-options
578 and extend the range of non-options previously skipped. */
580 while (optind < argc && NONOPTION_P)
581 optind++;
582 last_nonopt = optind;
585 /* The special ARGV-element `--' means premature end of options.
586 Skip it like a null option,
587 then exchange with previous non-options as if it were an option,
588 then skip everything else like a non-option. */
590 if (optind != argc && !strcmp (argv[optind], "--"))
592 optind++;
594 if (first_nonopt != last_nonopt && last_nonopt != optind)
595 exchange ((char **) argv);
596 else if (first_nonopt == last_nonopt)
597 first_nonopt = optind;
598 last_nonopt = argc;
600 optind = argc;
603 /* If we have done all the ARGV-elements, stop the scan
604 and back over any non-options that we skipped and permuted. */
606 if (optind == argc)
608 /* Set the next-arg-index to point at the non-options
609 that we previously skipped, so the caller will digest them. */
610 if (first_nonopt != last_nonopt)
611 optind = first_nonopt;
612 return -1;
615 /* If we have come to a non-option and did not permute it,
616 either stop the scan or describe it to the caller and pass it by. */
618 if (NONOPTION_P)
620 if (ordering == REQUIRE_ORDER)
621 return -1;
622 optarg = argv[optind++];
623 return 1;
626 /* We have found another option-ARGV-element.
627 Skip the initial punctuation. */
629 nextchar = (argv[optind] + 1
630 + (longopts != NULL && argv[optind][1] == '-'));
633 /* Decode the current option-ARGV-element. */
635 /* Check whether the ARGV-element is a long option.
637 If long_only and the ARGV-element has the form "-f", where f is
638 a valid short option, don't consider it an abbreviated form of
639 a long option that starts with f. Otherwise there would be no
640 way to give the -f short option.
642 On the other hand, if there's a long option "fubar" and
643 the ARGV-element is "-fu", do consider that an abbreviation of
644 the long option, just like "--fu", and not "-f" with arg "u".
646 This distinction seems to be the most useful approach. */
648 if (longopts != NULL
649 && (argv[optind][1] == '-'
650 || (long_only && (argv[optind][2] || !my_index (optstring, argv[optind][1])))))
652 char *nameend;
653 const struct option *p;
654 const struct option *pfound = NULL;
655 int exact = 0;
656 int ambig = 0;
657 int indfound = -1;
658 int option_index;
660 for (nameend = nextchar; *nameend && *nameend != '='; nameend++)
661 /* Do nothing. */ ;
663 /* Test all long options for either exact match
664 or abbreviated matches. */
665 for (p = longopts, option_index = 0; p->name; p++, option_index++)
666 if (!strncmp (p->name, nextchar, nameend - nextchar))
668 if ((unsigned int) (nameend - nextchar)
669 == (unsigned int) strlen (p->name))
671 /* Exact match found. */
672 pfound = p;
673 indfound = option_index;
674 exact = 1;
675 break;
677 else if (pfound == NULL)
679 /* First nonexact match found. */
680 pfound = p;
681 indfound = option_index;
683 else if (long_only
684 || pfound->has_arg != p->has_arg
685 || pfound->flag != p->flag
686 || pfound->val != p->val)
687 /* Second or later nonexact match found. */
688 ambig = 1;
691 if (ambig && !exact)
693 if (print_errors)
694 fprintf (stderr, _("%s: option `%s' is ambiguous\n"),
695 argv[0], argv[optind]);
696 nextchar += strlen (nextchar);
697 optind++;
698 optopt = 0;
699 return '?';
702 if (pfound != NULL)
704 option_index = indfound;
705 optind++;
706 if (*nameend)
708 /* Don't test has_arg with >, because some C compilers don't
709 allow it to be used on enums. */
710 if (pfound->has_arg)
711 optarg = nameend + 1;
712 else
714 if (print_errors)
716 if (argv[optind - 1][1] == '-')
717 /* --option */
718 fprintf (stderr,
719 _("%s: option `--%s' doesn't allow an argument\n"),
720 argv[0], pfound->name);
721 else
722 /* +option or -option */
723 fprintf (stderr,
724 _("%s: option `%c%s' doesn't allow an argument\n"),
725 argv[0], argv[optind - 1][0], pfound->name);
728 nextchar += strlen (nextchar);
730 optopt = pfound->val;
731 return '?';
734 else if (pfound->has_arg == 1)
736 if (optind < argc)
737 optarg = argv[optind++];
738 else
740 if (print_errors)
741 fprintf (stderr,
742 _("%s: option `%s' requires an argument\n"),
743 argv[0], argv[optind - 1]);
744 nextchar += strlen (nextchar);
745 optopt = pfound->val;
746 return optstring[0] == ':' ? ':' : '?';
749 nextchar += strlen (nextchar);
750 if (longind != NULL)
751 *longind = option_index;
752 if (pfound->flag)
754 *(pfound->flag) = pfound->val;
755 return 0;
757 return pfound->val;
760 /* Can't find it as a long option. If this is not getopt_long_only,
761 or the option starts with '--' or is not a valid short
762 option, then it's an error.
763 Otherwise interpret it as a short option. */
764 if (!long_only || argv[optind][1] == '-'
765 || my_index (optstring, *nextchar) == NULL)
767 if (print_errors)
769 if (argv[optind][1] == '-')
770 /* --option */
771 fprintf (stderr, _("%s: unrecognized option `--%s'\n"),
772 argv[0], nextchar);
773 else
774 /* +option or -option */
775 fprintf (stderr, _("%s: unrecognized option `%c%s'\n"),
776 argv[0], argv[optind][0], nextchar);
778 nextchar = (char *) "";
779 optind++;
780 optopt = 0;
781 return '?';
785 /* Look at and handle the next short option-character. */
788 char c = *nextchar++;
789 char *temp = my_index (optstring, c);
791 /* Increment `optind' when we start to process its last character. */
792 if (*nextchar == '\0')
793 ++optind;
795 if (temp == NULL || c == ':')
797 if (print_errors)
799 if (posixly_correct)
800 /* 1003.2 specifies the format of this message. */
801 fprintf (stderr, _("%s: illegal option -- %c\n"),
802 argv[0], c);
803 else
804 fprintf (stderr, _("%s: invalid option -- %c\n"),
805 argv[0], c);
807 optopt = c;
808 return '?';
810 /* Convenience. Treat POSIX -W foo same as long option --foo */
811 if (temp[0] == 'W' && temp[1] == ';')
813 char *nameend;
814 const struct option *p;
815 const struct option *pfound = NULL;
816 int exact = 0;
817 int ambig = 0;
818 int indfound = 0;
819 int option_index;
821 /* This is an option that requires an argument. */
822 if (*nextchar != '\0')
824 optarg = nextchar;
825 /* If we end this ARGV-element by taking the rest as an arg,
826 we must advance to the next element now. */
827 optind++;
829 else if (optind == argc)
831 if (print_errors)
833 /* 1003.2 specifies the format of this message. */
834 fprintf (stderr, _("%s: option requires an argument -- %c\n"),
835 argv[0], c);
837 optopt = c;
838 if (optstring[0] == ':')
839 c = ':';
840 else
841 c = '?';
842 return c;
844 else
845 /* We already incremented `optind' once;
846 increment it again when taking next ARGV-elt as argument. */
847 optarg = argv[optind++];
849 /* optarg is now the argument, see if it's in the
850 table of longopts. */
852 for (nextchar = nameend = optarg; *nameend && *nameend != '='; nameend++)
853 /* Do nothing. */ ;
855 /* Test all long options for either exact match
856 or abbreviated matches. */
857 for (p = longopts, option_index = 0; p->name; p++, option_index++)
858 if (!strncmp (p->name, nextchar, nameend - nextchar))
860 if ((unsigned int) (nameend - nextchar) == strlen (p->name))
862 /* Exact match found. */
863 pfound = p;
864 indfound = option_index;
865 exact = 1;
866 break;
868 else if (pfound == NULL)
870 /* First nonexact match found. */
871 pfound = p;
872 indfound = option_index;
874 else
875 /* Second or later nonexact match found. */
876 ambig = 1;
878 if (ambig && !exact)
880 if (print_errors)
881 fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"),
882 argv[0], argv[optind]);
883 nextchar += strlen (nextchar);
884 optind++;
885 return '?';
887 if (pfound != NULL)
889 option_index = indfound;
890 if (*nameend)
892 /* Don't test has_arg with >, because some C compilers don't
893 allow it to be used on enums. */
894 if (pfound->has_arg)
895 optarg = nameend + 1;
896 else
898 if (print_errors)
899 fprintf (stderr, _("\
900 %s: option `-W %s' doesn't allow an argument\n"),
901 argv[0], pfound->name);
903 nextchar += strlen (nextchar);
904 return '?';
907 else if (pfound->has_arg == 1)
909 if (optind < argc)
910 optarg = argv[optind++];
911 else
913 if (print_errors)
914 fprintf (stderr,
915 _("%s: option `%s' requires an argument\n"),
916 argv[0], argv[optind - 1]);
917 nextchar += strlen (nextchar);
918 return optstring[0] == ':' ? ':' : '?';
921 nextchar += strlen (nextchar);
922 if (longind != NULL)
923 *longind = option_index;
924 if (pfound->flag)
926 *(pfound->flag) = pfound->val;
927 return 0;
929 return pfound->val;
931 nextchar = NULL;
932 return 'W'; /* Let the application handle it. */
934 if (temp[1] == ':')
936 if (temp[2] == ':')
938 /* This is an option that accepts an argument optionally. */
939 if (*nextchar != '\0')
941 optarg = nextchar;
942 optind++;
944 else
945 optarg = NULL;
946 nextchar = NULL;
948 else
950 /* This is an option that requires an argument. */
951 if (*nextchar != '\0')
953 optarg = nextchar;
954 /* If we end this ARGV-element by taking the rest as an arg,
955 we must advance to the next element now. */
956 optind++;
958 else if (optind == argc)
960 if (print_errors)
962 /* 1003.2 specifies the format of this message. */
963 fprintf (stderr,
964 _("%s: option requires an argument -- %c\n"),
965 argv[0], c);
967 optopt = c;
968 if (optstring[0] == ':')
969 c = ':';
970 else
971 c = '?';
973 else
974 /* We already incremented `optind' once;
975 increment it again when taking next ARGV-elt as argument. */
976 optarg = argv[optind++];
977 nextchar = NULL;
980 return c;
985 getopt (argc, argv, optstring)
986 int argc;
987 char *const *argv;
988 const char *optstring;
990 return _getopt_internal (argc, argv, optstring,
991 (const struct option *) 0,
992 (int *) 0,
996 #endif /* Not ELIDE_CODE. */
998 #ifdef TEST
1000 /* Compile with -DTEST to make an executable for use in testing
1001 the above definition of `getopt'. */
1004 main (argc, argv)
1005 int argc;
1006 char **argv;
1008 int c;
1009 int digit_optind = 0;
1011 while (1)
1013 int this_option_optind = optind ? optind : 1;
1015 c = getopt (argc, argv, "abc:d:0123456789");
1016 if (c == -1)
1017 break;
1019 switch (c)
1021 case '0':
1022 case '1':
1023 case '2':
1024 case '3':
1025 case '4':
1026 case '5':
1027 case '6':
1028 case '7':
1029 case '8':
1030 case '9':
1031 if (digit_optind != 0 && digit_optind != this_option_optind)
1032 printf ("digits occur in two different argv-elements.\n");
1033 digit_optind = this_option_optind;
1034 printf ("option %c\n", c);
1035 break;
1037 case 'a':
1038 printf ("option a\n");
1039 break;
1041 case 'b':
1042 printf ("option b\n");
1043 break;
1045 case 'c':
1046 printf ("option c with value `%s'\n", optarg);
1047 break;
1049 case '?':
1050 break;
1052 default:
1053 printf ("?? getopt returned character code 0%o ??\n", c);
1057 if (optind < argc)
1059 printf ("non-option ARGV-elements: ");
1060 while (optind < argc)
1061 printf ("%s ", argv[optind++]);
1062 printf ("\n");
1065 exit (0);
1068 #endif /* TEST */