annotate lib/getsubopt.c @ 5459:e88a820ff3bb

Add log for human.h, xgetcwd.c (import from coreutils).
author Paul Eggert <eggert@cs.ucla.edu>
date Wed, 17 Nov 2004 07:32:27 +0000
parents 8f943cf05985
children a48fb0e98c8c
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
5243
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
6 This program is free software; you can redistribute it and/or modify
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
7 it under the terms of the GNU General Public License as published by
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
8 the Free Software Foundation; either version 2, or (at your option)
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
9 any later version.
5138
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10
5243
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
11 This program is distributed in the hope that it will be useful,
5138
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
5243
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
14 GNU General Public License for more details.
5138
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
15
5243
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
16 You should have received a copy of the GNU General Public License along
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
17 with this program; if not, write to the Free Software Foundation,
8f943cf05985 Regenerate, now that it's listed in ../config/srclist.txt.
Paul Eggert <eggert@cs.ucla.edu>
parents: 5138
diff changeset
18 Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */
5138
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 #include <stdlib.h>
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 #include <string.h>
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
22
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
23 #if !_LIBC
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 /* 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
25 the namespace reserved for libc. If we're compiling in gnulib,
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 define those names to be the normal ones instead. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27 # include "strchrnul.h"
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 # undef __strchrnul
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 # define __strchrnul strchrnul
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 #endif
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 /* Parse comma separated suboption from *OPTIONP and match against
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
33 strings in TOKENS. If found return index and set *VALUEP to
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
34 optional value introduced by an equal sign. If the suboption is
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 not part of TOKENS return in *VALUEP beginning of unknown
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
36 suboption. On exit *OPTIONP is set to the beginning of the next
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 token or at the terminating NUL character. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
38 int
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
39 getsubopt (char **optionp, char *const *tokens, char **valuep)
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
40 {
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41 char *endp, *vstart;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
42 int cnt;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
43
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
44 if (**optionp == '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
45 return -1;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
46
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
47 /* Find end of next token. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
48 endp = __strchrnul (*optionp, ',');
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
49
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
50 /* Find start of value. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
51 vstart = memchr (*optionp, '=', endp - *optionp);
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
52 if (vstart == NULL)
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
53 vstart = endp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
54
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
55 /* Try to match the characters between *OPTIONP and VSTART against
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
56 one of the TOKENS. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
57 for (cnt = 0; tokens[cnt] != NULL; ++cnt)
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
58 if (strncmp (*optionp, tokens[cnt], vstart - *optionp) == 0
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
59 && tokens[cnt][vstart - *optionp] == '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
60 {
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
61 /* We found the current option in TOKENS. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
62 *valuep = vstart != endp ? vstart + 1 : NULL;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
63
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
64 if (*endp != '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
65 *endp++ = '\0';
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
66 *optionp = endp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
67
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
68 return cnt;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
69 }
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 /* The current suboption does not match any option. */
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
72 *valuep = *optionp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
73
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
74 if (*endp != '\0')
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
75 *endp++ = '\0';
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
76 *optionp = endp;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
77
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
78 return -1;
965e5e2eaeac New module 'getsubopt'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
79 }