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

GetAliasWildcard

Script function

world.GetAliasWildcard

Read about scripting

Type

Method

Summary

Returns the contents of the specified wildcard for the named alias

Prototype

VARIANT GetAliasWildcard(BSTR AliasName, BSTR WildcardName);

View list of data type meanings

Description

Once a alias has matched you can extract any of the wildcards for that alias using this function.

The wildcards can be specified by name or number (if by number pass a string which is the appropriate number).

You can set up a named wildcard like this:

Match: Tell (?P<who>.*?) (?P<what>.*)

In this case we have 2 wildcards, named "who" and "what".

Now we can extract wildcards like this:

x = GetAliasWildcard ("myalias", "who") ' get wildcard named 'who'
x = GetAliasWildcard ("myalias", "what") ' get wildcard named 'what'
x = GetAliasWildcard ("myalias", "22") ' get wildcard 22 (if it exists)

You can have up to 999 wildcards, plus wildcard 0 which represents the entire matching string.

You can use GetAliasInfo selector 24 to find how many wildcards matched.

Each wildcard will have a number and may optionally have a name.


Available in MUSHclient version 3.48 onwards.



VBscript example

dim x

x = GetAliasWildcard ("myalias", "who")  ' get wildcard named 'who'
x = GetAliasWildcard ("myalias", "what") ' get wildcard named 'what'
x = GetAliasWildcard ("myalias", "22")   ' get wildcard 22 (if it exists)


Lua example

local x

x = GetAliasWildcard ("myalias", "who")  -- get wildcard named 'who'
x = GetAliasWildcard ("myalias", "what") -- get wildcard named 'what'
x = GetAliasWildcard ("myalias", "22")   -- get wildcard 22 (if it exists)


Lua notes

Inside an alias script function you can access named wildcards by simply putting the name after the wildcards argument. eg.

function myAliasFunction (name, line, wildcards)
  Note (wildcards.who)  --> access named wildcards "who"
end


Return value

The contents of the specified alias wildcard, as described above.

An EMPTY variant, if the alias does not exist.

A NULL variant if the alias name is invalid.

An empty string if the wildcard does not exist. An empty string is the string "", this is different from an EMPTY variant.


See Also ...

Topics

Aliases
Auto-mapper
Default triggers/aliases/timers/macros/colours
Getting started
Groups
Keypad navigation
Macro keys
Plugins
Regular Expressions
Speed walking
Timers
Triggers

Functions

(AddAlias) Adds an alias
(DeleteAlias) Deletes an alias
(DeleteAliasGroup) Deletes a group of aliases
(DeleteTemporaryAliases) Deletes all temporary aliases
(EnableAlias) Enables or disables an alias
(EnableAliasGroup) Enables/disables a group of aliases
(GetAlias) Gets details about an alias
(GetAliasInfo) Gets details about an alias
(GetAliasList) Gets the list of aliases
(GetAliasOption) Gets the value of a named alias option
(GetPluginAliasInfo) Gets details about a named alias for a specified plugin
(GetPluginAliasList) Gets the list of aliases in a specified plugin
(GetPluginAliasOption) Gets the value of a named alias option for a specified plugin
(IsAlias) Tests to see if an alias exists
(SetAliasOption) Sets the value of a named alias option

(Help topic: function=GetAliasWildcard)

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]