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

mtx/bresize - Resize array base dimensions

CONTENTS

Synopsis
Description
Error Handling
Examples
See Also
Author

mtx/bresize ![matrix], bdim

Modifies a matrix array identified by the matrix argument to a new list of base dimensions bdim. Array base dimensions are provided in the same format as for the mtx/def instruction. See mtx_def(5).

Matrix array resizing is non-destructive. The original array data will be left intact, only the base dimensions used to address the data changes.

A runtime error is generated if an argument is of the wrong type, or if a referenced object does not exist in the nexus or does not point to a matrix array.

mtx/bresize P0, @[#1, -1]
	Resizes the matrix array pointed to in register P0 so that it will be addressed using index numbers starting 1 in the first dimension and -1 in the second.
mtx/bresize ![a], #50
	Resizes the matrix array pointed to by the relative object reference so that the first element of the array will be addressed with index number 50.

pal_commands(5), pal_registers(5), pal_indices(5), ps_attributes(5), mtx_def(5), mtx_size(5), mtx_bsize(5), mtx_dim(5), mtx_resize(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.