%getEquippedItem()

Aliases%getEquippedItem( )
Parameterscharacter @entity, string @location

    Returns a pointer to the object worn in the position described by the wear
    name. If no object is equipped in that position then null is returned. If
    the given equipment location is invalid, then -1 is returned.  The
    character entity may be a mobile pointer or a mobile keyword. See the help
    for %isEquipmentLocation() for valid @location values.

    Example:

        @item = %getEquippedItem( @actor, @location );

        if( %isValid( @item ) )
        {
            //
            // move the item to their inventory.
            //
            %move( @item, @actor )
        }
        else
        if( @item === -1 )
        {
            %echoTo( "Please provide a valid equipment location.", @actor )
        }
        else
        {
            %echoTo( "You're not wearing anything there!", @actor )
        }
        endif

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.