ApiMem().GroupDeleteExcept

Deletes any Groups from memory not specified.

Description

SILVIA is able to dynamically remove entire named Groups of Behaviors from memory. This function provides direct access to that capability. As with the “groupDelete” function, if passing in more than one Group via the “groups” parameter, the names must be separated by the “|” character. However, unlike the “groupDelete” function, this function performs an inverted deletion. Any named Group NOT specified by the input to this function is removed from memory, and once deleted, can NOT then be used (invoked) by the SILVIA runtime engine unless they are re-loaded from a file, or are re-created via some other method.

Groups to be protected from deletion can be specified using wildcards. For instance, by passing “movies” to the function, all Groups containing the substring “movies” will remain in memory while all other Groups will be removed from memory. The protected Groups would include “movies”, “movies_scifi”, or “old_movies”.

Example Usage (C#)


//Deleting all Behavior Groups in memory except “os”, “basic”, and “silvia”
bool success = _core.ApiMem().GroupDeleteExcept(“os|basic|silvia”);

Parameters

string groups The string containing the “|” separated (Pipe-separated) list of all
Behavior Groups to be protected from deletion.

Returns

The boolean success or failure of the operation.

See Also

  • ApiMem().GroupDelete