MongooseA text-based world full of questionable inventions.

All help topics · Link to this topic

Showing help on 'verb_info()'

Syntax: verb_info (OBJ <object>, STR|INT <verb-name>) => LIST
set_verb_info (OBJ <object>, STR|INT <verb-name>, LIST <info>) => none

BE AWARE: verb-name can be the string name of the verb OR the index from verbs()

These two functions get and set (respectively) the owner, permission bits, and name(s) for the verb named <verb-name> on the given <object>. If <object> is not valid, then E_INVARG is raised. If <object> does not define a verb named <verb-name>, then E_VERBNF is raised. If the programmer does not have read (write) permission on the verb in question, then `verb_info()' (`set_verb_info()') raises E_PERM. Verb info has the following form:

{<owner>, <perms>, <names>}

where <owner> is an object, <perms> is a string containing only characters from the set `r', `w', `x', and `d', and <names> is a string. This is the kind of value returned by `verb_info()' and expected as the third argument to `set_verb_info()'. The latter function raises E_INVARG if <owner> is not valid, if <perms> contains any illegal characters, or if <names> is the empty string or consists entirely of spaces; it raises E_PERM if <owner> is not the programmer and the programmer is not a wizard.