mirror of
git://sourceware.org/git/glibc.git
synced 2024-11-27 03:41:23 +08:00
7a7be6c9a2
For standards compliance, getopt, getopt_long, and getopt_long_only in glibc have to take 'char *const *argv' even though they can mutate the array. gnulib has tried to clean this up as much as possible: all the internal functions use 'char **argv', and when used standalone, so do getopt_long and getopt_long_only. Also brought over are __nonnull annotations, corrections to documentation, and apparently it is no longer necessary to worry about conflicting prototypes for getopt. The macroification of the definitions of getopt and __posix_getopt goes beyond what is currently in gnulib. At this point getopt1.c and getopt_int.h are identical to their gnulib versions. * posix/getopt.h: Add backup definition of __nonnull for consistency with gnulib. Define __getopt_argv_const to const if not already defined. (getopt): Update doc comment from gnulib. Prototype unconditionally. Add __nonnull annotation. (__posix_getopt): Add __nonnull annotation. (getopt_long, getopt_long_only): Use __getopt_argv_const in prototypes for consistency with gnulib. Add __nonnull annotations. * posix/getopt.c (_getopt_initialize, _getopt_internal_r) (getopt_internal): Change 'argv' argument to type 'char **'. Remove now-unnecessary casts. (getopt, __posix_getopt): Eliminate repetition with a macro. Cast 'argv' to 'char **' when calling _getopt_internal. * posix/getopt1.c (getopt_long, getopt_long_only): Use __getopt_argv_const for consistency with gnulib. Cast 'argv' to 'char **' when calling _getopt_internal. (_getopt_long_r, _getopt_long_only_r): Change 'argv' argument to type 'char **'. (main): Constify 'long_options'. * posix/getopt_int.h (getopt_internal, _getopt_internal_r) (_getopt_long_r, _getopt_long_only_r): Change 'argv' argument to type 'char **'.
122 lines
4.1 KiB
C
122 lines
4.1 KiB
C
/* Internal declarations for getopt.
|
||
Copyright (C) 1989-2017 Free Software Foundation, Inc.
|
||
This file is part of the GNU C Library.
|
||
|
||
The GNU C Library is free software; you can redistribute it and/or
|
||
modify it under the terms of the GNU Lesser General Public
|
||
License as published by the Free Software Foundation; either
|
||
version 2.1 of the License, or (at your option) any later version.
|
||
|
||
The GNU C Library is distributed in the hope that it will be useful,
|
||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
||
Lesser General Public License for more details.
|
||
|
||
You should have received a copy of the GNU Lesser General Public
|
||
License along with the GNU C Library; if not, see
|
||
<http://www.gnu.org/licenses/>. */
|
||
|
||
#ifndef _GETOPT_INT_H
|
||
#define _GETOPT_INT_H 1
|
||
|
||
#include <getopt.h>
|
||
|
||
extern int _getopt_internal (int ___argc, char **___argv,
|
||
const char *__shortopts,
|
||
const struct option *__longopts, int *__longind,
|
||
int __long_only, int __posixly_correct);
|
||
|
||
|
||
/* Reentrant versions which can handle parsing multiple argument
|
||
vectors at the same time. */
|
||
|
||
/* Describe how to deal with options that follow non-option ARGV-elements.
|
||
|
||
REQUIRE_ORDER means don't recognize them as options; stop option
|
||
processing when the first non-option is seen. This is what POSIX
|
||
specifies should happen.
|
||
|
||
PERMUTE means permute the contents of ARGV as we scan, so that
|
||
eventually all the non-options are at the end. This allows options
|
||
to be given in any order, even with programs that were not written
|
||
to expect this.
|
||
|
||
RETURN_IN_ORDER is an option available to programs that were
|
||
written to expect options and other ARGV-elements in any order
|
||
and that care about the ordering of the two. We describe each
|
||
non-option ARGV-element as if it were the argument of an option
|
||
with character code 1.
|
||
|
||
The special argument '--' forces an end of option-scanning regardless
|
||
of the value of 'ordering'. In the case of RETURN_IN_ORDER, only
|
||
'--' can cause 'getopt' to return -1 with 'optind' != ARGC. */
|
||
|
||
enum __ord
|
||
{
|
||
REQUIRE_ORDER, PERMUTE, RETURN_IN_ORDER
|
||
};
|
||
|
||
/* Data type for reentrant functions. */
|
||
struct _getopt_data
|
||
{
|
||
/* These have exactly the same meaning as the corresponding global
|
||
variables, except that they are used for the reentrant
|
||
versions of getopt. */
|
||
int optind;
|
||
int opterr;
|
||
int optopt;
|
||
char *optarg;
|
||
|
||
/* Internal members. */
|
||
|
||
/* True if the internal members have been initialized. */
|
||
int __initialized;
|
||
|
||
/* The next char to be scanned in the option-element
|
||
in which the last option character we returned was found.
|
||
This allows us to pick up the scan where we left off.
|
||
|
||
If this is zero, or a null string, it means resume the scan
|
||
by advancing to the next ARGV-element. */
|
||
char *__nextchar;
|
||
|
||
/* See __ord above. */
|
||
enum __ord __ordering;
|
||
|
||
/* True if behaving strictly as specified by POSIX. */
|
||
int __posixly_correct;
|
||
|
||
|
||
/* Handle permutation of arguments. */
|
||
|
||
/* Describe the part of ARGV that contains non-options that have
|
||
been skipped. 'first_nonopt' is the index in ARGV of the first
|
||
of them; 'last_nonopt' is the index after the last of them. */
|
||
|
||
int __first_nonopt;
|
||
int __last_nonopt;
|
||
};
|
||
|
||
/* The initializer is necessary to set OPTIND and OPTERR to their
|
||
default values and to clear the initialization flag. */
|
||
#define _GETOPT_DATA_INITIALIZER { 1, 1 }
|
||
|
||
extern int _getopt_internal_r (int ___argc, char **___argv,
|
||
const char *__shortopts,
|
||
const struct option *__longopts, int *__longind,
|
||
int __long_only, struct _getopt_data *__data,
|
||
int __posixly_correct);
|
||
|
||
extern int _getopt_long_r (int ___argc, char **___argv,
|
||
const char *__shortopts,
|
||
const struct option *__longopts, int *__longind,
|
||
struct _getopt_data *__data);
|
||
|
||
extern int _getopt_long_only_r (int ___argc, char **___argv,
|
||
const char *__shortopts,
|
||
const struct option *__longopts,
|
||
int *__longind,
|
||
struct _getopt_data *__data);
|
||
|
||
#endif /* getopt_int.h */
|