Function iter_mons_safe

src/mon.c:4499–4522

Iterate all monsters on the level, even dead or off-map ones, calling bfunc() for each monster. If bfunc() returns TRUE, stop iterating. If the game ends during the call to bfunc(), then freedynamicdata() will free 'itermonarr'. Safe for list deletions and insertions, and guarantees calling bfunc() once per monster in fmon unless it returns TRUE (or game ends). */

   Safe for list deletions and insertions, and guarantees calling bfunc()
   once per monster in fmon unless it returns TRUE (or game ends). */
void
iter_mons_safe(boolean (*bfunc)(struct monst *))
{
    struct monst *mtmp;
    unsigned i, nmons;

    for (nmons = 0, mtmp = fmon; mtmp; mtmp = mtmp->nmon)
        nmons++;

    /* make sure itermonarr[] is big enough to hold nmons entries */
    alloc_itermonarr(nmons);

    if (nmons) {
        for (i = 0, mtmp = fmon; mtmp; mtmp = mtmp->nmon)
            itermonarr[i++] = mtmp;

        for (i = 0; i < nmons; i++) {
            mtmp = itermonarr[i];
            if ((*bfunc)(mtmp))
                break;
        }
    }
    return;
}


/* iterate all living monsters on current level, calling vfunc for each. */