]> git.pond.sub.org Git - empserver/blob - src/lib/gen/parse.c
Document, in particular use of UTF-8. Simplify code in a couple of
[empserver] / src / lib / gen / parse.c
1 /*
2  *  Empire - A multi-player, client/server Internet based war game.
3  *  Copyright (C) 1986-2005, Dave Pare, Jeff Bailey, Thomas Ruschak,
4  *                           Ken Stevens, Steve McClure
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *  GNU General Public License for more details.
15  *
16  *  You should have received a copy of the GNU General Public License
17  *  along with this program; if not, write to the Free Software
18  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19  *
20  *  ---
21  *
22  *  See the "LEGAL", "LICENSE", "CREDITS" and "README" files for all the
23  *  related information and legal notices. It is expected that any future
24  *  projects/authors will amend these files as needed.
25  *
26  *  ---
27  *
28  *  parse.c: Parse an Empire command line
29  * 
30  *  Known contributors to this file:
31  *     
32  */
33
34 #include <ctype.h>
35 #include "misc.h"
36 #include "gen.h"
37
38 /*
39  * Parse user command in BUF.
40  * BUF is UTF-8.
41  * Set ARG[0] to point to the command name.
42  * Set ARG[1..N] to point to arguments, where N is the number of
43  * arguments.  Set ARG[N+1..127] to NULL.
44  * If *CONDP is not null, recognize conditional argument syntax, and
45  * set *CONDP to the conditional argument if present, else NULL.
46  * Command name and arguments are copied into SPACE[], whose size must
47  * be at least strlen(BUF) + 1.
48  * If *REDIR is not null, recognize redirection syntax, and set *REDIR
49  * to UTF-8 redirection string if present, else NULL.
50  * Return number of slots used in ARG[], or -1 on error.
51  */
52 int
53 parse(char *buf, char **arg, char **condp, char *space, char **redir)
54 {
55     char *bp2;
56     char *bp1 = space;
57     int fs;
58     int quoted;
59     int argnum;
60
61     if (redir)
62         *redir = 0;
63     if (condp != NULL)
64         *condp = NULL;
65     for (argnum = 0; *buf && argnum < 127;) {
66         while (isspace(*buf))
67             buf++;
68         if (!*buf)
69             break;
70         if (redir && (*buf == '>' || *buf == '|')) {
71             *redir = buf;
72             break;
73         }
74         quoted = 0;
75         for (bp2 = bp1; *buf;) {
76             if (!quoted && isspace(*buf)) {
77                 buf++;
78                 break;
79             }
80             if (*buf == '"') {
81                 quoted = !quoted;
82                 buf++;
83             } else {
84                 if (*buf >= 0x20 && *buf <= 0x7e)
85                     *bp1++ = *buf++;
86                 else
87                     buf++;
88             }
89         }
90         *bp1++ = 0;
91         if (*bp2 == '?' && condp != NULL) {
92             *condp = bp2 + 1;
93         } else {
94             arg[argnum] = bp2;
95             argnum++;
96         }
97     }
98     for (fs = argnum; fs < 128; fs++)
99         arg[fs] = NULL;
100     return argnum;
101 }