Function Structure_Find

src/pool/structure.c:40–81

* Find the first matching Structure based on the PoolFindStruct filter data. * * @param find A pointer to a PoolFindStruct which contains filter data and * last known tried index. Calling this functions multiple times with the * same 'find' parameter walks over all possible values matching the filter. * @return The Structure, or NULL if nothing matches (anymore). */

 * @return The Structure, or NULL if nothing matches (anymore).
 */
Structure *Structure_Find(PoolFindStruct *find)
{
	if (find->index >= g_structureFindCount + 3 && find->index != 0xFFFF) return NULL;
	find->index++; /* First, we always go to the next index */

	assert(g_structureFindCount <= STRUCTURE_INDEX_MAX_SOFT);
	for (; find->index < g_structureFindCount + 3; find->index++) {
		Structure *s = NULL;

		if (find->index < g_structureFindCount) {
			s = g_structureFindArray[find->index];
		} else {
			/* There are 3 special structures that are never in the Find array */
			assert(find->index - g_structureFindCount < 3);
			switch (find->index - g_structureFindCount) {
				case 0:
					s = Structure_Get_ByIndex(STRUCTURE_INDEX_WALL);
					if (s->o.index != STRUCTURE_INDEX_WALL) continue;
					break;

				case 1:
					s = Structure_Get_ByIndex(STRUCTURE_INDEX_SLAB_2x2);
					if (s->o.index != STRUCTURE_INDEX_SLAB_2x2) continue;
					break;

				case 2:
					s = Structure_Get_ByIndex(STRUCTURE_INDEX_SLAB_1x1);
					if (s->o.index != STRUCTURE_INDEX_SLAB_1x1) continue;
					break;
			}
		}
		if (s == NULL) continue;

		if (s->o.flags.s.isNotOnMap && g_validateStrictIfZero == 0) continue;
		if (find->houseID != HOUSE_INVALID           && find->houseID != s->o.houseID) continue;
		if (find->type    != STRUCTURE_INDEX_INVALID && find->type    != s->o.type)  continue;

		return s;
	}

	return NULL;
}

/**
 * Initialize the Structure array.