HTML Utilities

Showing help on 'set_property_info()'

Syntax: property_info (OBJ <object>, STR <prop-name>) => LIST
set_property_info (OBJ <object>, STR <prop-name>, LIST <info>) => none

These two functions get and set (respectively) the owner and permission bits for the property named <prop-name> on the given <object>. If <object> is not valid, then E_INVARG is raised. If <object> has no non-built-in property named <prop-name>, then E_PROPNF is raised. If the programmer does not have read (write) permission on the property in question, then `property_info()' (`set_property_info()') raises E_PERM. Property info has the following form:

{<owner>, <perms> [, new-name]}

where <owner> is an object and <perms> is a string containing only characters from the set `r', `w', and `c', and <new-name> is a string; <new-name> is never part of the value returned by `property_info()', but it may optionally be given as part of the value provided to `set_property_info()'. This list is the kind of value returned by `property_info()' and expected as the third argument to `set_property_info()'; the latter function raises E_INVARG if <owner> is not valid or <perms> contains any illegal characters, or, when <new-name> is given, if <prop-name> is not defined directly on <object> or <new-name> names an existing property defined on <object> or any of its ancestors or descendants.



-- telnet://project-mongoose.net:7777 -- Mail us -- http://project-mongoose.net:7780/ --
-- Five users connected --