mirror of
git://git.sv.gnu.org/coreutils.git
synced 2026-02-16 12:22:01 +02:00
123 lines
4.4 KiB
C
123 lines
4.4 KiB
C
/* argmatch.h -- definitions and prototypes for argmatch.c
|
|
|
|
Copyright (C) 1990, 1998, 1999, 2001, 2002, 2004, 2005 Free Software
|
|
Foundation, Inc.
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
any later version.
|
|
|
|
This program 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 General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software Foundation,
|
|
Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
|
|
|
|
/* Written by David MacKenzie <djm@ai.mit.edu>
|
|
Modified by Akim Demaille <demaille@inf.enst.fr> */
|
|
|
|
#ifndef ARGMATCH_H_
|
|
# define ARGMATCH_H_ 1
|
|
|
|
# include <stddef.h>
|
|
|
|
# ifndef verify_dcl
|
|
# define GL_CONCAT0(x, y) x##y
|
|
# define GL_CONCAT(x, y) GL_CONCAT0 (x, y)
|
|
|
|
/* Verify requirement, R, at compile-time, as a declaration.
|
|
The implementation uses a struct declaration whose name includes the
|
|
expansion of __LINE__, so there is a small chance that two uses of
|
|
verify_dcl from different files will end up colliding (for example,
|
|
f.c includes f.h and verify_dcl is used on the same line in each). */
|
|
# define verify_dcl(R) \
|
|
struct GL_CONCAT (ct_assert_, __LINE__) { char a[(R) ? 1 : -1]; }
|
|
# endif
|
|
|
|
# define ARRAY_CARDINALITY(Array) (sizeof (Array) / sizeof *(Array))
|
|
|
|
# define ARGMATCH_CONSTRAINT(Arglist, Vallist) \
|
|
(ARRAY_CARDINALITY (Arglist) == ARRAY_CARDINALITY (Vallist) + 1)
|
|
|
|
/* Assert there are as many real arguments as there are values
|
|
(argument list ends with a NULL guard). ARGMATCH_VERIFY is
|
|
preferred, since it is guaranteed to be checked at compile-time.
|
|
ARGMATCH_ASSERT is for backward compatibility only. */
|
|
|
|
# define ARGMATCH_VERIFY(Arglist, Vallist) \
|
|
verify_dcl (ARGMATCH_CONSTRAINT (Arglist, Vallist))
|
|
|
|
# define ARGMATCH_ASSERT(Arglist, Vallist) \
|
|
assert (ARGMATCH_CONSTRAINT (Arglist, Vallist))
|
|
|
|
/* Return the index of the element of ARGLIST (NULL terminated) that
|
|
matches with ARG. If VALLIST is not NULL, then use it to resolve
|
|
false ambiguities (i.e., different matches of ARG but corresponding
|
|
to the same values in VALLIST). */
|
|
|
|
ptrdiff_t argmatch (char const *arg, char const *const *arglist,
|
|
char const *vallist, size_t valsize);
|
|
|
|
# define ARGMATCH(Arg, Arglist, Vallist) \
|
|
argmatch (Arg, Arglist, (char const *) (Vallist), sizeof *(Vallist))
|
|
|
|
/* xargmatch calls this function when it fails. This function should not
|
|
return. By default, this is a function that calls ARGMATCH_DIE which
|
|
in turn defaults to `exit (exit_failure)'. */
|
|
typedef void (*argmatch_exit_fn) (void);
|
|
extern argmatch_exit_fn argmatch_die;
|
|
|
|
/* Report on stderr why argmatch failed. Report correct values. */
|
|
|
|
void argmatch_invalid (char const *context, char const *value,
|
|
ptrdiff_t problem);
|
|
|
|
/* Left for compatibility with the old name invalid_arg */
|
|
|
|
# define invalid_arg(Context, Value, Problem) \
|
|
argmatch_invalid (Context, Value, Problem)
|
|
|
|
|
|
|
|
/* Report on stderr the list of possible arguments. */
|
|
|
|
void argmatch_valid (char const *const *arglist,
|
|
char const *vallist, size_t valsize);
|
|
|
|
# define ARGMATCH_VALID(Arglist, Vallist) \
|
|
argmatch_valid (Arglist, (char const *) (Vallist), sizeof *(Vallist))
|
|
|
|
|
|
|
|
/* Same as argmatch, but upon failure, reports a explanation on the
|
|
failure, and exits using the function EXIT_FN. */
|
|
|
|
ptrdiff_t __xargmatch_internal (char const *context,
|
|
char const *arg, char const *const *arglist,
|
|
char const *vallist, size_t valsize,
|
|
argmatch_exit_fn exit_fn);
|
|
|
|
/* Programmer friendly interface to __xargmatch_internal. */
|
|
|
|
# define XARGMATCH(Context, Arg, Arglist, Vallist) \
|
|
((Vallist) [__xargmatch_internal (Context, Arg, Arglist, \
|
|
(char const *) (Vallist), \
|
|
sizeof *(Vallist), \
|
|
argmatch_die)])
|
|
|
|
/* Convert a value into a corresponding argument. */
|
|
|
|
char const *argmatch_to_argument (char const *value,
|
|
char const *const *arglist,
|
|
char const *vallist, size_t valsize);
|
|
|
|
# define ARGMATCH_TO_ARGUMENT(Value, Arglist, Vallist) \
|
|
argmatch_to_argument (Value, Arglist, \
|
|
(char const *) (Vallist), sizeof *(Vallist))
|
|
|
|
#endif /* ARGMATCH_H_ */
|