efun: filter.de

SYNOPSIS:

        mixed *filter(mixed *arg, string func, string|object ob,
            mixed extra...);
        mixed *filter(mixed *arg, closure cl, mixed extra...);
        mixed *filter(mixed *arg, mapping map, mixed extra...);
        mapping filter(mapping arg, string func, string|object ob,
            mixed extra...);
        mapping filter(mapping arg, closure cl, mixed extra...);

BESCHREIBUNG:

        Ruft fuer jedes Element des Arrays oder Mappings <arg> die Funktion
        <ob>-><func>() bzw. die Closure <cl> auf und liefert jene Elemente,
        fuer die die Funktion / Closure TRUE ergeben hat. Die <extra>
        Argumente werden als zusaetzliche Parameter an die Funktion
        uebergeben und duerfen keine Referenzen von Array- oder Mapping-
        Elementen sein (wie &(i[1]) ).

        Wird <ob> nicht angegeben oder ist es weder ein String noch ein
        Objekt, wird standardmaessig this_object() verwendet.

        Ist <arg> ein Array, wird <fun> mit jedem Element des Arrays als
        ersten Parameter aufgerufen, gefolgt von den <extra> Argumenten.
        Wenn das Resultat der Funktion TRUE ergibt, wird das Element in das
        Ergebnis der filter() Operation mit einbezogen.

        Wird filter() mit einem Mapping <map> anstelle der Funktion <func>
        aufgerufen, wird jedes Element im Array <arg>, das ein Key von <map>
        ist, ins Ergebnis mit einbezogen.

        Wenn <arg> ein Mapping ist, wird die Funktion <func> mit jedem Key
        als erstem und (falls vorhanden) den Werten dieses Keys als restliche
        Parameter, gefolgt von den <extra> Argumenten, aufgerufen. Wenn die
        Funktion TRUE ergibt, wird das betreffende Element des Mappings ins
        Ergebnis aufgenommen.

        Abhaengig von der Groesse des Mappings <arg> erfolgt der Aufruf der
        Funktion auf drei unterschiedliche Arten:

            widthof(arg) == 0:  ob->func(key, 0, extra,...);
            widthof(arg) == 1:  ob->func(key, arg[key], extra, ...);
            widthof(arg) >1:    ob->fund(key, ({arg[key,0]...arg[key, n-1]}),
                                     extra, ...);

        Der Vorteil dieser Vorgehensweise ist, dass beide Typen von
        multidimensionalen Mappings (Mappings mit mehreren Werte pro Key und
        Mappings aus Arrays) gleich verarbeitet werden koennen.

AENDERUNGEN:

        Eingefuehrt in LDMud 3.2.6. Die Funktion loest filter_array() ab.

ANMERKUNG:

        Fuer Arrays wirkt filter() wie filter_array(), fuer Mappings stellt
        filter() eine Verallgemeinerung von filter_indices() dar.

SIEHE AUCH:

        filter(E), filter_indices(E), map(E), walk_mapping(E), member(E),
        m_contains(E)