Index | PAL Intro | Commands | Registers | Indices | Stack | Macros | Classes | Attributes | Errors

class/del - Delete class directly or via edit buffer

CONTENTS

Synopsis
Description
Error Handling
Examples
See Also
Author

class/del ![object], class <, class ... >
class/del buffer, class <, class ... >

In the first synopsis form, performs a direct edit, deleting class from the specified object.

In the second synopsis form, inserts class delete instructions to an object edit buffer. When the buffer is committed against a nexus object using obj/commit, the instructions are processed and the specified list of classes will be removed from the object.

The object edit buffer identified by the buffer argument will have been previously initialised by obj/def, obj/clone or obj/edit.

One or more class arguments may be provided, and are either text arguments containing the names of the object classes to delete, or PSUNIT_TYPE_CLASSDEF registers returned by the class/load instruction.

A runtime error is generated if an argument is of the wrong type, if the named class does not exist in the schema, or if a referenced object does not exist in the nexus.

Note that requests to remove classes that are defined in the schema but not assigned to the object will be silently discarded.

The following demonstrates the use of an edit buffer for removing multiple classes from a nexus object:

.main   % Edit an existing node obj/edit P0, ![MyError] % Remove a list of classes class/del P0, [psContainer], [psErrorType] % Commit changes obj/commit P0

pal_commands(5), pal_registers(5), pal_indices(5), obj_def(5), obj_clone(5), obj_edit(5), obj_commit(5), class_add(5), class_load(5), ps_classes(5),
PROSE Assembly Language at prose.sourceforge.net.

Copyright (c) 2002-2008 Mark R. Bannister <cambridge@users.sourceforge.net>.

This is free software and can be downloaded from prose.sourceforge.net; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.