1e86463205
* lib/dosname.h, lib/glthread/lock.c, lib/glthread/lock.h, lib/glthread/threadlib.c, lib/windows-mutex.c, lib/windows-mutex.h, lib/windows-once.c, lib/windows-once.h, lib/windows-recmutex.c, lib/windows-recmutex.h, lib/windows-rwlock.c, lib/windows-rwlock.h, m4/host-cpu-c-abi.m4, m4/lib-ld.m4, m4/lib-link.m4, m4/lib-prefix.m4, m4/lock.m4, m4/longlong.m4, m4/pthread_rwlock_rdlock.m4, tools/config.rpath: Delete. * lib/alloca.in.h, lib/argmatch.c, lib/argmatch.h, lib/arg-nonnull.h, lib/argp-ba.c, lib/argp-eexst.c, lib/argp-fmtstream.c, lib/argp-fmtstream.h, lib/argp-fs-xinl.c, lib/argp.h, lib/argp-help.c, lib/argp-namefrob.h, lib/argp-parse.c, lib/argp-pin.c, lib/argp-pv.c, lib/argp-pvh.c, lib/argp-xinl.c, lib/asnprintf.c, lib/basename-lgpl.c, lib/c-ctype.h, lib/c++defs.h, lib/cdefs.h, lib/closeout.c, lib/closeout.h, lib/close-stream.c, lib/c-strcasecmp.c, lib/c-strcaseeq.h, lib/c-strcase.h, lib/c-strncasecmp.c, lib/dirname.h, lib/dirname-lgpl.c, lib/errno.in.h, lib/error.c, lib/error.h, lib/exitfail.c, lib/exitfail.h, lib/fcntl.in.h, lib/filename.h, lib/float.c, lib/float+.h, lib/float.in.h, lib/fpending.c, lib/fpending.h, lib/getopt1.c, lib/getopt.c, lib/getopt-cdefs.in.h, lib/getopt-core.h, lib/getopt-ext.h, lib/getopt.in.h, lib/getopt_int.h, lib/getopt-pfx-core.h, lib/getopt-pfx-ext.h, lib/getprogname.c, lib/getprogname.h, lib/gettext.h, lib/gettimeofday.c, lib/hard-locale.c, lib/hard-locale.h, lib/intprops.h, lib/isatty.c, lib/itold.c, lib/libc-config.h, lib/limits.in.h, lib/localcharset.c, lib/localcharset.h, lib/localtime-buffer.c, lib/localtime-buffer.h, lib/lstat.c, lib/Makefile.am, lib/malloca.c, lib/malloca.h, lib/malloc.c, lib/mbrtowc.c, lib/mbsinit.c, lib/memchr.c, lib/memchr.valgrind, lib/mempcpy.c, lib/minmax.h, lib/mkdir.c, lib/mkstemp.c, lib/mkstemps.c, lib/msvc-inval.c, lib/msvc-inval.h, lib/msvc-nothrow.c, lib/msvc-nothrow.h, lib/_Noreturn.h, lib/pathmax.h, lib/printf-args.c, lib/printf-args.h, lib/printf-parse.c, lib/printf-parse.h, lib/progname.c, lib/progname.h, lib/quotearg.c, lib/quotearg.h, lib/quote.h, lib/rawmemchr.c, lib/rawmemchr.valgrind, lib/secure_getenv.c, lib/size_max.h, lib/sleep.c, lib/stat.c, lib/stat-time.h, lib/stat-w32.c, lib/stat-w32.h, lib/stdalign.in.h, lib/stdbool.in.h, lib/stddef.in.h, lib/stdint.in.h, lib/stdio-impl.h, lib/stdio.in.h, lib/stdlib.in.h, lib/stpcpy.c, lib/strcasecmp.c, lib/strchrnul.c, lib/strchrnul.valgrind, lib/streq.h, lib/strerror.c, lib/strerror-override.c, lib/strerror-override.h, lib/string.in.h, lib/strings.in.h, lib/stripslash.c, lib/strncasecmp.c, lib/strndup.c, lib/strnlen.c, lib/strverscmp.c, lib/sysexits.in.h, lib/sys_stat.in.h, lib/sys_time.in.h, lib/sys_types.in.h, lib/sys_wait.in.h, lib/tempname.c, lib/tempname.h, lib/time.in.h, lib/unistd.in.h, lib/vasnprintf.c, lib/vasnprintf.h, lib/verify.h, lib/vsnprintf.c, lib/warn-on-use.h, lib/wchar.in.h, lib/wctype.in.h, lib/windows-initguard.h, lib/xalloc-die.c, lib/xalloc.h, lib/xalloc-oversized.h, lib/xmalloc.c, lib/xsize.h, m4/00gnulib.m4, m4/absolute-header.m4, m4/alloca.m4, m4/argp.m4, m4/codeset.m4, m4/dirname.m4, m4/double-slash-root.m4, m4/eealloc.m4, m4/errno_h.m4, m4/error.m4, m4/exponentd.m4, m4/extensions.m4, m4/extern-inline.m4, m4/fcntl_h.m4, m4/fcntl-o.m4, m4/float_h.m4, m4/fpending.m4, m4/getopt.m4, m4/getprogname.m4, m4/gettimeofday.m4, m4/gnulib-cache.m4, m4/gnulib-common.m4, m4/gnulib-comp.m4, m4/gnulib-tool.m4, m4/include_next.m4, m4/__inline.m4, m4/intmax_t.m4, m4/inttypes_h.m4, m4/isatty.m4, m4/largefile.m4, m4/limits-h.m4, m4/localcharset.m4, m4/locale-fr.m4, m4/locale-ja.m4, m4/locale-zh.m4, m4/localtime-buffer.m4, m4/lstat.m4, m4/malloca.m4, m4/malloc.m4, m4/math_h.m4, m4/mbrtowc.m4, m4/mbsinit.m4, m4/mbstate_t.m4, m4/memchr.m4, m4/mempcpy.m4, m4/minmax.m4, m4/mkdir.m4, m4/mkstemp.m4, m4/mkstemps.m4, m4/mmap-anon.m4, m4/msvc-inval.m4, m4/msvc-nothrow.m4, m4/multiarch.m4, m4/nocrash.m4, m4/off_t.m4, m4/pathmax.m4, m4/printf.m4, m4/quotearg.m4, m4/quote.m4, m4/rawmemchr.m4, m4/secure_getenv.m4, m4/size_max.m4, m4/sleep.m4, m4/ssize_t.m4, m4/stat.m4, m4/stat-time.m4, m4/stdalign.m4, m4/stdbool.m4, m4/stddef_h.m4, m4/std-gnu11.m4, m4/stdint_h.m4, m4/stdint.m4, m4/stdio_h.m4, m4/stdlib_h.m4, m4/stpcpy.m4, m4/strcase.m4, m4/strchrnul.m4, m4/strerror.m4, m4/string_h.m4, m4/strings_h.m4, m4/strndup.m4, m4/strnlen.m4, m4/strverscmp.m4, m4/sysexits.m4, m4/sys_socket_h.m4, m4/sys_stat_h.m4, m4/sys_time_h.m4, m4/sys_types_h.m4, m4/sys_wait_h.m4, m4/tempname.m4, m4/threadlib.m4, m4/time_h.m4, m4/unistd_h.m4, m4/vasnprintf.m4, m4/vsnprintf.m4, m4/warn-on-use.m4, m4/wchar_h.m4, m4/wchar_t.m4, m4/wctype_h.m4, m4/wint_t.m4, m4/xalloc.m4, m4/xsize.m4: Update. * lib/inttypes.in.h, lib/lc-charset-dispatch.c, lib/lc-charset-dispatch.h, lib/locale.in.h, lib/mbrtowc-impl.h, lib/mbrtowc-impl-utf8.h, lib/mbtowc-lock.c, lib/mbtowc-lock.h, lib/setlocale-lock.c, lib/setlocale_null.c, lib/setlocale_null.h, m4/inttypes.m4, m4/locale_h.m4, m4/setlocale_null.m4, m4/visibility.m4, m4/zzgnulib.m4: New files.
331 lines
19 KiB
C
331 lines
19 KiB
C
/* argmatch.h -- definitions and prototypes for argmatch.c
|
|
|
|
Copyright (C) 1990, 1998-1999, 2001-2002, 2004-2005, 2009-2020 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 3 of the License, 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, see <https://www.gnu.org/licenses/>. */
|
|
|
|
/* Written by David MacKenzie <djm@ai.mit.edu>
|
|
Modified by Akim Demaille <demaille@inf.enst.fr> */
|
|
|
|
#ifndef ARGMATCH_H_
|
|
# define ARGMATCH_H_ 1
|
|
|
|
# include <limits.h>
|
|
# include <stdbool.h>
|
|
# include <stddef.h>
|
|
# include <stdio.h>
|
|
# include <string.h> /* memcmp */
|
|
|
|
# include "gettext.h"
|
|
# include "quote.h"
|
|
# include "verify.h"
|
|
|
|
# ifdef __cplusplus
|
|
extern "C" {
|
|
# endif
|
|
|
|
# define ARRAY_CARDINALITY(Array) (sizeof (Array) / sizeof *(Array))
|
|
|
|
/* Assert there are as many real arguments as there are values
|
|
(argument list ends with a NULL guard). */
|
|
|
|
# define ARGMATCH_VERIFY(Arglist, Vallist) \
|
|
verify (ARRAY_CARDINALITY (Arglist) == ARRAY_CARDINALITY (Vallist) + 1)
|
|
|
|
/* 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,
|
|
void const *vallist, size_t valsize) _GL_ATTRIBUTE_PURE;
|
|
|
|
# define ARGMATCH(Arg, Arglist, Vallist) \
|
|
argmatch (Arg, Arglist, (void 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,
|
|
void const *vallist, size_t valsize);
|
|
|
|
# define ARGMATCH_VALID(Arglist, Vallist) \
|
|
argmatch_valid (Arglist, (void const *) (Vallist), sizeof *(Vallist))
|
|
|
|
|
|
|
|
/* Same as argmatch, but upon failure, report an explanation of the
|
|
failure, and exit using the function EXIT_FN. */
|
|
|
|
ptrdiff_t __xargmatch_internal (char const *context,
|
|
char const *arg, char const *const *arglist,
|
|
void 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, \
|
|
(void const *) (Vallist), \
|
|
sizeof *(Vallist), \
|
|
argmatch_die)])
|
|
|
|
/* Convert a value into a corresponding argument. */
|
|
|
|
char const *argmatch_to_argument (void const *value,
|
|
char const *const *arglist,
|
|
void const *vallist, size_t valsize)
|
|
_GL_ATTRIBUTE_PURE;
|
|
|
|
# define ARGMATCH_TO_ARGUMENT(Value, Arglist, Vallist) \
|
|
argmatch_to_argument (Value, Arglist, \
|
|
(void const *) (Vallist), sizeof *(Vallist))
|
|
|
|
# define ARGMATCH_DEFINE_GROUP(Name, Type) \
|
|
/* The type of the values of this group. */ \
|
|
typedef Type argmatch_##Name##_type; \
|
|
\
|
|
/* The size of the type of the values of this group. */ \
|
|
enum argmatch_##Name##_size_enum \
|
|
{ \
|
|
argmatch_##Name##_size = sizeof (argmatch_##Name##_type) \
|
|
}; \
|
|
\
|
|
/* Argument mapping of this group. */ \
|
|
typedef struct \
|
|
{ \
|
|
/* Argument (e.g., "simple"). */ \
|
|
const char *arg; \
|
|
/* Value (e.g., simple_backups). */ \
|
|
const argmatch_##Name##_type val; \
|
|
} argmatch_##Name##_arg; \
|
|
\
|
|
/* Documentation of this group. */ \
|
|
typedef struct \
|
|
{ \
|
|
/* Argument (e.g., "simple"). */ \
|
|
const char *arg; \
|
|
/* Documentation (e.g., N_("always make simple backups")). */ \
|
|
const char *doc; \
|
|
} argmatch_##Name##_doc; \
|
|
\
|
|
/* All the features of an argmatch group. */ \
|
|
typedef struct \
|
|
{ \
|
|
const argmatch_##Name##_arg* args; \
|
|
const argmatch_##Name##_doc* docs; \
|
|
\
|
|
/* Printed before the usage message. */ \
|
|
const char *doc_pre; \
|
|
/* Printed after the usage message. */ \
|
|
const char *doc_post; \
|
|
} argmatch_##Name##_group_type; \
|
|
\
|
|
/* The structure the user must build. */ \
|
|
extern const argmatch_##Name##_group_type argmatch_##Name##_group; \
|
|
\
|
|
/* Print the documentation of this group. */ \
|
|
void argmatch_##Name##_usage (FILE *out); \
|
|
\
|
|
/* If nonnegative, the index I of ARG in ARGS, i.e, \
|
|
ARGS[I] == ARG. \
|
|
Return -1 for invalid argument, -2 for ambiguous argument. */ \
|
|
ptrdiff_t argmatch_##Name##_choice (const char *arg); \
|
|
\
|
|
/* A pointer to the corresponding value if it exists, or \
|
|
report an error and exit with failure if the argument was \
|
|
not recognized. */ \
|
|
const argmatch_##Name##_type* \
|
|
argmatch_##Name##_value (const char *context, const char *arg); \
|
|
\
|
|
/* The first argument in ARGS that matches this value, or NULL. */ \
|
|
const char * \
|
|
argmatch_##Name##_argument (const argmatch_##Name##_type *val); \
|
|
\
|
|
ptrdiff_t \
|
|
argmatch_##Name##_choice (const char *arg) \
|
|
{ \
|
|
const argmatch_##Name##_group_type *g = &argmatch_##Name##_group; \
|
|
size_t size = argmatch_##Name##_size; \
|
|
ptrdiff_t res = -1; /* Index of first nonexact match. */ \
|
|
bool ambiguous = false; /* Whether multiple nonexact match(es). */ \
|
|
size_t arglen = strlen (arg); \
|
|
\
|
|
/* Test all elements for either exact match or abbreviated \
|
|
matches. */ \
|
|
for (size_t i = 0; g->args[i].arg; i++) \
|
|
if (!strncmp (g->args[i].arg, arg, arglen)) \
|
|
{ \
|
|
if (strlen (g->args[i].arg) == arglen) \
|
|
/* Exact match found. */ \
|
|
return i; \
|
|
else if (res == -1) \
|
|
/* First nonexact match found. */ \
|
|
res = i; \
|
|
else if (memcmp (&g->args[res].val, &g->args[i].val, size)) \
|
|
/* Second nonexact match found. */ \
|
|
/* There is a real ambiguity, or we could not \
|
|
disambiguate. */ \
|
|
ambiguous = true; \
|
|
} \
|
|
return ambiguous ? -2 : res; \
|
|
} \
|
|
\
|
|
const char * \
|
|
argmatch_##Name##_argument (const argmatch_##Name##_type *val) \
|
|
{ \
|
|
const argmatch_##Name##_group_type *g = &argmatch_##Name##_group; \
|
|
size_t size = argmatch_##Name##_size; \
|
|
for (size_t i = 0; g->args[i].arg; i++) \
|
|
if (!memcmp (val, &g->args[i].val, size)) \
|
|
return g->args[i].arg; \
|
|
return NULL; \
|
|
} \
|
|
\
|
|
/* List the valid values of this group. */ \
|
|
static void \
|
|
argmatch_##Name##_valid (FILE *out) \
|
|
{ \
|
|
const argmatch_##Name##_group_type *g = &argmatch_##Name##_group; \
|
|
size_t size = argmatch_##Name##_size; \
|
|
\
|
|
/* Try to put synonyms on the same line. Synonyms are expected \
|
|
to follow each other. */ \
|
|
fputs (gettext ("Valid arguments are:"), out); \
|
|
for (int i = 0; g->args[i].arg; i++) \
|
|
if (i == 0 \
|
|
|| memcmp (&g->args[i-1].val, &g->args[i].val, size)) \
|
|
fprintf (out, "\n - %s", quote (g->args[i].arg)); \
|
|
else \
|
|
fprintf (out, ", %s", quote (g->args[i].arg)); \
|
|
putc ('\n', out); \
|
|
} \
|
|
\
|
|
const argmatch_##Name##_type* \
|
|
argmatch_##Name##_value (const char *context, const char *arg) \
|
|
{ \
|
|
const argmatch_##Name##_group_type *g = &argmatch_##Name##_group; \
|
|
ptrdiff_t res = argmatch_##Name##_choice (arg); \
|
|
if (res < 0) \
|
|
{ \
|
|
argmatch_invalid (context, arg, res); \
|
|
argmatch_##Name##_valid (stderr); \
|
|
argmatch_die (); \
|
|
} \
|
|
return &g->args[res].val; \
|
|
} \
|
|
\
|
|
/* The column in which the documentation is displayed. \
|
|
The leftmost possible, but no more than 20. */ \
|
|
static int \
|
|
argmatch_##Name##_doc_col (void) \
|
|
{ \
|
|
const argmatch_##Name##_group_type *g = &argmatch_##Name##_group; \
|
|
size_t size = argmatch_##Name##_size; \
|
|
int res = 0; \
|
|
for (int i = 0; g->docs[i].arg; ++i) \
|
|
{ \
|
|
int col = 4; \
|
|
int ival = argmatch_##Name##_choice (g->docs[i].arg); \
|
|
if (ival < 0) \
|
|
/* Pseudo argument, display it. */ \
|
|
col += strlen (g->docs[i].arg); \
|
|
else \
|
|
/* Genuine argument, display it with its synonyms. */ \
|
|
for (int j = 0; g->args[j].arg; ++j) \
|
|
if (! memcmp (&g->args[ival].val, &g->args[j].val, size)) \
|
|
col += (col == 4 ? 0 : 2) + strlen (g->args[j].arg); \
|
|
if (res <= col) \
|
|
res = col <= 20 ? col : 20; \
|
|
} \
|
|
return res ? res : 20; \
|
|
} \
|
|
\
|
|
void \
|
|
argmatch_##Name##_usage (FILE *out) \
|
|
{ \
|
|
const argmatch_##Name##_group_type *g = &argmatch_##Name##_group; \
|
|
size_t size = argmatch_##Name##_size; \
|
|
/* Width of the screen. Help2man does not seem to support \
|
|
arguments on several lines, so in that case pretend a very \
|
|
large width. */ \
|
|
const int screen_width = getenv ("HELP2MAN") ? INT_MAX : 80; \
|
|
if (g->doc_pre) \
|
|
fprintf (out, "%s\n", gettext (g->doc_pre)); \
|
|
int doc_col = argmatch_##Name##_doc_col (); \
|
|
for (int i = 0; g->docs[i].arg; ++i) \
|
|
{ \
|
|
int col = 0; \
|
|
bool first = true; \
|
|
int ival = argmatch_##Name##_choice (g->docs[i].arg); \
|
|
if (ival < 0) \
|
|
/* Pseudo argument, display it. */ \
|
|
col += fprintf (out, " %s", g->docs[i].arg); \
|
|
else \
|
|
/* Genuine argument, display it with its synonyms. */ \
|
|
for (int j = 0; g->args[j].arg; ++j) \
|
|
if (! memcmp (&g->args[ival].val, &g->args[j].val, size)) \
|
|
{ \
|
|
if (!first \
|
|
&& screen_width < col + 2 + strlen (g->args[j].arg)) \
|
|
{ \
|
|
fprintf (out, ",\n"); \
|
|
col = 0; \
|
|
first = true; \
|
|
} \
|
|
if (first) \
|
|
{ \
|
|
col += fprintf (out, " "); \
|
|
first = false; \
|
|
} \
|
|
else \
|
|
col += fprintf (out, ","); \
|
|
col += fprintf (out, " %s", g->args[j].arg); \
|
|
} \
|
|
/* The doc. Separated by at least two spaces. */ \
|
|
if (doc_col < col + 2) \
|
|
{ \
|
|
fprintf (out, "\n"); \
|
|
col = 0; \
|
|
} \
|
|
fprintf (out, "%*s%s\n", \
|
|
doc_col - col, "", gettext (g->docs[i].doc)); \
|
|
} \
|
|
if (g->doc_post) \
|
|
fprintf (out, "%s\n", gettext (g->doc_post)); \
|
|
}
|
|
|
|
# ifdef __cplusplus
|
|
}
|
|
# endif
|
|
|
|
#endif /* ARGMATCH_H_ */
|