2 * Empire - A multi-player, client/server Internet based war game.
3 * Copyright (C) 1986-2015, Dave Pare, Jeff Bailey, Thomas Ruschak,
4 * Ken Stevens, Steve McClure, Markus Armbruster
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.
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.
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/>.
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.
27 * snxtitem.c: Arrange item selection using one of many criteria.
29 * Known contributors to this file:
31 * Markus Armbruster, 2009-2011
42 #include "prototypes.h"
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()
55 snxtitem(struct nstr_item *np, int type, char *str, char *prompt)
70 sprintf(promptbuf, "%s(s)? ", ef_nameof(type));
73 str = getstring(prompt, buf);
77 make_stale_if_command_arg(str);
81 if (type == EF_NATION && isalpha(*str)) {
82 cnum = natarg(str, NULL);
85 sprintf(buf, "%d", cnum);
88 flags = ef_flags(type);
89 switch (sarg_type(str)) {
91 if (!(flags & EFF_XY))
93 if (!sarg_area(str, &range))
95 snxtitem_area(np, type, &range);
98 if (!(flags & EFF_XY))
100 if (!sarg_range(str, &cx, &cy, &dist))
102 snxtitem_dist(np, type, cx, cy, dist);
105 snxtitem_all(np, type);
108 if ((n = sarg_list(str, list, NS_LSIZE)) == 0)
110 if (!snxtitem_list(np, type, list, n))
114 if (!(flags & EFF_XY))
116 if (!sarg_xy(str, &cx, &cy))
118 snxtitem_xy(np, type, cx, cy);
121 if (!(flags & EFF_GROUP))
123 snxtitem_group(np, type, *str);
128 return snxtitem_use_condarg(np);
132 snxtitem_area(struct nstr_item *np, int type, struct range *range)
134 memset(np, 0, sizeof(*np));
140 xysize_range(&np->range);
144 snxtitem_dist(struct nstr_item *np, int type, int cx, int cy, int dist)
146 memset(np, 0, sizeof(*np));
147 xydist_range(cx, cy, dist, &np->range);
158 snxtitem_xy(struct nstr_item *np, int type, coord x, coord y)
160 memset(np, 0, sizeof(*np));
171 snxtitem_all(struct nstr_item *np, int type)
173 memset(np, 0, sizeof(*np));
178 xysize_range(&np->range);
182 snxtitem_group(struct nstr_item *np, int type, char group)
186 memset(np, 0, sizeof(*np));
192 xysize_range(&np->range);
196 snxtitem_rewind(struct nstr_item *np)
203 snxtitem_list(struct nstr_item *np, int type, int *list, int len)
207 memset(np, 0, sizeof(*np));
212 if (len <= 0 || len > NS_LSIZE)
214 for (i = 0; i < len; i++)
215 np->list[i] = list[i];
221 * Initialize NP to iterate over the items of type TYPE in a carrier.
222 * The carrier has file type CARRIER_TYPE and uid CARRIER_UID.
223 * Note: you can take an item gotten with nxtitem() off its carrier
224 * without disturbing the iterator. Whether the iterator will pick up
225 * stuff you load onto the carrier during iteration is unspecified.
228 snxtitem_cargo(struct nstr_item *np, int type,
229 int carrier_type, int carrier_uid)
231 memset(np, 0, sizeof(*np));
235 np->next = unit_cargo_first(carrier_type, carrier_uid, type);
239 snxtitem_use_condarg(struct nstr_item *np)
243 if (!player->condarg)
245 n = nstr_comp(np->cond, sizeof(np->cond) / sizeof(*np->cond),
246 np->type, player->condarg);