(insert-directory): Insert free space only when listing a full directory.
[emacs.git] / lib-src / getopt.c
blob72fc012f8d9af0d633bf981d7243d3dbe2e53d06
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,2002
6 Free Software Foundation, Inc.
7 This file is part of the GNU C Library.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2, or (at your option)
12 any later version.
14 This program 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
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License along
20 with this program; if not, write to the Free Software Foundation,
21 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
23 /* This tells Alpha OSF/1 not to define a getopt prototype in <stdio.h>.
24 Ditto for AIX 3.2 and <stdlib.h>. */
25 #ifndef _NO_PROTO
26 # define _NO_PROTO
27 #endif
29 #ifdef HAVE_CONFIG_H
30 # include <config.h>
31 #endif
33 #if !defined __STDC__ || !__STDC__
34 /* This is a separate conditional since some stdc systems
35 reject `defined (const)'. */
36 # ifndef const
37 # define const
38 # endif
39 #endif
41 #include <stdio.h>
43 /* Comment out all this code if we are using the GNU C Library, and are not
44 actually compiling the library itself. This code is part of the GNU C
45 Library, but also included in many other GNU distributions. Compiling
46 and linking in this code is a waste when using the GNU C library
47 (especially if it is a shared library). Rather than having every GNU
48 program understand `configure --with-gnu-libc' and omit the object files,
49 it is simpler to just do this in the source for each such file. */
51 #define GETOPT_INTERFACE_VERSION 2
52 #if !defined _LIBC && defined __GLIBC__ && __GLIBC__ >= 2
53 # include <gnu-versions.h>
54 # if _GNU_GETOPT_INTERFACE_VERSION == GETOPT_INTERFACE_VERSION
55 # define ELIDE_CODE
56 # endif
57 #endif
59 #ifndef ELIDE_CODE
62 /* This needs to come after some library #include
63 to get __GNU_LIBRARY__ defined. */
64 #ifdef __GNU_LIBRARY__
65 /* Don't include stdlib.h for non-GNU C libraries because some of them
66 contain conflicting prototypes for getopt. */
67 # include <stdlib.h>
68 # include <unistd.h>
69 #endif /* GNU C library. */
71 #ifdef VMS
72 # include <unixlib.h>
73 # if HAVE_STRING_H - 0
74 # include <string.h>
75 # endif
76 #endif
78 #if 0
79 # ifdef _LIBC
80 # include <libintl.h>
81 # else /* not #ifdef _LIBC */
82 /* This is for other GNU distributions with internationalized messages. */
83 # include "gettext.h"
84 # endif /* end #ifdef _LIBC */
85 #endif /* end #if 0 */
87 #if HAVE_LIBINTL_H || defined _LIBC
88 /* Should I include libintl.h here as in regex.c ? */
89 # define _(msgid) gettext (msgid)
90 #else /* not #if HAVE_LIBINTL_H || defined _LIBC */
91 # define _(msgid) (msgid)
92 #endif /* end #if HAVE_LIBINTL_H || defined _LIBC */
94 #if defined _LIBC && defined USE_IN_LIBIO
95 # include <wchar.h>
96 #endif
98 #ifndef attribute_hidden
99 # define attribute_hidden
100 #endif
102 /* This version of `getopt' appears to the caller like standard Unix `getopt'
103 but it behaves differently for the user, since it allows the user
104 to intersperse the options with the other arguments.
106 As `getopt' works, it permutes the elements of ARGV so that,
107 when it is done, all the options precede everything else. Thus
108 all application programs are extended to handle flexible argument order.
110 Setting the environment variable POSIXLY_CORRECT disables permutation.
111 Then the behavior is completely standard.
113 GNU application programs can use a third alternative mode in which
114 they can distinguish the relative order of options and other arguments. */
116 #include "getopt.h"
118 /* For communication from `getopt' to the caller.
119 When `getopt' finds an option that takes an argument,
120 the argument value is returned here.
121 Also, when `ordering' is RETURN_IN_ORDER,
122 each non-option ARGV-element is returned here. */
124 char *optarg;
126 /* Index in ARGV of the next element to be scanned.
127 This is used for communication to and from the caller
128 and for communication between successive calls to `getopt'.
130 On entry to `getopt', zero means this is the first call; initialize.
132 When `getopt' returns -1, this is the index of the first of the
133 non-option elements that the caller should itself scan.
135 Otherwise, `optind' communicates from one call to the next
136 how much of ARGV has been scanned so far. */
138 /* 1003.2 says this must be 1 before any call. */
139 int optind = 1;
141 /* Formerly, initialization of getopt depended on optind==0, which
142 causes problems with re-calling getopt as programs generally don't
143 know that. */
145 int __getopt_initialized attribute_hidden;
147 /* The next char to be scanned in the option-element
148 in which the last option character we returned was found.
149 This allows us to pick up the scan where we left off.
151 If this is zero, or a null string, it means resume the scan
152 by advancing to the next ARGV-element. */
154 static char *nextchar;
156 /* Callers store zero here to inhibit the error message
157 for unrecognized options. */
159 int opterr = 1;
161 /* Set to an option character which was unrecognized.
162 This must be initialized on some systems to avoid linking in the
163 system's own getopt implementation. */
165 int optopt = '?';
167 /* Describe how to deal with options that follow non-option ARGV-elements.
169 If the caller did not specify anything,
170 the default is REQUIRE_ORDER if the environment variable
171 POSIXLY_CORRECT is defined, PERMUTE otherwise.
173 REQUIRE_ORDER means don't recognize them as options;
174 stop option processing when the first non-option is seen.
175 This is what Unix does.
176 This mode of operation is selected by either setting the environment
177 variable POSIXLY_CORRECT, or using `+' as the first character
178 of the list of option characters.
180 PERMUTE is the default. We permute the contents of ARGV as we scan,
181 so that eventually all the non-options are at the end. This allows options
182 to be given in any order, even with programs that were not written to
183 expect this.
185 RETURN_IN_ORDER is an option available to programs that were written
186 to expect options and other ARGV-elements in any order and that care about
187 the ordering of the two. We describe each non-option ARGV-element
188 as if it were the argument of an option with character code 1.
189 Using `-' as the first character of the list of option characters
190 selects this mode of operation.
192 The special argument `--' forces an end of option-scanning regardless
193 of the value of `ordering'. In the case of RETURN_IN_ORDER, only
194 `--' can cause `getopt' to return -1 with `optind' != ARGC. */
196 static enum
198 REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER
199 } ordering;
201 /* Value of POSIXLY_CORRECT environment variable. */
202 static char *posixly_correct;
204 #ifdef __GNU_LIBRARY__
205 /* We want to avoid inclusion of string.h with non-GNU libraries
206 because there are many ways it can cause trouble.
207 On some systems, it contains special magic macros that don't work
208 in GCC. */
209 # include <string.h>
210 # define my_index strchr
211 #else
213 # if HAVE_STRING_H
214 # include <string.h>
215 # else
216 # include <strings.h>
217 # endif
219 /* Avoid depending on library functions or files
220 whose names are inconsistent. */
222 #ifndef getenv
223 extern char *getenv ();
224 #endif
226 static char *
227 my_index (str, chr)
228 const char *str;
229 int chr;
231 while (*str)
233 if (*str == chr)
234 return (char *) str;
235 str++;
237 return 0;
240 /* If using GCC, we can safely declare strlen this way.
241 If not using GCC, it is ok not to declare it. */
242 #ifdef __GNUC__
243 /* Note that Motorola Delta 68k R3V7 comes with GCC but not stddef.h.
244 That was relevant to code that was here before. */
245 # if (!defined __STDC__ || !__STDC__) && !defined strlen
246 /* gcc with -traditional declares the built-in strlen to return int,
247 and has done so at least since version 2.4.5. -- rms. */
248 extern int strlen (const char *);
249 # endif /* not __STDC__ */
250 #endif /* __GNUC__ */
252 #endif /* not __GNU_LIBRARY__ */
254 /* Handle permutation of arguments. */
256 /* Describe the part of ARGV that contains non-options that have
257 been skipped. `first_nonopt' is the index in ARGV of the first of them;
258 `last_nonopt' is the index after the last of them. */
260 static int first_nonopt;
261 static int last_nonopt;
263 #ifdef _LIBC
264 /* Stored original parameters.
265 XXX This is no good solution. We should rather copy the args so
266 that we can compare them later. But we must not use malloc(3). */
267 extern int __libc_argc;
268 extern char **__libc_argv;
270 /* Bash 2.0 gives us an environment variable containing flags
271 indicating ARGV elements that should not be considered arguments. */
273 # ifdef USE_NONOPTION_FLAGS
274 /* Defined in getopt_init.c */
275 extern char *__getopt_nonoption_flags;
277 static int nonoption_flags_max_len;
278 static int nonoption_flags_len;
279 # endif
281 # ifdef USE_NONOPTION_FLAGS
282 # define SWAP_FLAGS(ch1, ch2) \
283 if (nonoption_flags_len > 0) \
285 char __tmp = __getopt_nonoption_flags[ch1]; \
286 __getopt_nonoption_flags[ch1] = __getopt_nonoption_flags[ch2]; \
287 __getopt_nonoption_flags[ch2] = __tmp; \
289 # else
290 # define SWAP_FLAGS(ch1, ch2)
291 # endif
292 #else /* !_LIBC */
293 # define SWAP_FLAGS(ch1, ch2)
294 #endif /* _LIBC */
296 /* Exchange two adjacent subsequences of ARGV.
297 One subsequence is elements [first_nonopt,last_nonopt)
298 which contains all the non-options that have been skipped so far.
299 The other is elements [last_nonopt,optind), which contains all
300 the options processed since those non-options were skipped.
302 `first_nonopt' and `last_nonopt' are relocated so that they describe
303 the new indices of the non-options in ARGV after they are moved. */
305 #if defined __STDC__ && __STDC__
306 static void exchange (char **);
307 #endif
309 static void
310 exchange (argv)
311 char **argv;
313 int bottom = first_nonopt;
314 int middle = last_nonopt;
315 int top = optind;
316 char *tem;
318 /* Exchange the shorter segment with the far end of the longer segment.
319 That puts the shorter segment into the right place.
320 It leaves the longer segment in the right place overall,
321 but it consists of two parts that need to be swapped next. */
323 #if defined _LIBC && defined USE_NONOPTION_FLAGS
324 /* First make sure the handling of the `__getopt_nonoption_flags'
325 string can work normally. Our top argument must be in the range
326 of the string. */
327 if (nonoption_flags_len > 0 && top >= nonoption_flags_max_len)
329 /* We must extend the array. The user plays games with us and
330 presents new arguments. */
331 char *new_str = malloc (top + 1);
332 if (new_str == NULL)
333 nonoption_flags_len = nonoption_flags_max_len = 0;
334 else
336 memset (__mempcpy (new_str, __getopt_nonoption_flags,
337 nonoption_flags_max_len),
338 '\0', top + 1 - nonoption_flags_max_len);
339 nonoption_flags_max_len = top + 1;
340 __getopt_nonoption_flags = new_str;
343 #endif
345 while (top > middle && middle > bottom)
347 if (top - middle > middle - bottom)
349 /* Bottom segment is the short one. */
350 int len = middle - bottom;
351 register int i;
353 /* Swap it with the top part of the top segment. */
354 for (i = 0; i < len; i++)
356 tem = argv[bottom + i];
357 argv[bottom + i] = argv[top - (middle - bottom) + i];
358 argv[top - (middle - bottom) + i] = tem;
359 SWAP_FLAGS (bottom + i, top - (middle - bottom) + i);
361 /* Exclude the moved bottom segment from further swapping. */
362 top -= len;
364 else
366 /* Top segment is the short one. */
367 int len = top - middle;
368 register int i;
370 /* Swap it with the bottom part of the bottom segment. */
371 for (i = 0; i < len; i++)
373 tem = argv[bottom + i];
374 argv[bottom + i] = argv[middle + i];
375 argv[middle + i] = tem;
376 SWAP_FLAGS (bottom + i, middle + i);
378 /* Exclude the moved top segment from further swapping. */
379 bottom += len;
383 /* Update records for the slots the non-options now occupy. */
385 first_nonopt += (optind - last_nonopt);
386 last_nonopt = optind;
389 /* Initialize the internal data when the first call is made. */
391 #if defined __STDC__ && __STDC__
392 static const char *_getopt_initialize (int, char *const *, const char *);
393 #endif
394 static const char *
395 _getopt_initialize (argc, argv, optstring)
396 int argc;
397 char *const *argv;
398 const char *optstring;
400 /* Start processing options with ARGV-element 1 (since ARGV-element 0
401 is the program name); the sequence of previously skipped
402 non-option ARGV-elements is empty. */
404 first_nonopt = last_nonopt = optind;
406 nextchar = NULL;
408 posixly_correct = getenv ("POSIXLY_CORRECT");
410 /* Determine how to handle the ordering of options and nonoptions. */
412 if (optstring[0] == '-')
414 ordering = RETURN_IN_ORDER;
415 ++optstring;
417 else if (optstring[0] == '+')
419 ordering = REQUIRE_ORDER;
420 ++optstring;
422 else if (posixly_correct != NULL)
423 ordering = REQUIRE_ORDER;
424 else
425 ordering = PERMUTE;
427 #if defined _LIBC && defined USE_NONOPTION_FLAGS
428 if (posixly_correct == NULL
429 && argc == __libc_argc && argv == __libc_argv)
431 if (nonoption_flags_max_len == 0)
433 if (__getopt_nonoption_flags == NULL
434 || __getopt_nonoption_flags[0] == '\0')
435 nonoption_flags_max_len = -1;
436 else
438 const char *orig_str = __getopt_nonoption_flags;
439 int len = nonoption_flags_max_len = strlen (orig_str);
440 if (nonoption_flags_max_len < argc)
441 nonoption_flags_max_len = argc;
442 __getopt_nonoption_flags =
443 (char *) malloc (nonoption_flags_max_len);
444 if (__getopt_nonoption_flags == NULL)
445 nonoption_flags_max_len = -1;
446 else
447 memset (__mempcpy (__getopt_nonoption_flags, orig_str, len),
448 '\0', nonoption_flags_max_len - len);
451 nonoption_flags_len = nonoption_flags_max_len;
453 else
454 nonoption_flags_len = 0;
455 #endif
457 return optstring;
460 /* Scan elements of ARGV (whose length is ARGC) for option characters
461 given in OPTSTRING.
463 If an element of ARGV starts with '-', and is not exactly "-" or "--",
464 then it is an option element. The characters of this element
465 (aside from the initial '-') are option characters. If `getopt'
466 is called repeatedly, it returns successively each of the option characters
467 from each of the option elements.
469 If `getopt' finds another option character, it returns that character,
470 updating `optind' and `nextchar' so that the next call to `getopt' can
471 resume the scan with the following option character or ARGV-element.
473 If there are no more option characters, `getopt' returns -1.
474 Then `optind' is the index in ARGV of the first ARGV-element
475 that is not an option. (The ARGV-elements have been permuted
476 so that those that are not options now come last.)
478 OPTSTRING is a string containing the legitimate option characters.
479 If an option character is seen that is not listed in OPTSTRING,
480 return '?' after printing an error message. If you set `opterr' to
481 zero, the error message is suppressed but we still return '?'.
483 If a char in OPTSTRING is followed by a colon, that means it wants an arg,
484 so the following text in the same ARGV-element, or the text of the following
485 ARGV-element, is returned in `optarg'. Two colons mean an option that
486 wants an optional arg; if there is text in the current ARGV-element,
487 it is returned in `optarg', otherwise `optarg' is set to zero.
489 If OPTSTRING starts with `-' or `+', it requests different methods of
490 handling the non-option ARGV-elements.
491 See the comments about RETURN_IN_ORDER and REQUIRE_ORDER, above.
493 Long-named options begin with `--' instead of `-'.
494 Their names may be abbreviated as long as the abbreviation is unique
495 or is an exact match for some defined option. If they have an
496 argument, it follows the option name in the same ARGV-element, separated
497 from the option name by a `=', or else the in next ARGV-element.
498 When `getopt' finds a long-named option, it returns 0 if that option's
499 `flag' field is nonzero, the value of the option's `val' field
500 if the `flag' field is zero.
502 The elements of ARGV aren't really const, because we permute them.
503 But we pretend they're const in the prototype to be compatible
504 with other systems.
506 LONGOPTS is a vector of `struct option' terminated by an
507 element containing a name which is zero.
509 LONGIND returns the index in LONGOPT of the long-named option found.
510 It is only valid when a long-named option has been found by the most
511 recent call.
513 If LONG_ONLY is nonzero, '-' as well as '--' can introduce
514 long-named options. */
517 _getopt_internal (argc, argv, optstring, longopts, longind, long_only)
518 int argc;
519 char *const *argv;
520 const char *optstring;
521 const struct option *longopts;
522 int *longind;
523 int long_only;
525 int print_errors = opterr;
526 if (optstring[0] == ':')
527 print_errors = 0;
529 if (argc < 1)
530 return -1;
532 optarg = NULL;
534 if (optind == 0 || !__getopt_initialized)
536 if (optind == 0)
537 optind = 1; /* Don't scan ARGV[0], the program name. */
538 optstring = _getopt_initialize (argc, argv, optstring);
539 __getopt_initialized = 1;
542 /* Test whether ARGV[optind] points to a non-option argument.
543 Either it does not have option syntax, or there is an environment flag
544 from the shell indicating it is not an option. The later information
545 is only used when the used in the GNU libc. */
546 #if defined _LIBC && defined USE_NONOPTION_FLAGS
547 # define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0' \
548 || (optind < nonoption_flags_len \
549 && __getopt_nonoption_flags[optind] == '1'))
550 #else
551 # define NONOPTION_P (argv[optind][0] != '-' || argv[optind][1] == '\0')
552 #endif
554 if (nextchar == NULL || *nextchar == '\0')
556 /* Advance to the next ARGV-element. */
558 /* Give FIRST_NONOPT & LAST_NONOPT rational values if OPTIND has been
559 moved back by the user (who may also have changed the arguments). */
560 if (last_nonopt > optind)
561 last_nonopt = optind;
562 if (first_nonopt > optind)
563 first_nonopt = optind;
565 if (ordering == PERMUTE)
567 /* If we have just processed some options following some non-options,
568 exchange them so that the options come first. */
570 if (first_nonopt != last_nonopt && last_nonopt != optind)
571 exchange ((char **) argv);
572 else if (last_nonopt != optind)
573 first_nonopt = optind;
575 /* Skip any additional non-options
576 and extend the range of non-options previously skipped. */
578 while (optind < argc && NONOPTION_P)
579 optind++;
580 last_nonopt = optind;
583 /* The special ARGV-element `--' means premature end of options.
584 Skip it like a null option,
585 then exchange with previous non-options as if it were an option,
586 then skip everything else like a non-option. */
588 if (optind != argc && !strcmp (argv[optind], "--"))
590 optind++;
592 if (first_nonopt != last_nonopt && last_nonopt != optind)
593 exchange ((char **) argv);
594 else if (first_nonopt == last_nonopt)
595 first_nonopt = optind;
596 last_nonopt = argc;
598 optind = argc;
601 /* If we have done all the ARGV-elements, stop the scan
602 and back over any non-options that we skipped and permuted. */
604 if (optind == argc)
606 /* Set the next-arg-index to point at the non-options
607 that we previously skipped, so the caller will digest them. */
608 if (first_nonopt != last_nonopt)
609 optind = first_nonopt;
610 return -1;
613 /* If we have come to a non-option and did not permute it,
614 either stop the scan or describe it to the caller and pass it by. */
616 if (NONOPTION_P)
618 if (ordering == REQUIRE_ORDER)
619 return -1;
620 optarg = argv[optind++];
621 return 1;
624 /* We have found another option-ARGV-element.
625 Skip the initial punctuation. */
627 nextchar = (argv[optind] + 1
628 + (longopts != NULL && argv[optind][1] == '-'));
631 /* Decode the current option-ARGV-element. */
633 /* Check whether the ARGV-element is a long option.
635 If long_only and the ARGV-element has the form "-f", where f is
636 a valid short option, don't consider it an abbreviated form of
637 a long option that starts with f. Otherwise there would be no
638 way to give the -f short option.
640 On the other hand, if there's a long option "fubar" and
641 the ARGV-element is "-fu", do consider that an abbreviation of
642 the long option, just like "--fu", and not "-f" with arg "u".
644 This distinction seems to be the most useful approach. */
646 if (longopts != NULL
647 && (argv[optind][1] == '-'
648 || (long_only && (argv[optind][2] || !my_index (optstring, argv[optind][1])))))
650 char *nameend;
651 const struct option *p;
652 const struct option *pfound = NULL;
653 int exact = 0;
654 int ambig = 0;
655 int indfound = -1;
656 int option_index;
658 for (nameend = nextchar; *nameend && *nameend != '='; nameend++)
659 /* Do nothing. */ ;
661 /* Test all long options for either exact match
662 or abbreviated matches. */
663 for (p = longopts, option_index = 0; p->name; p++, option_index++)
664 if (!strncmp (p->name, nextchar, nameend - nextchar))
666 if ((unsigned int) (nameend - nextchar)
667 == (unsigned int) strlen (p->name))
669 /* Exact match found. */
670 pfound = p;
671 indfound = option_index;
672 exact = 1;
673 break;
675 else if (pfound == NULL)
677 /* First nonexact match found. */
678 pfound = p;
679 indfound = option_index;
681 else if (long_only
682 || pfound->has_arg != p->has_arg
683 || pfound->flag != p->flag
684 || pfound->val != p->val)
685 /* Second or later nonexact match found. */
686 ambig = 1;
689 if (ambig && !exact)
691 if (print_errors)
693 #if defined _LIBC && defined USE_IN_LIBIO
694 char *buf;
696 if (__asprintf (&buf, _("%s: option `%s' is ambiguous\n"),
697 argv[0], argv[optind]) >= 0)
700 if (_IO_fwide (stderr, 0) > 0)
701 __fwprintf (stderr, L"%s", buf);
702 else
703 fputs (buf, stderr);
705 free (buf);
707 #else
708 fprintf (stderr, _("%s: option `%s' is ambiguous\n"),
709 argv[0], argv[optind]);
710 #endif
712 nextchar += strlen (nextchar);
713 optind++;
714 optopt = 0;
715 return '?';
718 if (pfound != NULL)
720 option_index = indfound;
721 optind++;
722 if (*nameend)
724 /* Don't test has_arg with >, because some C compilers don't
725 allow it to be used on enums. */
726 if (pfound->has_arg)
727 optarg = nameend + 1;
728 else
730 if (print_errors)
732 #if defined _LIBC && defined USE_IN_LIBIO
733 char *buf;
734 int n;
735 #endif
737 if (argv[optind - 1][1] == '-')
739 /* --option */
740 #if defined _LIBC && defined USE_IN_LIBIO
741 n = __asprintf (&buf, _("\
742 %s: option `--%s' doesn't allow an argument\n"),
743 argv[0], pfound->name);
744 #else
745 fprintf (stderr, _("\
746 %s: option `--%s' doesn't allow an argument\n"),
747 argv[0], pfound->name);
748 #endif
750 else
752 /* +option or -option */
753 #if defined _LIBC && defined USE_IN_LIBIO
754 n = __asprintf (&buf, _("\
755 %s: option `%c%s' doesn't allow an argument\n"),
756 argv[0], argv[optind - 1][0],
757 pfound->name);
758 #else
759 fprintf (stderr, _("\
760 %s: option `%c%s' doesn't allow an argument\n"),
761 argv[0], argv[optind - 1][0], pfound->name);
762 #endif
765 #if defined _LIBC && defined USE_IN_LIBIO
766 if (n >= 0)
768 if (_IO_fwide (stderr, 0) > 0)
769 __fwprintf (stderr, L"%s", buf);
770 else
771 fputs (buf, stderr);
773 free (buf);
775 #endif
778 nextchar += strlen (nextchar);
780 optopt = pfound->val;
781 return '?';
784 else if (pfound->has_arg == 1)
786 if (optind < argc)
787 optarg = argv[optind++];
788 else
790 if (print_errors)
792 #if defined _LIBC && defined USE_IN_LIBIO
793 char *buf;
795 if (__asprintf (&buf, _("\
796 %s: option `%s' requires an argument\n"),
797 argv[0], argv[optind - 1]) >= 0)
799 if (_IO_fwide (stderr, 0) > 0)
800 __fwprintf (stderr, L"%s", buf);
801 else
802 fputs (buf, stderr);
804 free (buf);
806 #else
807 fprintf (stderr,
808 _("%s: option `%s' requires an argument\n"),
809 argv[0], argv[optind - 1]);
810 #endif
812 nextchar += strlen (nextchar);
813 optopt = pfound->val;
814 return optstring[0] == ':' ? ':' : '?';
817 nextchar += strlen (nextchar);
818 if (longind != NULL)
819 *longind = option_index;
820 if (pfound->flag)
822 *(pfound->flag) = pfound->val;
823 return 0;
825 return pfound->val;
828 /* Can't find it as a long option. If this is not getopt_long_only,
829 or the option starts with '--' or is not a valid short
830 option, then it's an error.
831 Otherwise interpret it as a short option. */
832 if (!long_only || argv[optind][1] == '-'
833 || my_index (optstring, *nextchar) == NULL)
835 if (print_errors)
837 #if defined _LIBC && defined USE_IN_LIBIO
838 char *buf;
839 int n;
840 #endif
842 if (argv[optind][1] == '-')
844 /* --option */
845 #if defined _LIBC && defined USE_IN_LIBIO
846 n = __asprintf (&buf, _("%s: unrecognized option `--%s'\n"),
847 argv[0], nextchar);
848 #else
849 fprintf (stderr, _("%s: unrecognized option `--%s'\n"),
850 argv[0], nextchar);
851 #endif
853 else
855 /* +option or -option */
856 #if defined _LIBC && defined USE_IN_LIBIO
857 n = __asprintf (&buf, _("%s: unrecognized option `%c%s'\n"),
858 argv[0], argv[optind][0], nextchar);
859 #else
860 fprintf (stderr, _("%s: unrecognized option `%c%s'\n"),
861 argv[0], argv[optind][0], nextchar);
862 #endif
865 #if defined _LIBC && defined USE_IN_LIBIO
866 if (n >= 0)
868 if (_IO_fwide (stderr, 0) > 0)
869 __fwprintf (stderr, L"%s", buf);
870 else
871 fputs (buf, stderr);
873 free (buf);
875 #endif
877 nextchar = (char *) "";
878 optind++;
879 optopt = 0;
880 return '?';
884 /* Look at and handle the next short option-character. */
887 char c = *nextchar++;
888 char *temp = my_index (optstring, c);
890 /* Increment `optind' when we start to process its last character. */
891 if (*nextchar == '\0')
892 ++optind;
894 if (temp == NULL || c == ':')
896 if (print_errors)
898 #if defined _LIBC && defined USE_IN_LIBIO
899 char *buf;
900 int n;
901 #endif
903 if (posixly_correct)
905 /* 1003.2 specifies the format of this message. */
906 #if defined _LIBC && defined USE_IN_LIBIO
907 n = __asprintf (&buf, _("%s: illegal option -- %c\n"),
908 argv[0], c);
909 #else
910 fprintf (stderr, _("%s: illegal option -- %c\n"), argv[0], c);
911 #endif
913 else
915 #if defined _LIBC && defined USE_IN_LIBIO
916 n = __asprintf (&buf, _("%s: invalid option -- %c\n"),
917 argv[0], c);
918 #else
919 fprintf (stderr, _("%s: invalid option -- %c\n"), argv[0], c);
920 #endif
923 #if defined _LIBC && defined USE_IN_LIBIO
924 if (n >= 0)
926 if (_IO_fwide (stderr, 0) > 0)
927 __fwprintf (stderr, L"%s", buf);
928 else
929 fputs (buf, stderr);
931 free (buf);
933 #endif
935 optopt = c;
936 return '?';
938 /* Convenience. Treat POSIX -W foo same as long option --foo */
939 if (temp[0] == 'W' && temp[1] == ';')
941 char *nameend;
942 const struct option *p;
943 const struct option *pfound = NULL;
944 int exact = 0;
945 int ambig = 0;
946 int indfound = 0;
947 int option_index;
949 /* This is an option that requires an argument. */
950 if (*nextchar != '\0')
952 optarg = nextchar;
953 /* If we end this ARGV-element by taking the rest as an arg,
954 we must advance to the next element now. */
955 optind++;
957 else if (optind == argc)
959 if (print_errors)
961 /* 1003.2 specifies the format of this message. */
962 #if defined _LIBC && defined USE_IN_LIBIO
963 char *buf;
965 if (__asprintf (&buf,
966 _("%s: option requires an argument -- %c\n"),
967 argv[0], c) >= 0)
969 if (_IO_fwide (stderr, 0) > 0)
970 __fwprintf (stderr, L"%s", buf);
971 else
972 fputs (buf, stderr);
974 free (buf);
976 #else
977 fprintf (stderr, _("%s: option requires an argument -- %c\n"),
978 argv[0], c);
979 #endif
981 optopt = c;
982 if (optstring[0] == ':')
983 c = ':';
984 else
985 c = '?';
986 return c;
988 else
989 /* We already incremented `optind' once;
990 increment it again when taking next ARGV-elt as argument. */
991 optarg = argv[optind++];
993 /* optarg is now the argument, see if it's in the
994 table of longopts. */
996 for (nextchar = nameend = optarg; *nameend && *nameend != '='; nameend++)
997 /* Do nothing. */ ;
999 /* Test all long options for either exact match
1000 or abbreviated matches. */
1001 for (p = longopts, option_index = 0; p->name; p++, option_index++)
1002 if (!strncmp (p->name, nextchar, nameend - nextchar))
1004 if ((unsigned int) (nameend - nextchar) == strlen (p->name))
1006 /* Exact match found. */
1007 pfound = p;
1008 indfound = option_index;
1009 exact = 1;
1010 break;
1012 else if (pfound == NULL)
1014 /* First nonexact match found. */
1015 pfound = p;
1016 indfound = option_index;
1018 else
1019 /* Second or later nonexact match found. */
1020 ambig = 1;
1022 if (ambig && !exact)
1024 if (print_errors)
1026 #if defined _LIBC && defined USE_IN_LIBIO
1027 char *buf;
1029 if (__asprintf (&buf, _("%s: option `-W %s' is ambiguous\n"),
1030 argv[0], argv[optind]) >= 0)
1032 if (_IO_fwide (stderr, 0) > 0)
1033 __fwprintf (stderr, L"%s", buf);
1034 else
1035 fputs (buf, stderr);
1037 free (buf);
1039 #else
1040 fprintf (stderr, _("%s: option `-W %s' is ambiguous\n"),
1041 argv[0], argv[optind]);
1042 #endif
1044 nextchar += strlen (nextchar);
1045 optind++;
1046 return '?';
1048 if (pfound != NULL)
1050 option_index = indfound;
1051 if (*nameend)
1053 /* Don't test has_arg with >, because some C compilers don't
1054 allow it to be used on enums. */
1055 if (pfound->has_arg)
1056 optarg = nameend + 1;
1057 else
1059 if (print_errors)
1061 #if defined _LIBC && defined USE_IN_LIBIO
1062 char *buf;
1064 if (__asprintf (&buf, _("\
1065 %s: option `-W %s' doesn't allow an argument\n"),
1066 argv[0], pfound->name) >= 0)
1068 if (_IO_fwide (stderr, 0) > 0)
1069 __fwprintf (stderr, L"%s", buf);
1070 else
1071 fputs (buf, stderr);
1073 free (buf);
1075 #else
1076 fprintf (stderr, _("\
1077 %s: option `-W %s' doesn't allow an argument\n"),
1078 argv[0], pfound->name);
1079 #endif
1082 nextchar += strlen (nextchar);
1083 return '?';
1086 else if (pfound->has_arg == 1)
1088 if (optind < argc)
1089 optarg = argv[optind++];
1090 else
1092 if (print_errors)
1094 #if defined _LIBC && defined USE_IN_LIBIO
1095 char *buf;
1097 if (__asprintf (&buf, _("\
1098 %s: option `%s' requires an argument\n"),
1099 argv[0], argv[optind - 1]) >= 0)
1101 if (_IO_fwide (stderr, 0) > 0)
1102 __fwprintf (stderr, L"%s", buf);
1103 else
1104 fputs (buf, stderr);
1106 free (buf);
1108 #else
1109 fprintf (stderr,
1110 _("%s: option `%s' requires an argument\n"),
1111 argv[0], argv[optind - 1]);
1112 #endif
1114 nextchar += strlen (nextchar);
1115 return optstring[0] == ':' ? ':' : '?';
1118 nextchar += strlen (nextchar);
1119 if (longind != NULL)
1120 *longind = option_index;
1121 if (pfound->flag)
1123 *(pfound->flag) = pfound->val;
1124 return 0;
1126 return pfound->val;
1128 nextchar = NULL;
1129 return 'W'; /* Let the application handle it. */
1131 if (temp[1] == ':')
1133 if (temp[2] == ':')
1135 /* This is an option that accepts an argument optionally. */
1136 if (*nextchar != '\0')
1138 optarg = nextchar;
1139 optind++;
1141 else
1142 optarg = NULL;
1143 nextchar = NULL;
1145 else
1147 /* This is an option that requires an argument. */
1148 if (*nextchar != '\0')
1150 optarg = nextchar;
1151 /* If we end this ARGV-element by taking the rest as an arg,
1152 we must advance to the next element now. */
1153 optind++;
1155 else if (optind == argc)
1157 if (print_errors)
1159 /* 1003.2 specifies the format of this message. */
1160 #if defined _LIBC && defined USE_IN_LIBIO
1161 char *buf;
1163 if (__asprintf (&buf, _("\
1164 %s: option requires an argument -- %c\n"),
1165 argv[0], c) >= 0)
1167 if (_IO_fwide (stderr, 0) > 0)
1168 __fwprintf (stderr, L"%s", buf);
1169 else
1170 fputs (buf, stderr);
1172 free (buf);
1174 #else
1175 fprintf (stderr,
1176 _("%s: option requires an argument -- %c\n"),
1177 argv[0], c);
1178 #endif
1180 optopt = c;
1181 if (optstring[0] == ':')
1182 c = ':';
1183 else
1184 c = '?';
1186 else
1187 /* We already incremented `optind' once;
1188 increment it again when taking next ARGV-elt as argument. */
1189 optarg = argv[optind++];
1190 nextchar = NULL;
1193 return c;
1198 getopt (argc, argv, optstring)
1199 int argc;
1200 char *const *argv;
1201 const char *optstring;
1203 return _getopt_internal (argc, argv, optstring,
1204 (const struct option *) 0,
1205 (int *) 0,
1209 #endif /* Not ELIDE_CODE. */
1211 #ifdef TEST
1213 /* Compile with -DTEST to make an executable for use in testing
1214 the above definition of `getopt'. */
1217 main (argc, argv)
1218 int argc;
1219 char **argv;
1221 int c;
1222 int digit_optind = 0;
1224 while (1)
1226 int this_option_optind = optind ? optind : 1;
1228 c = getopt (argc, argv, "abc:d:0123456789");
1229 if (c == -1)
1230 break;
1232 switch (c)
1234 case '0':
1235 case '1':
1236 case '2':
1237 case '3':
1238 case '4':
1239 case '5':
1240 case '6':
1241 case '7':
1242 case '8':
1243 case '9':
1244 if (digit_optind != 0 && digit_optind != this_option_optind)
1245 printf ("digits occur in two different argv-elements.\n");
1246 digit_optind = this_option_optind;
1247 printf ("option %c\n", c);
1248 break;
1250 case 'a':
1251 printf ("option a\n");
1252 break;
1254 case 'b':
1255 printf ("option b\n");
1256 break;
1258 case 'c':
1259 printf ("option c with value `%s'\n", optarg);
1260 break;
1262 case '?':
1263 break;
1265 default:
1266 printf ("?? getopt returned character code 0%o ??\n", c);
1270 if (optind < argc)
1272 printf ("non-option ARGV-elements: ");
1273 while (optind < argc)
1274 printf ("%s ", argv[optind++]);
1275 printf ("\n");
1278 exit (0);
1281 #endif /* TEST */