[Home] [Downloads] [Search] [Help/forum]

GetCurrentValue

Script function

world.GetCurrentValue

Read about scripting

Type

Method

Summary

Gets the current value of a named world option

Prototype

VARIANT GetCurrentValue(BSTR OptionName);

View list of data type meanings

Description

Gets the current value of a MUSHclient <world> option, that is, the value it currently has.

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.


Available in MUSHclient version 3.23 onwards.



VBscript example

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


Jscript example

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


PerlScript example

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


Python example

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


Lua example

Note (GetCurrentValue ("port"))  
Note (GetCurrentValue ("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.


See Also ...

Topic

Option setting and retrieval

Functions

(GetAlphaOption) Gets the value of an alphanumeric configuration option
(GetAlphaOptionList) Gets the list of world alphanumeric options
(GetDefaultValue) Gets the default value of a named world option
(GetGlobalOption) Gets the value of a global configuration option
(GetGlobalOptionList) Gets the list of global options
(GetLoadedValue) Gets value of a named world option, as loaded from the world file
(GetOption) Gets value of a named world option
(GetOptionList) Gets the list of world options
(SetAlphaOption) Sets value of a named world alphanumeric option
(SetInputFont) Sets the font for the input window
(SetOption) Sets value of a named world option
(SetOutputFont) Sets the font for the output window.

(Help topic: function=GetCurrentValue)

Documentation contents page


Search ...

Enter a search string to find matching documentation.

Search for:   

Quick links: MUSHclient. MUSHclient help. Forum shortcuts. Posting templates. Lua modules. Lua documentation.

Information and images on this site are licensed under the Creative Commons Attribution 3.0 Australia License unless stated otherwise.

[Home]


Written by Nick Gammon - 5K   profile for Nick Gammon on Stack Exchange, a network of free, community-driven Q&A sites   Marriage equality

Comments to: Gammon Software support
[RH click to get RSS URL] Forum RSS feed ( https://gammon.com.au/rss/forum.xml )

[Best viewed with any browser - 2K]    [Hosted at FutureQuest]