git.pond.sub.org Git - empserver/blob - src/lib/common/stmtch.c

   1 /*
   2  *  Empire - A multi-player, client/server Internet based war game.
   3  *  Copyright (C) 1986-2020, Dave Pare, Jeff Bailey, Thomas Ruschak,
   4  *                Ken Stevens, Steve McClure, Markus Armbruster
   5  *
   6  *  Empire 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 3 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, see <http://www.gnu.org/licenses/>.
  18  *
  19  *  ---
  20  *
  21  *  See files README, COPYING and CREDITS in the root of the source
  22  *  tree for related information and legal notices.  It is expected
  23  *  that future projects/authors will amend these files as needed.
  24  *
  25  *  ---
  26  *
  27  *  stmtch.c: Matching operations on structures and commands
  28  *
  29  *  Known contributors to this file:
  30  *     Markus Armbruster, 2004-2010
  31  */
  32
  33 #include <config.h>
  34
  35 #include "match.h"
  36
  37 /*
  38  * Find element named @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.
  43  * It ignores elements with an empty name.
  44  * @needle is compared to element names with mineq(@needle, NAME).
  45  * @size gives the size of an array element.
  46  */
  47 int
  48 stmtch(char *needle, void *haystack, ptrdiff_t offs, size_t size)
  49 {
  50     int i, res;
  51     char *name;
  52
  53     res = M_NOTFOUND;
  54     for (i = 0;; i++) {
  55         name = *(char **)((char *)haystack + i * size + offs);
  56         if (!name)
  57             break;
  58         if (!*name)
  59             continue;
  60         switch (mineq(needle, name)) {
  61         case ME_MISMATCH:
  62             break;
  63         case ME_PARTIAL:
  64             if (res == M_NOTFOUND)
  65                 res = i;
  66             else
  67                 res = M_NOTUNIQUE;
  68             break;
  69         case ME_EXACT:
  70             return i;
  71         }
  72     }
  73     return res;
  74 }
  75
  76 /*
  77  * Compare @a with @b.
  78  * Return ME_EXACT if they are the same, or @a is a prefix of @b
  79  * followed by a space in @b.
  80  * Return ME_PARTIAL if @a is a prefix of @b not followed by a space.
  81  * Else return ME_MISMATCH.
  82  */
  83 int
  84 mineq(char *a, char *b)
  85 {
  86     int i;
  87
  88     /* find common prefix: */
  89     for (i = 0; a[i] != 0 && a[i] == b[i]; i++) ;
  90
  91     if (a[i] != 0)
  92         return ME_MISMATCH;
  93     if (b[i] == 0 || b[i] == ' ')
  94         return ME_EXACT;
  95     return ME_PARTIAL;
  96 }