mux/src/match.h File Reference

#include "copyright.h"

Include dependency graph for match.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	match_state
Defines
#define	MAT_NO_EXITS   1
#define	MAT_EXIT_PARENTS   2
#define	MAT_NUMERIC   4
#define	MAT_HOME   8
Typedefs
typedef match_state	MSTATE
Functions
void	init_match (dbref, const char *, int)
void	init_match_check_keys (dbref, const char *, int)
void	match_player (void)
void	match_absolute (void)
void	match_me (void)
void	match_here (void)
void	match_possession (void)
void	match_neighbor (void)
void	match_exit (void)
void	match_exit_with_parents (void)
void	match_carried_exit (void)
void	match_carried_exit_with_parents (void)
void	match_master_exit (void)
void	match_everything (int)
dbref	match_result (void)
dbref	last_match_result (void)
dbref	match_status (dbref, dbref)
dbref	noisy_match_result (void)
void	save_match_state (MSTATE *)
void	restore_match_state (MSTATE *)
void	match_zone_exit (void)
dbref	match_thing (dbref player, char *name)
dbref	match_thing_quiet (dbref player, char *name)
void	safe_match_result (dbref it, char *buff, char **bufc)

---

Define Documentation

#define MAT_EXIT_PARENTS   2

Definition at line 58 of file match.h.

Referenced by do_decomp(), do_entrances(), do_examine(), do_lock(), do_setattr(), do_verb(), FUNCTION(), match_controlled_handler(), match_everything(), match_thing(), match_thing_quiet(), parse_attrib_wild(), parse_boolexp_L(), and parse_thing_slash().

#define MAT_HOME   8

Definition at line 60 of file match.h.

Referenced by match_everything(), and parse_linkable_room().

#define MAT_NO_EXITS   1

Definition at line 57 of file match.h.

Referenced by do_link(), match_everything(), and parse_linkable_room().

#define MAT_NUMERIC   4

Definition at line 59 of file match.h.

Referenced by match_everything(), and parse_linkable_room().

---

Typedef Documentation

typedef struct match_state MSTATE

Definition at line 11 of file match.h.

---

Function Documentation

void init_match	(	dbref	,
		const char *	,
		int
	)

Definition at line 603 of file match.cpp.

References match_state::absolute_form, absolute_name(), match_state::check_keys, match_state::confidence, match_state::count, match_state::match, md, munge_space_for_match(), NOTHING, match_state::player, match_state::pref_type, and match_state::string.

Referenced by do_boot(), do_chopen(), do_chown(), do_chownall(), do_chzone(), do_clone(), do_decomp(), do_destroy(), do_drop(), do_enter(), do_entrances(), do_examine(), do_fixdb(), do_give(), do_kill(), do_link(), do_lock(), do_look(), do_mail_debug(), do_mail_stats(), do_notify(), do_parent(), do_pemit_single(), do_setattr(), do_teleport(), do_teleport_single(), do_toad(), do_unlink(), do_use(), do_verb(), do_wait(), FUNCTION(), give_thing(), init_match_check_keys(), match_controlled_handler(), match_possessed(), match_thing(), match_thing_quiet(), parse_attrib_wild(), parse_boolexp_L(), parse_linkable_room(), and parse_thing_slash().

{
    md.confidence = -1;
    md.count = 0;
    md.check_keys = false;
    md.pref_type = type;
    md.match = NOTHING;
    md.player = player;
    md.string = munge_space_for_match((char *)name);
    md.absolute_form = absolute_name(true);
}

void init_match_check_keys	(	dbref	,
		const char *	,
		int
	)

Definition at line 615 of file match.cpp.

References match_state::check_keys, init_match(), and md.

Referenced by do_get(), do_move(), FUNCTION(), and process_command().

{
    init_match(player, name, type);
    md.check_keys = true;
}

dbref last_match_result

(

void

)

Definition at line 548 of file match.cpp.

References match_state::match, and md.

Referenced by do_destroy(), FUNCTION(), and process_command().

{
    return md.match;
}

void match_absolute

(

void

)

Definition at line 202 of file match.cpp.

References match_state::absolute_form, CON_DBREF, match_state::confidence, Good_obj, md, and promote_match().

Referenced by do_boot(), do_chown(), do_chownall(), do_enter(), do_get(), do_give(), do_kill(), do_look(), do_mail_debug(), do_mail_stats(), do_toad(), do_use(), FUNCTION(), and match_everything().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (Good_obj(md.absolute_form))
    {
        promote_match(md.absolute_form, CON_DBREF);
    }
}

void match_carried_exit

(

void

)

Definition at line 429 of file match.cpp.

References CON_DBREF, CON_LOCAL, match_state::confidence, Good_obj, Has_exits, match_exit_internal(), md, and match_state::player.

Referenced by do_drop(), and match_everything().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.player)
       && Has_exits(md.player))
    {
        (void)match_exit_internal(md.player, md.player, CON_LOCAL);
    }
}

void match_carried_exit_with_parents

(

void

)

Definition at line 442 of file match.cpp.

References CON_DBREF, CON_LOCAL, match_state::confidence, Good_obj, Has_exits, ITER_PARENTS, match_exit_internal(), md, and match_state::player.

Referenced by FUNCTION(), and match_everything().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.player)
       && Has_exits(md.player))
    {
        dbref parent;
        int lev;
        ITER_PARENTS(md.player, parent, lev)
        {
            if (match_exit_internal(parent, md.player, CON_LOCAL))
            {
                break;
            }
        }
    }
}

void match_everything

(

int

)

Definition at line 489 of file match.cpp.

References CON_TOKEN, match_state::confidence, MAT_EXIT_PARENTS, MAT_HOME, MAT_NO_EXITS, MAT_NUMERIC, match_absolute(), match_carried_exit(), match_carried_exit_with_parents(), match_exit(), match_exit_with_parents(), match_here(), match_home(), match_me(), match_neighbor(), match_numeric(), match_player(), match_possession(), and md.

Referenced by do_chopen(), do_chzone(), do_clone(), do_decomp(), do_entrances(), do_examine(), do_fixdb(), do_link(), do_lock(), do_notify(), do_parent(), do_pemit_single(), do_setattr(), do_teleport(), do_teleport_single(), do_unlink(), do_verb(), do_wait(), FUNCTION(), match_controlled_handler(), match_thing(), match_thing_quiet(), parse_attrib_wild(), parse_boolexp_L(), parse_linkable_room(), and parse_thing_slash().

{
    /*
     * Try matching me, then here, then absolute, then player FIRST, since
     * this will hit most cases. STOP if we get something, since those are
     * exact matches.
     */

    match_me();
    match_here();
    match_absolute();
    if (key & MAT_NUMERIC)
    {
        match_numeric();
    }
    if (key & MAT_HOME)
    {
        match_home();
    }
    match_player();
    if (md.confidence >= CON_TOKEN)
    {
        return;
    }

    if (!(key & MAT_NO_EXITS))
    {
        if (key & MAT_EXIT_PARENTS)
        {
            match_carried_exit_with_parents();
            match_exit_with_parents();
        }
        else
        {
            match_carried_exit();
            match_exit();
        }
    }
    match_neighbor();
    match_possession();
}

void match_exit

(

void

)

Definition at line 392 of file match.cpp.

References CON_DBREF, CON_LOCAL, match_state::confidence, Good_obj, Has_location, Location, match_exit_internal(), md, and match_state::player.

Referenced by do_chown(), do_destroy(), do_get(), do_move(), and match_everything().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }

    dbref loc = Location(md.player);
    if (  Good_obj(md.player)
       && Has_location(md.player))
    {
        (void)match_exit_internal(loc, loc, CON_LOCAL);
    }
}

void match_exit_with_parents

(

void

)

Definition at line 407 of file match.cpp.

References CON_DBREF, CON_LOCAL, match_state::confidence, Good_obj, Has_location, ITER_PARENTS, Location, match_exit_internal(), md, and match_state::player.

Referenced by do_look(), FUNCTION(), match_everything(), and process_command().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.player)
       && Has_location(md.player))
    {
        dbref parent;
        int lev;
        dbref loc = Location(md.player);
        ITER_PARENTS(loc, parent, lev)
        {
            if (match_exit_internal(parent, loc, CON_LOCAL))
            {
                break;
            }
        }
    }
}

void match_here

(

void

)

Definition at line 259 of file match.cpp.

References match_state::absolute_form, CON_COMPLETE, CON_DBREF, CON_LOCAL, CON_TOKEN, match_state::confidence, Good_obj, Has_location, Location, md, match_state::player, promote_match(), PureName(), match_state::string, and string_compare().

Referenced by do_chown(), do_kill(), do_look(), do_use(), FUNCTION(), and match_everything().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.player)
       && Has_location(md.player))
    {
        dbref loc = Location(md.player);
        if (Good_obj(loc))
        {
            if (loc == md.absolute_form)
            {
                promote_match(loc, CON_DBREF | CON_LOCAL);
            }
            else if (!string_compare(md.string, "here"))
            {
                promote_match(loc, CON_TOKEN | CON_LOCAL);
            }
            else if (!string_compare(md.string, PureName(loc)))
            {
                promote_match(loc, CON_COMPLETE | CON_LOCAL);
            }
        }
    }
}

void match_master_exit

(

void

)

Definition at line 463 of file match.cpp.

References CON_DBREF, match_state::confidence, Good_obj, Has_exits, confdata::master_room, match_exit_internal(), md, mudconf, and match_state::player.

Referenced by do_look(), and process_command().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.player)
       && Has_exits(md.player))
    {
        (void)match_exit_internal(mudconf.master_room, mudconf.master_room, 0);
    }
}

void match_me

(

void

)

Definition at line 227 of file match.cpp.

References match_state::absolute_form, CON_DBREF, CON_LOCAL, CON_TOKEN, match_state::confidence, Good_obj, md, match_state::player, promote_match(), match_state::string, and string_compare().

Referenced by do_chown(), do_give(), do_kill(), do_look(), do_use(), FUNCTION(), give_thing(), and match_everything().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.absolute_form)
       && md.absolute_form == md.player)
    {
        promote_match(md.player, CON_DBREF | CON_LOCAL);
        return;
    }
    if (!string_compare(md.string, "me"))
    {
        promote_match(md.player, CON_TOKEN | CON_LOCAL);
    }
    return;
}

void match_neighbor

(

void

)

Definition at line 331 of file match.cpp.

References CON_DBREF, CON_LOCAL, match_state::confidence, Contents, Good_obj, Has_location, Location, match_list(), md, and match_state::player.

Referenced by do_boot(), do_chownall(), do_enter(), do_get(), do_give(), do_kill(), do_look(), do_toad(), do_use(), FUNCTION(), match_everything(), and match_possessed().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.player)
       && Has_location(md.player))
    {
        dbref loc = Location(md.player);
        if (Good_obj(loc))
        {
            match_list(Contents(loc), CON_LOCAL);
        }
    }
}

void match_player

(

void

)

Definition at line 151 of file match.cpp.

References match_state::absolute_form, CON_DBREF, CON_TOKEN, match_state::confidence, Good_obj, isPlayer, lookup_player(), LOOKUP_TOKEN, match(), md, mux_isspace, NOTHING, promote_match(), and match_state::string.

Referenced by do_boot(), do_chown(), do_chownall(), do_give(), do_kill(), do_look(), do_toad(), do_use(), FUNCTION(), and match_everything().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (Good_obj(md.absolute_form) && isPlayer(md.absolute_form))
    {
        promote_match(md.absolute_form, CON_DBREF);
        return;
    }
    if (*md.string == LOOKUP_TOKEN)
    {
        char *p;
        for (p = md.string + 1; mux_isspace(*p); p++)
        {
            ; // Nothing.
        }
        dbref match = lookup_player(NOTHING, p, true);
        if (Good_obj(match))
        {
            promote_match(match, CON_TOKEN);
        }
    }
}

void match_possession

(

void

)

Definition at line 319 of file match.cpp.

References CON_DBREF, CON_LOCAL, match_state::confidence, Contents, Good_obj, Has_contents, match_list(), md, and match_state::player.

Referenced by do_chown(), do_destroy(), do_drop(), do_give(), do_look(), do_use(), FUNCTION(), give_thing(), match_everything(), and match_possessed().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (Good_obj(md.player) && Has_contents(md.player))
    {
        match_list(Contents(md.player), CON_LOCAL);
    }
}

dbref match_result

(

void

)

Definition at line 531 of file match.cpp.

References AMBIGUOUS, match_state::count, match_state::match, md, and NOTHING.

Referenced by do_chopen(), do_chown(), do_drop(), do_get(), do_give(), do_kill(), do_lock(), do_look(), do_mail_debug(), do_mail_stats(), do_move(), do_pemit_single(), do_teleport_single(), do_unlink(), FUNCTION(), give_thing(), match_controlled_handler(), match_possessed(), match_thing_quiet(), noisy_match_result(), parse_attrib_wild(), parse_boolexp_L(), parse_linkable_room(), and parse_thing_slash().

{
    switch (md.count)
    {
    case 0:
        return NOTHING;

    case 1:
        return md.match;

    default:
        return AMBIGUOUS;
    }
}

dbref match_status	(	dbref	,
		dbref
	)

Definition at line 553 of file match.cpp.

References AMBIGUOUS, AMBIGUOUS_MESSAGE, NOMATCH_MESSAGE, NOPERM, NOPERM_MESSAGE, NOTHING, and notify.

Referenced by do_destroy(), do_get(), do_look(), FUNCTION(), and noisy_match_result().

{
    switch (match)
    {
    case NOTHING:
        notify(player, NOMATCH_MESSAGE);
        return NOTHING;

    case AMBIGUOUS:
        notify(player, AMBIGUOUS_MESSAGE);
        return NOTHING;

    case NOPERM:
        notify(player, NOPERM_MESSAGE);
        return NOTHING;
    }
    return match;
}

dbref match_thing	(	dbref	player,
		char *	name
	)

Definition at line 621 of file match.cpp.

References init_match(), MAT_EXIT_PARENTS, match_everything(), noisy_match_result(), and NOTYPE.

Referenced by do_chboot(), do_halt(), do_moniker(), do_prog(), do_quitprog(), and FUNCTION().

{
    init_match(player, name, NOTYPE);
    match_everything(MAT_EXIT_PARENTS);
    return noisy_match_result();
}

dbref match_thing_quiet	(	dbref	player,
		char *	name
	)

Definition at line 628 of file match.cpp.

References init_match(), MAT_EXIT_PARENTS, match_everything(), match_result(), and NOTYPE.

Referenced by do_icmd(), FUNCTION(), get_obj_and_lock(), grep_handler(), handle_flaglists(), hasattr_handler(), internalPlayerFind(), process_sex(), and scan_zone().

{
    init_match(player, name, NOTYPE);
    match_everything(MAT_EXIT_PARENTS);
    return match_result();
}

void match_zone_exit

(

void

)

Definition at line 476 of file match.cpp.

References CON_DBREF, match_state::confidence, Good_obj, Has_exits, match_exit_internal(), md, match_state::player, and Zone.

Referenced by process_command().

{
    if (md.confidence >= CON_DBREF)
    {
        return;
    }
    if (  Good_obj(md.player)
       && Has_exits(md.player))
    {
        (void)match_exit_internal(Zone(md.player), Zone(md.player), 0);
    }
}

dbref noisy_match_result

(

void

)

Definition at line 572 of file match.cpp.

References match_result(), match_status(), md, and match_state::player.

Referenced by do_boot(), do_chownall(), do_chzone(), do_clone(), do_decomp(), do_enter(), do_entrances(), do_examine(), do_fixdb(), do_link(), do_notify(), do_parent(), do_setattr(), do_teleport(), do_toad(), do_use(), do_verb(), do_wait(), FUNCTION(), match_controlled_handler(), and match_thing().

{
    return match_status(md.player, match_result());
}

void restore_match_state

(

MSTATE *

)

Definition at line 590 of file match.cpp.

References match_state::absolute_form, match_state::check_keys, match_state::confidence, match_state::count, free_lbuf, match_state::match, md, match_state::player, match_state::pref_type, and match_state::string.

Referenced by parse_boolexp_L(), and promote_match().

{
    md.confidence = mstate->confidence;
    md.count = mstate->count;
    md.pref_type = mstate->pref_type;
    md.check_keys = mstate->check_keys;
    md.absolute_form = mstate->absolute_form;
    md.match = mstate->match;
    md.player = mstate->player;
    strcpy(md.string, mstate->string);
    free_lbuf(mstate->string);
}

void safe_match_result	(	dbref	it,
		char *	buff,
		char **	bufc
	)

Definition at line 635 of file match.cpp.

References AMBIGUOUS, safe_ambiguous, and safe_notfound.

Referenced by FUNCTION(), get_obj_and_lock(), grep_handler(), hasattr_handler(), internalPlayerFind(), process_sex(), and scan_zone().

{
    if (it == AMBIGUOUS)
    {
        safe_ambiguous(buff, bufc);
    }
    else
    {
        safe_notfound(buff, bufc);
    }
}

void save_match_state

(

MSTATE *

)

Definition at line 577 of file match.cpp.

References match_state::absolute_form, alloc_lbuf, match_state::check_keys, match_state::confidence, match_state::count, match_state::match, md, match_state::player, match_state::pref_type, and match_state::string.

Referenced by parse_boolexp_L(), and promote_match().

{
    mstate->confidence = md.confidence;
    mstate->count = md.count;
    mstate->pref_type = md.pref_type;
    mstate->check_keys = md.check_keys;
    mstate->absolute_form = md.absolute_form;
    mstate->match = md.match;
    mstate->player = md.player;
    mstate->string = alloc_lbuf("save_match_state");
    strcpy(mstate->string, md.string);
}

---