Table of Contents

# $EPIC: levelctl.txt,v 1.3 2007/02/17 18:41:08 jnelson Exp $

Synopsis:

$levelctl(LEVELS)
$levelctl(ADD name)
$levelctl(ALIAS old-name new-name)
$levelctl(LOOKUP name)
$levelctl(LOOKUP number)
$levelctl(NORMALIZE levels)

Description:

The levelctl function allows you to add and look up levels for the client.

The following operations are supported:

Operation name Operation function
LEVELS Return a word list of the canonical names for all levels
ADD name Create a new level bit, and give it the canonical name name.
ALIAS old-name new-name Create a synonym (non-canonical name) for an existing level. The new-name will be accepted in every place as a replacement for old-name. This is suitable for translating level names.
LOOKUP name Return the refnum of the level of the given name. This number is only valid until the client exits.
LOOKUP number Return the canonical name of the numberth level. This is useful in a loop to get each level name in order.
NORMALIZE level-description Convert a string containing level descriptions, of the sort “ALL,-OTHER” into the canonical form “PUBLICS,MSGS,NOTICES,WALLS,….”

History:

The $levelctl() function first appeared in EPIC5-0.0.8.