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

attr/mvmod - Modify multi-values directly or via edit buffer

CONTENTS

Synopsis
Description
List Sequences
Examples
See Also
Author

attr/mvmod ![object], attribute, find, replace <, find, replace ... >

attr/mvmod buffer, attribute, find, replace <, find, replace ... >

Identical to attr/mod except that individual values may be selected for modification within a multi-value attribute.

The find and replace parameters are text arguments or registers containing the data values to find and replace with respectively.

If find is added to an edit buffer and is a register containing the type PSUNIT_TYPE_STRING, PSUNIT_TYPE_XVALUE or PSUNIT_TYPE_LIST and the instruction does not generate an error, then the register will be cleared as the data is now referenced elsewhere. In direct edit mode, the register containing the find value will always be left intact.

If replace is a register containing the type PSUNIT_TYPE_STRING, PSUNIT_TYPE_XVALUE or PSUNIT_TYPE_LIST and the instruction does not generate an error, then the register will be cleared as the data is now referenced elsewhere. This is the case in both modes.

See attr_mod(5) for more information.

If replace is a list sequence provided via @[ ... ] notation and the list contained registers of type PSUNIT_TYPE_STRING or PSUNIT_TYPE_XVALUE, then upon successful completion of this instruction the source registers will be cleared as the data is now referenced elsewhere.

The following demonstrates the use of an edit buffer for modifying multiple values in an attribute:

.main   % Edit an existing node obj/def P0, ![BookStore] % Modify a list of values attr/mvmod P0, [name], [Oliver Twist], [Ollie Twist], [Nicholas Nickleby], [Nick Nickleby], [Martin Chuzzlewit], [Marty Chuzzles] % 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), attr_add(5), attr_del(5), attr_mod(5), attr_mvadd(5), attr_mvdel(5), attr_load(5), ps_attributes(5),
PROSE Assembly Language at prose.sourceforge.net.

Copyright (c) 2002-2011 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.