ldmud-3.3.719/
ldmud-3.3.719/doc/
ldmud-3.3.719/doc/efun.de/
ldmud-3.3.719/doc/efun/
ldmud-3.3.719/doc/man/
ldmud-3.3.719/doc/other/
ldmud-3.3.719/mud/
ldmud-3.3.719/mud/heaven7/
ldmud-3.3.719/mud/lp-245/
ldmud-3.3.719/mud/lp-245/banish/
ldmud-3.3.719/mud/lp-245/doc/
ldmud-3.3.719/mud/lp-245/doc/examples/
ldmud-3.3.719/mud/lp-245/doc/sefun/
ldmud-3.3.719/mud/lp-245/log/
ldmud-3.3.719/mud/lp-245/obj/Go/
ldmud-3.3.719/mud/lp-245/players/lars/
ldmud-3.3.719/mud/lp-245/room/death/
ldmud-3.3.719/mud/lp-245/room/maze1/
ldmud-3.3.719/mud/lp-245/room/sub/
ldmud-3.3.719/mud/lp-245/secure/
ldmud-3.3.719/mud/sticklib/
ldmud-3.3.719/mud/sticklib/src/
ldmud-3.3.719/mudlib/deprecated/
ldmud-3.3.719/mudlib/uni-crasher/
ldmud-3.3.719/pkg/
ldmud-3.3.719/pkg/debugger/
ldmud-3.3.719/pkg/diff/
ldmud-3.3.719/pkg/misc/
ldmud-3.3.719/src/
ldmud-3.3.719/src/autoconf/
ldmud-3.3.719/src/ptmalloc/
ldmud-3.3.719/src/util/
ldmud-3.3.719/src/util/erq/
ldmud-3.3.719/src/util/indent/hosts/next/
ldmud-3.3.719/src/util/xerq/
ldmud-3.3.719/src/util/xerq/lpc/
ldmud-3.3.719/src/util/xerq/lpc/www/
ldmud-3.3.719/test/generic/
ldmud-3.3.719/test/inc/
ldmud-3.3.719/test/t-0000398/
ldmud-3.3.719/test/t-0000548/
ldmud-3.3.719/test/t-030925/
ldmud-3.3.719/test/t-040413/
ldmud-3.3.719/test/t-041124/
ldmud-3.3.719/test/t-language/
PRELIMINARY
SYNOPSIS
        object present_clone(string str);
        object present_clone(string str, int n)
        object present_clone(string str, object env)
        object present_clone(string str, object env, int n)

        object present_clone(object obj);
        object present_clone(object obj, int n)
        object present_clone(object obj, object env)
        object present_clone(object obj, object env, int n)


DESCRIPTION
        This efun searches the inventory of object <env> (default is 
        this_object()) for an object with a specific blueprint.
        The blueprint can be specified either by name <str>, or as the same
        blueprint as of object <obj>. The matching criteria in both cases is
        the load_name().
        If <n> is given, the <n>th object in <env> is returned (if present),
        otherwise the first object matching <str> or <obj>.
        If no object in <env> matches the criteria, 0 is returned.

        For plain driver this name starts with a '/', for compat-mode
        drivers it doesn't.

EXAMPLES
        Assume that object 'env' contains the objects /obj/money#8,
        /std/weapon#9, /std/weapon#12 and /obj/key in the given order.

        +--------------------------------------------------+---------------+
        | Function call                                    | returns       |
        +--------------------------------------------------+---------------+
        | present_clone("/obj/money", env)                 | /obj/money#8  |
        | present_clone("/std/weapon#12", env)             | /std/weapon#9 |
        | present_clone(find_object("/obj/money#14"), env) | /obj/money#8  |
        | present_clone("/obj/key#18", env)                | /obj/key      |
        | present_clone("/std/weapon#12", env, 2)          | /std/weapon#12|
        | present_clone("/std/weapon#12", env, 3)          | 0             |
        +--------------------------------------------------+---------------+

        For compat-mode drivers, remove the leading '/' from the given
        names.

REMARKS
        Note that in contrast to present(), this efun never searches
        in the environment of <env>.

HISTORY
        Introduced in 3.2.7
        Searching for the <n>th object was added in 3.3.718.

SEE ALSO
        load_name(E), present(E)