Register forum user name Search FAQ

MUSHclient scripting

Description of MUSHclient world function: world.ArrayListValues


Name ArrayListValues
Type Method
Summary Gets the list of all the values in an array
Prototype VARIANT ArrayListValues(BSTR Name);
Description

Returns an array of all the values in the nominated array. That is, the values for each entry but not the keys.

You can also use ArrayListKeys if you want to find the keys instead.


Note: Available in version 3.46 onwards.


VBscript example
dim valList

valList = ArrayListValues ("spells")

If Not IsEmpty (valList) Then
  
  For Each v In valList 
    world.note v 
  Next

End If
Lua example
for k, v in pairs (ArrayListValues ("spells")) do 
  Note (v) 
end

-- alternative - show keys and values:

table.foreach (ArrayList ("spells"), print)

-- show a particular value:

spells = ArrayList ("spells")
print (spells.dragonskin)
Lua notes
If the array does not exist, or is empty, Lua returns nil.

There is an extension for Lua only - ArrayList - which returns both keys and values.

See above example. The key of the table is the array key, the value is the array value.
Returns If there are no elements in the nominated array then the return value is empty. Use "IsEmpty" to test for this possibility.

Otherwise, it returns a variant array containing all of the values in this array.

Use "lbound" and "ubound" to find the bounds of the array of values (ie. the number of values in the list).
Introduced in version 3.46

See also ...

Function Description
ArrayExport Exports values from an array into a single string
ArrayExportKeys Exports keys from an array into a single string
ArrayGet Gets the value of an array item
ArrayListKeys Gets the list of all the keys in an array
ArraySet Sets the value of an array item

Search for script function

Enter a word or phrase in the box below to narrow the list down to those that match.

The function name, prototype, summary, and description are searched.

Search for:   

Leave blank to show all functions.


Return codes

Many functions return a "code" which indicates the success or otherwise of the function.

You can view a list of the return codes


Function prototypes

The "prototype" part of each function description lists exactly how the function is called (what arguments, if any, to pass to it).

You can view a list of the data types used in function prototypes


View all functions

[Back]

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