]> git.pond.sub.org Git - empserver/blob - src/lib/common/stmtch.c
Doc & formatting fixes.
[empserver] / src / lib / common / stmtch.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  *  stmtch.c: Matching operations on structures and commands
29  * 
30  *  Known contributors to this file:
31  *     
32  */
33
34 #include "misc.h"
35 #include "match.h"
36
37 /*
38  * Find NEEDLE in array HAYSTACK[], return its index.
39  * Return M_NOTFOUND if there are no matches, M_NOTUNIQUE if there are
40  * several.
41  * Each array element has a pointer to its name stored at offset OFFS.
42  * Search stops when this name is a null pointer or empty.  NEEDLE is
43  * compared to element names with mineq(NEEDLE, NAME).
44  * ELT_SIZE gives the size of an array element.
45  */
46 int
47 stmtch(char *needle, void *haystack, ptrdiff_t offs, size_t elt_size)
48 {
49 #define ELT_NAME(i) (*(char **)((char *)haystack + (i)*elt_size + offs))
50     int i, res;
51
52     res = M_NOTFOUND;
53     for (i = 0; ELT_NAME(i) && ELT_NAME(i)[0] != 0; ++i) {
54         switch (mineq(needle, ELT_NAME(i))) {
55         case ME_MISMATCH:
56             break;
57         case ME_PARTIAL:
58             if (res >= 0)
59                 return M_NOTUNIQUE;
60             res = i;
61             break;
62         case ME_EXACT:
63             return i;
64         }
65     }
66     return res;
67 #undef ELT_NAME
68 }
69
70 /*
71  * Compare A with B.
72  * Return ME_EXACT if they are the same, or A is a prefix of B
73  * followed by a space in B.
74  * Return ME_PARTIAL if A is a prefix of B not followed by a space.
75  * Else return ME_NOMATCH.
76  */
77 int
78 mineq(char *a, char *b)
79 {
80     int i;
81
82     /* find common prefix: */
83     for (i = 0; a[i] != 0 && a[i] == b[i]; ++i) ;
84
85     if (a[i] != 0) return ME_MISMATCH;
86     if (b[i] == 0 || b[i] == ' ') return ME_EXACT;
87     return ME_PARTIAL;
88 }