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

obj/addr - Address a nexus object

CONTENTS

Synopsis
Description
Error Handling
Examples
See Also
Author

obj/addr write, object, <, [path] ... >
obj/addr write, [path] <, [path] ... >

Constructs a path from given text strings or registers and looks up the object in the nexus. The given path arguments will be pieced together and the resulting path is looked up relative to the specified object and stored in the write register.

The object argument may be an ordinary object reference in the form ![object], a register pointing to a node, a walker structure or an object edit buffer.

If object is omitted and the first path argument begins with .prose, then the lookup will be relative to the root of the nexus.

If object is omitted and the first path argument does not begin with a dot, then the lookup will be relative to the context root (PCTX).

If object is ommitted and the first path argument begins with a minus symbol (-), then the lookup will be relative to the module root.

If object is ommitted and the first path argument begins with a minus symbol (+), then the lookup will be relative to the instance container.

If a node in the path component contains a dot in its name, this dot must be prefixed with a backslash character \ in order to prevent it from being interpreted as a node delimiter.

A runtime error is generated if an argument is the wrong type, or if the referenced object does not exist.

obj/addr P0, ![.prose.code], [default], [main]
	Looks up default.main underneath .prose.code and stores the result in register P0.
obj/addr PUSH, [mysub], [mysub2]
	Looks up mysub.mysub2 underneath PCTX and pushes the result onto the stack.

pal_commands(5), pal_registers(5), pal_indices(5), obj_pa(5), obj_child(5), reg_load(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.