world.DeleteGroup

MUSHclient script function (Method) — introduced in version 3.29

Deletes a group of triggers, aliases and timers

Prototype

long DeleteGroup(BSTR GroupName);

Data type meanings

Description

Triggers, aliases and timers can be placed in "groups" where a group is a bunch of related items. Groups have names, there is no restriction on the name of a group. Ungrouped items have blank (empty) names.

To delete an entire group of triggers, aliases and timers do this:

world.DeleteGroup "groupname"

For debugging purposes the function returns a count of the number of members deleted. eg.

dim mycount
mycount = world.DeleteGroup ("groupname")

If you are using plugins only the members of the current plugin (if any) are deleted. If the call is made outside a plugin only the members of the group that are not in a plugin are deleted.

VBscript example

world.DeleteGroup "groupname"

Jscript example

world.DeleteGroup ("groupname");

PerlScript example

$world->DeleteGroup ("groupname");

Python example

world.DeleteGroup ("groupname")

Lua example

DeleteGroup ("groupname")

Return value

A count of the number of items deleted.

Related topic

Groups

See also

FunctionDescription
DeleteAliasGroupDeletes a group of aliases
DeleteTimerGroupDeletes a group of timers
DeleteTriggerGroupDeletes a group of triggers
EnableAliasGroupEnables/disables a group of aliases
EnableGroupEnables/disables a group of triggers, aliases and timers
EnableTimerGroupEnables/disables a group of timers
EnableTriggerGroupEnables/disables a group of triggers
GetAliasInfoGets details about an alias
GetTimerInfoGets details about a timer
GetTriggerInfoGets details about a named trigger