git.pond.sub.org Git - empserver/blob - src/lib/subs/snxtitem.c

   1 /*
   2  *  Empire - A multi-player, client/server Internet based war game.
   3  *  Copyright (C) 1986-2011, 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  *  snxtitem.c: Arrange item selection using one of many criteria.
  28  *
  29  *  Known contributors to this file:
  30  *     Dave Pare, 1989
  31  *     Markus Armbruster, 2009
  32  */
  33
  34 #include <config.h>
  35
  36 #include <ctype.h>
  37 #include "misc.h"
  38 #include "player.h"
  39 #include "xy.h"
  40 #include "nsc.h"
  41 #include "file.h"
  42 #include "prototypes.h"
  43 #include "unit.h"
  44
  45 /*
  46  * setup the nstr structure for sector selection.
  47  * can select on NS_ALL, NS_AREA, NS_DIST, and NS_LIST.
  48  * iterate thru the "condarg" string looking
  49  * for arguments to compile into the nstr.
  50  * Using this function for anything but command arguments is usually
  51  * incorrect, because it respects conditionals.  Use the snxtitem_FOO()
  52  * instead.
  53  */
  54 int
  55 snxtitem(struct nstr_item *np, int type, char *str, char *prompt)
  56 {
  57     struct range range;
  58     int list[NS_LSIZE];
  59     int cnum, n;
  60     coord cx, cy;
  61     int dist;
  62     int flags;
  63     char promptbuf[128];
  64     char buf[1024];
  65
  66     np->type = EF_BAD;
  67     np->sel = NS_UNDEF;
  68     if (!str) {
  69         if (!prompt) {
  70             sprintf(promptbuf, "%s(s)? ", ef_nameof(type));
  71             prompt = promptbuf;
  72         }
  73         str = getstring(prompt, buf);
  74         if (!str)
  75             return 0;
  76     }
  77     if (*str == 0) {
  78         /* empty string passed by player */
  79         return 0;
  80     }
  81     if (type == EF_NATION && isalpha(*str)) {
  82         cnum = natarg(str, NULL);
  83         if (cnum < 0)
  84             return 0;
  85         sprintf(buf, "%d", cnum);
  86         str = buf;
  87     }
  88     flags = ef_flags(type);
  89     switch (sarg_type(str)) {
  90     case NS_AREA:
  91         if (!(flags & EFF_XY))
  92             return 0;
  93         if (!sarg_area(str, &range))
  94             return 0;
  95         snxtitem_area(np, type, &range);
  96         break;
  97     case NS_DIST:
  98         if (!(flags & EFF_XY))
  99             return 0;
 100         if (!sarg_range(str, &cx, &cy, &dist))
 101             return 0;
 102         snxtitem_dist(np, type, cx, cy, dist);
 103         break;
 104     case NS_ALL:
 105         snxtitem_all(np, type);
 106         break;
 107     case NS_LIST:
 108         if ((n = sarg_list(str, list, NS_LSIZE)) == 0)
 109             return 0;
 110         if (!snxtitem_list(np, type, list, n))
 111             return 0;
 112         break;
 113     case NS_XY:
 114         if (!(flags & EFF_XY))
 115             return 0;
 116         if (!sarg_xy(str, &cx, &cy))
 117             return 0;
 118         snxtitem_xy(np, type, cx, cy);
 119         break;
 120     case NS_GROUP:
 121         if (!(flags & EFF_GROUP))
 122             return 0;
 123         snxtitem_group(np, type, *str);
 124         break;
 125     default:
 126         return 0;
 127     }
 128     if (!player->condarg)
 129         return 1;
 130     n = nstr_comp(np->cond, sizeof(np->cond) / sizeof(*np->cond), type,
 131                   player->condarg);
 132     np->ncond = n >= 0 ? n : 0;
 133     return n >= 0;
 134 }
 135
 136 void
 137 snxtitem_area(struct nstr_item *np, int type, struct range *range)
 138 {
 139     memset(np, 0, sizeof(*np));
 140     np->cur = -1;
 141     np->type = type;
 142     np->sel = NS_AREA;
 143     np->index = -1;
 144     np->range = *range;
 145     xysize_range(&np->range);
 146 }
 147
 148 void
 149 snxtitem_dist(struct nstr_item *np, int type, int cx, int cy, int dist)
 150 {
 151     memset(np, 0, sizeof(*np));
 152     xydist_range(cx, cy, dist, &np->range);
 153     np->cur = -1;
 154     np->type = type;
 155     np->sel = NS_DIST;
 156     np->cx = cx;
 157     np->cy = cy;
 158     np->index = -1;
 159     np->dist = dist;
 160 }
 161
 162 void
 163 snxtitem_xy(struct nstr_item *np, int type, coord x, coord y)
 164 {
 165     memset(np, 0, sizeof(*np));
 166     np->cur = -1;
 167     np->type = type;
 168     np->sel = NS_XY;
 169     np->cx = xnorm(x);
 170     np->cy = ynorm(y);
 171     np->index = -1;
 172     np->dist = 0;
 173 }
 174
 175 void
 176 snxtitem_all(struct nstr_item *np, int type)
 177 {
 178     memset(np, 0, sizeof(*np));
 179     np->cur = -1;
 180     np->sel = NS_ALL;
 181     np->type = type;
 182     np->index = -1;
 183     xysize_range(&np->range);
 184 }
 185
 186 void
 187 snxtitem_group(struct nstr_item *np, int type, char group)
 188 {
 189     if (group == '~')
 190         group = 0;
 191     memset(np, 0, sizeof(*np));
 192     np->cur = -1;
 193     np->sel = NS_GROUP;
 194     np->group = group;
 195     np->type = type;
 196     np->index = -1;
 197     xysize_range(&np->range);
 198 }
 199
 200 void
 201 snxtitem_rewind(struct nstr_item *np)
 202 {
 203     np->cur = -1;
 204     np->index = -1;
 205 }
 206
 207 int
 208 snxtitem_list(struct nstr_item *np, int type, int *list, int len)
 209 {
 210     int i;
 211
 212     memset(np, 0, sizeof(*np));
 213     np->cur = -1;
 214     np->type = type;
 215     np->sel = NS_LIST;
 216     np->index = -1;
 217     if (len <= 0 || len > NS_LSIZE)
 218         return 0;
 219     for (i = 0; i < len; i++)
 220         np->list[i] = list[i];
 221     np->size = len;
 222     return 1;
 223 }
 224
 225 /*
 226  * Initialize NP to iterate over the items of type TYPE in a carrier.
 227  * The carrier has file type CARRIER_TYPE and uid CARRIER_UID.
 228  * Note: you can take an item gotten with nxtitem() off its carrier
 229  * without disturbing the iterator.  Whether the iterator will pick up
 230  * stuff you load onto the carrier during iteration is unspecified.
 231  */
 232 void
 233 snxtitem_cargo(struct nstr_item *np, int type,
 234                int carrier_type, int carrier_uid)
 235 {
 236     memset(np, 0, sizeof(*np));
 237     np->cur = -1;
 238     np->type = type;
 239     np->sel = NS_CARGO;
 240     np->next = unit_cargo_first(carrier_type, carrier_uid, type);
 241 }