Mercurial > hg > octave-kai > gnulib-hg

annotate lib/getopt_int.h @ 10780:5c7a68d31801

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add support for Haiku.
author Bruno Haible <bruno@clisp.org>
date Mon, 10 Nov 2008 12:37:32 +0100
parents bbbbbf4cd1c5
children ef31ab094483
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
1 /* Internal declarations for getopt.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
2 Copyright (C) 1989-1994,1996-1999,2001,2003,2004
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
3 Free Software Foundation, Inc.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
4 This file is part of the GNU C Library.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
5
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
6 This program is free software: you can redistribute it and/or modify
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
7 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
8 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
9 (at your option) any later version.
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
10
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
11 This program is distributed in the hope that it will be useful,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
14 GNU General Public License for more details.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
15
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
16 You should have received a copy of the GNU General Public License
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
18
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
19 #ifndef _GETOPT_INT_H
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
20 #define _GETOPT_INT_H 1
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
21
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
22 extern int _getopt_internal (int ___argc, char **___argv,
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
23 const char *__shortopts,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
24 const struct option *__longopts, int *__longind,
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
25 int __long_only, int __posixly_correct);
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
26
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
27
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
28 /* Reentrant versions which can handle parsing multiple argument
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
29 vectors at the same time. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
30
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
31 /* Data type for reentrant functions. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
32 struct _getopt_data
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
33 {
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
34 /* These have exactly the same meaning as the corresponding global
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
35 variables, except that they are used for the reentrant
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
36 versions of getopt. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
37 int optind;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
38 int opterr;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
39 int optopt;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
40 char *optarg;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
41
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
42 /* Internal members. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
43
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
44 /* True if the internal members have been initialized. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
45 int __initialized;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
46
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
47 /* The next char to be scanned in the option-element
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
48 in which the last option character we returned was found.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
49 This allows us to pick up the scan where we left off.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
50
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
51 If this is zero, or a null string, it means resume the scan
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
52 by advancing to the next ARGV-element. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
53 char *__nextchar;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
54
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
55 /* Describe how to deal with options that follow non-option ARGV-elements.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
56
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
57 If the caller did not specify anything,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
58 the default is REQUIRE_ORDER if the environment variable
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
59 POSIXLY_CORRECT is defined, PERMUTE otherwise.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
60
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
61 REQUIRE_ORDER means don't recognize them as options;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
62 stop option processing when the first non-option is seen.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
63 This is what Unix does.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
64 This mode of operation is selected by either setting the environment
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
65 variable POSIXLY_CORRECT, or using `+' as the first character
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
66 of the list of option characters, or by calling getopt.
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
67
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
68 PERMUTE is the default. We permute the contents of ARGV as we
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
69 scan, so that eventually all the non-options are at the end.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
70 This allows options to be given in any order, even with programs
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
71 that were not written to expect this.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
72
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
73 RETURN_IN_ORDER is an option available to programs that were
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
74 written to expect options and other ARGV-elements in any order
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
75 and that care about the ordering of the two. We describe each
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
76 non-option ARGV-element as if it were the argument of an option
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
77 with character code 1. Using `-' as the first character of the
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
78 list of option characters selects this mode of operation.
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
79
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
80 The special argument `--' forces an end of option-scanning regardless
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
81 of the value of `ordering'. In the case of RETURN_IN_ORDER, only
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
82 `--' can cause `getopt' to return -1 with `optind' != ARGC. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
83
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
84 enum
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
85 {
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
86 REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
87 } __ordering;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
88
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
89 /* If the POSIXLY_CORRECT environment variable is set
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
90 or getopt was called. */
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
91 int __posixly_correct;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
92
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
93
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
94 /* Handle permutation of arguments. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
95
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
96 /* Describe the part of ARGV that contains non-options that have
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
97 been skipped. `first_nonopt' is the index in ARGV of the first
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
98 of them; `last_nonopt' is the index after the last of them. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
99
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
100 int __first_nonopt;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
101 int __last_nonopt;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
102
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
103 #if defined _LIBC && defined USE_NONOPTION_FLAGS
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
104 int __nonoption_flags_max_len;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
105 int __nonoption_flags_len;
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
106 # endif
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
107 };
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
108
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
109 /* The initializer is necessary to set OPTIND and OPTERR to their
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
110 default values and to clear the initialization flag. */
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
111 #define _GETOPT_DATA_INITIALIZER { 1, 1 }
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
112
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
113 extern int _getopt_internal_r (int ___argc, char **___argv,
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
114 const char *__shortopts,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
115 const struct option *__longopts, int *__longind,
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
116 int __long_only, int __posixly_correct,
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
117 struct _getopt_data *__data);
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
118
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
119 extern int _getopt_long_r (int ___argc, char **___argv,
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
120 const char *__shortopts,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
121 const struct option *__longopts, int *__longind,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
122 struct _getopt_data *__data);
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
123
5453
d29dafc60cf3 Merge from coreutils to support a more-standard getopt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5431
diff changeset
124 extern int _getopt_long_only_r (int ___argc, char **___argv,
4970
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
125 const char *__shortopts,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
126 const struct option *__longopts,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
127 int *__longind,
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
128 struct _getopt_data *__data);
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
129
595e9138157c Sync getopt and argp from libc CVS.
Paul Eggert <eggert@cs.ucla.edu>
parents:
diff changeset
130 #endif /* getopt_int.h */