world.GetLoadedValue

MUSHclient script function (Method) — introduced in version 3.23

Gets value of a named world option, as loaded from the world file

Prototype

VARIANT GetLoadedValue(BSTR OptionName);

Data type meanings

Description

Gets the value of a MUSHclient <world> option, as at the moment after the world was loaded from disk.

You can use GetOptionList, and GetAlphaOptionList, to get a list of the names of all possible options.

The return type is Variant, so the returned value will be the appropriate type for the data (ie. string or number (long)).

If the option name is not known, or is not allowed to be retrieved, a NULL variant is returned.

VBscript example

world.note world.GetLoadedValue ("port")  
world.note world.GetLoadedValue ("player")

Jscript example

world.note (world.GetLoadedValue ("port"));  
world.note (world.GetLoadedValue ("player"));

PerlScript example

$world->note ($world->GetLoadedValue ("port"));
$world->note ($world->GetLoadedValue ("player"));

Python example

world.note (world.GetLoadedValue ("port"))  
world.note (world.GetLoadedValue ("player"))

Lua example

Note (GetLoadedValue ("port"))  
Note (GetLoadedValue ("player"))

Return value

The value of the requested option, or a NULL variant if the option does not exist, or is not permitted to be read.

Related topic

Option setting and retrieval

See also