1999-01-01 00:19:31 +08:00
|
|
|
/* argmatch.h -- definitions and prototypes for argmatch.c
|
2004-01-22 06:35:10 +08:00
|
|
|
|
|
|
|
Copyright (C) 1990, 1998, 1999, 2001, 2002, 2004 Free Software
|
|
|
|
Foundation, Inc.
|
1995-12-22 07:05:56 +08:00
|
|
|
|
1999-01-01 00:18:46 +08:00
|
|
|
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.
|
1995-12-22 07:05:56 +08:00
|
|
|
|
1999-01-01 00:18:46 +08:00
|
|
|
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.
|
1995-12-22 07:05:56 +08:00
|
|
|
|
1999-01-01 00:18:46 +08:00
|
|
|
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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
|
|
|
|
|
|
|
|
/* Written by David MacKenzie <djm@ai.mit.edu>
|
|
|
|
Modified by Akim Demaille <demaille@inf.enst.fr> */
|
|
|
|
|
1999-01-02 01:34:18 +08:00
|
|
|
#ifndef ARGMATCH_H_
|
|
|
|
# define ARGMATCH_H_ 1
|
1999-01-01 00:18:46 +08:00
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
# include <stddef.h>
|
1999-01-01 00:18:46 +08:00
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
# define ARRAY_CARDINALITY(Array) (sizeof (Array) / sizeof *(Array))
|
1999-01-01 00:18:46 +08:00
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
# define ARGMATCH_CONSTRAINT(Arglist, Vallist) \
|
|
|
|
(ARRAY_CARDINALITY (Arglist) == ARRAY_CARDINALITY (Vallist) + 1)
|
1999-01-01 00:18:46 +08:00
|
|
|
|
1999-01-25 22:52:13 +08:00
|
|
|
/* Assert there are as many real arguments as there are values
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
(argument list ends with a NULL guard). ARGMATCH_VERIFY is
|
2002-11-22 19:04:01 +08:00
|
|
|
preferred, since it is guaranteed to be checked at compile-time.
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
ARGMATCH_ASSERT is for backward compatibility only. */
|
1999-01-25 22:52:13 +08:00
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
# define ARGMATCH_VERIFY(Arglist, Vallist) \
|
|
|
|
struct argmatch_verify \
|
|
|
|
{ \
|
|
|
|
char argmatch_verify[ARGMATCH_CONSTRAINT(Arglist, Vallist) ? 1 : -1]; \
|
|
|
|
}
|
1999-01-25 22:52:13 +08:00
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
# define ARGMATCH_ASSERT(Arglist, Vallist) \
|
|
|
|
assert (ARGMATCH_CONSTRAINT (Arglist, Vallist))
|
1999-01-25 22:52:13 +08:00
|
|
|
|
1999-01-01 00:18:46 +08:00
|
|
|
/* 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). */
|
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
int argmatch (char const *arg, char const *const *arglist,
|
|
|
|
char const *vallist, size_t valsize);
|
1999-01-01 00:18:46 +08:00
|
|
|
|
1999-01-01 02:12:40 +08:00
|
|
|
# define ARGMATCH(Arg, Arglist, Vallist) \
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
argmatch (Arg, Arglist, (char const *) (Vallist), sizeof *(Vallist))
|
1999-01-01 00:18:46 +08:00
|
|
|
|
1999-01-25 21:59:34 +08:00
|
|
|
/* xargmatch calls this function when it fails. This function should not
|
|
|
|
return. By default, this is a function that calls ARGMATCH_DIE which
|
2004-01-22 06:35:10 +08:00
|
|
|
in turn defaults to `exit (exit_failure)'. */
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
typedef void (*argmatch_exit_fn) (void);
|
1999-01-16 23:21:52 +08:00
|
|
|
extern argmatch_exit_fn argmatch_die;
|
1999-01-01 00:18:46 +08:00
|
|
|
|
|
|
|
/* Report on stderr why argmatch failed. Report correct values. */
|
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
void argmatch_invalid (char const *context, char const *value, int problem);
|
1999-01-01 00:18:46 +08:00
|
|
|
|
|
|
|
/* Left for compatibility with the old name invalid_arg */
|
|
|
|
|
1999-01-16 23:12:04 +08:00
|
|
|
# define invalid_arg(Context, Value, Problem) \
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
argmatch_invalid (Context, Value, Problem)
|
1999-01-01 00:18:46 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Report on stderr the list of possible arguments. */
|
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
void argmatch_valid (char const *const *arglist,
|
|
|
|
char const *vallist, size_t valsize);
|
1999-01-01 00:18:46 +08:00
|
|
|
|
1999-01-01 02:10:53 +08:00
|
|
|
# define ARGMATCH_VALID(Arglist, Vallist) \
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
argmatch_valid (Arglist, (char const *) (Vallist), sizeof *(Vallist))
|
1999-01-16 23:12:04 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* Same as argmatch, but upon failure, reports a explanation on the
|
|
|
|
failure, and exits using the function EXIT_FN. */
|
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
int __xargmatch_internal (char const *context,
|
|
|
|
char const *arg, char const *const *arglist,
|
|
|
|
char const *vallist, size_t valsize,
|
2002-11-22 19:04:01 +08:00
|
|
|
argmatch_exit_fn exit_fn);
|
1999-01-16 23:12:04 +08:00
|
|
|
|
|
|
|
/* Programmer friendly interface to __xargmatch_internal. */
|
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
# define XARGMATCH(Context, Arg, Arglist, Vallist) \
|
|
|
|
((Vallist) [__xargmatch_internal (Context, Arg, Arglist, \
|
|
|
|
(char const *) (Vallist), \
|
|
|
|
sizeof *(Vallist), \
|
2002-11-22 19:04:01 +08:00
|
|
|
argmatch_die)])
|
1999-01-01 00:18:46 +08:00
|
|
|
|
|
|
|
/* Convert a value into a corresponding argument. */
|
|
|
|
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
char const *argmatch_to_argument (char const *value,
|
|
|
|
char const *const *arglist,
|
|
|
|
char const *vallist, size_t valsize);
|
1999-01-01 00:18:46 +08:00
|
|
|
|
1999-01-03 02:33:08 +08:00
|
|
|
# define ARGMATCH_TO_ARGUMENT(Value, Arglist, Vallist) \
|
Merge argmatch cleanups from Bison. Assume C89.
Do not include <config.h> or <sys/types.h>.
Include <stddef.h> instead, since it's all we need for size_t.
(PARAMS): Remove. All uses removed.
(ARRAY_CARDINALITY): Do not bother to #undef.
(ARRAY_CARDINALITY, ARGMATCH, ARGCASEMATCH, invalid_arg,
ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Remove unnecessary parentheses.
(ARGMATCH_VALID, XARGMATCH, XARGCASEMATCH):
Insert necessary parentheses.
(ARGMATCH_CONSTRAINT, ARGMATCH_VERIFY): New macros.
(ARGMATCH_ASSERT): Use ARGMATCH_CONSTRAINT.
2002-11-21 17:35:51 +08:00
|
|
|
argmatch_to_argument (Value, Arglist, \
|
|
|
|
(char const *) (Vallist), sizeof *(Vallist))
|
1999-01-01 00:18:46 +08:00
|
|
|
|
1999-01-02 01:34:18 +08:00
|
|
|
#endif /* ARGMATCH_H_ */
|