%getMobPointer()

Aliases%getMobPointer( ), %getMobPtr( )
Parametersmixed @entity

    Returns a mobile pointer for the given entity parameter or null on
    failure. If @entity is set to a mobile pointer then it is checked for
    validity and returned if valid. Alternatively if @entity is set to an
    integer value then the first NPC mobile in the game having a vnum of that
    value is returned. Finally if @entity contains one or more keywords then a
    pointer to the first mobile (PC or NPC) matching the keywords is returned.

    It is strongly advised that if you use the keyword approach that you use a
    keyword that is very unlikely to be used by any other mobile. For instance
    setting @entity to "thief" will more than likely cause your script to
    break at some point since the most recently loaded mobile to have "thief"
    as a keyword will be returned.

    The %getNpcPointer() and %getPcPointer() functions are better alternatives
    to this function since generally you don't want an arbitrary pointer than
    can be either a PC or NPC.

    Examples:
    
        @mob = %getMobPointer( @keyword )

        @mob = %getMobPointer( 101090 )

        @mob = %getMobPointer( "greedy_the_giant" )

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.