%filterKeyword()

Aliases%filterKeyword( )
Parametersarray @entities, string @keyword

    An extremely powerful function for filtering targets from the given
    entities parameter. Depending on the keyword there are several possible
    outcomes which mimic the MUD's own internal routines for targetting. The
    keyword may use any of the following formats:

        keyword     - explicit keyword, all matches returned
        x.keyword   - indexed keyword, 0 or 1 matches returned
        x*keyword   - limitted keyword, at most x matches returned
        keyw/       - substring match, all matches returned
        x.keyw/     - indexed substring match, 0 or 1 matches returned
        x*keyw/     - limitted substring keyword, at most x matches returned

    Example:

        @targets = %arrayMergeValues( %roomGetItems(), %roomGetMobs() )

        //
        // Example 1, explicit match
        //
        @realTargets = %filterKeyword( @targets, "troll" )

        //
        // Example 2, substring match.
        //
        @realTargets = %filterKeyword( @targets, "trol/" )

        //
        // Example 3, indexed match.
        //
        @realTargets = %filterKeyword( @targets, "3.troll" )

        //
        // Example 4, limitted sibstring match.
        //
        @realTargets = %filterKeyword( @targets, "3*trol/" )

        //
        // Example 5, Quan's light bulb.
        //
        @realTargets = %filterKeyword( @targets, @argument )

The Worlds of Carnage MUD is a non-profit, fantasy oriented, text-based game that is played over telnet. We are devoted to providing a social medium in which people can have fun while immersing themselves in a game that reads like a book. You can connect by clicking here or if that fails then here. This site is maintained and hosted by Robert Cummings, A.K.A Blobule. The Worlds of Carnage are often recognized via the following aliases: Carnage; WoC; WoC MUD; Carnage MUD; CarnageMUD; WoCMUD. All submissions become the property of Robert Cummings where the submitter holds copyright. If you do not want to give ownership, then do not submit.