annotate lib/getsubopt.c @ 5138:965e5e2eaeac

New module 'getsubopt'.
author Bruno Haible <bruno@clisp.org>
date Fri, 06 Aug 2004 20:23:41 +0000
parents
children 8f943cf05985
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5138
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* Parse comma separate list into words.
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 Copyright (C) 1996, 1997, 1999, 2004 Free Software Foundation, Inc.
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 This file is part of the GNU C Library.
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4 Contributed by Ulrich Drepper <drepper@cygnus.com>, 1996.
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6 The GNU C Library is free software; you can redistribute it and/or
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
7 modify it under the terms of the GNU Lesser General Public
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8 License as published by the Free Software Foundation; either
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 version 2.1 of the License, or (at your option) any later version.
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 The GNU C Library is distributed in the hope that it will be useful,
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 Lesser General Public License for more details.
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
15
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16 You should have received a copy of the GNU Lesser General Public
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 License along with the GNU C Library; if not, write to the Free
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19 02111-1307 USA. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 #include <stdlib.h>
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22 #include <string.h>
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 #if !_LIBC
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 /* This code is written for inclusion in gnu-libc, and uses names in
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 the namespace reserved for libc. If we're compiling in gnulib,
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 define those names to be the normal ones instead. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 # include "strchrnul.h"
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 # undef __strchrnul
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 # define __strchrnul strchrnul
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 #endif
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 /* Parse comma separated suboption from *OPTIONP and match against
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
34 strings in TOKENS. If found return index and set *VALUEP to
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 optional value introduced by an equal sign. If the suboption is
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
36 not part of TOKENS return in *VALUEP beginning of unknown
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 suboption. On exit *OPTIONP is set to the beginning of the next
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
38 token or at the terminating NUL character. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
39 int
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
40 getsubopt (char **optionp, char *const *tokens, char **valuep)
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41 {
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
42 char *endp, *vstart;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
43 int cnt;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
44
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
45 if (**optionp == '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
46 return -1;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
47
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
48 /* Find end of next token. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
49 endp = __strchrnul (*optionp, ',');
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
50
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
51 /* Find start of value. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
52 vstart = memchr (*optionp, '=', endp - *optionp);
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
53 if (vstart == NULL)
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
54 vstart = endp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
55
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
56 /* Try to match the characters between *OPTIONP and VSTART against
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
57 one of the TOKENS. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
58 for (cnt = 0; tokens[cnt] != NULL; ++cnt)
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
59 if (strncmp (*optionp, tokens[cnt], vstart - *optionp) == 0
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
60 && tokens[cnt][vstart - *optionp] == '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
61 {
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
62 /* We found the current option in TOKENS. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
63 *valuep = vstart != endp ? vstart + 1 : NULL;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
64
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
65 if (*endp != '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
66 *endp++ = '\0';
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
67 *optionp = endp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
68
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
69 return cnt;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
70 }
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
71
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
72 /* The current suboption does not match any option. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
73 *valuep = *optionp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
74
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
75 if (*endp != '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
76 *endp++ = '\0';
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
77 *optionp = endp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
78
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
79 return -1;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
80 }