[TOC] [Prev] [Next] [Bottom]

<@TRANSPOSE>

Syntax

<@TRANSPOSE ARRAY=arrayVarName [SCOPE=scope] [{array attributes}]>

Description

Exchanges row and column specifications for values in an array; for example, the value in the third row, first column is transposed to the first row, third column. The ARRAY attribute specifies the array to transpose. The optional SCOPE attribute specifies the scope.

This tag returns a new array. The original array is not modified; you can use the <@ASSIGN> meta tag or Assign action to assign the result of this tag to a variable.

There are array-returning attributes that can be used to specify prefixes and suffixes for the returned array, rows within the array, and columns within the rows. They are described in the section Array-to-Text Conversion Attributes. By default, the returned array is formatted as an HTML table.

Example

If the local variable fred contains a 3 x 4 array of the following form:

<@ASSIGN NAME="fred_transposed" VALUE='<@TRANSPOSE ARRAY="fred" SCOPE="local">'>

@@fred_transposed returns a 4 x 3 array of the following form:

See Also

<@ASSIGN>

[TOC] [Prev] [Next] [Bottom]

Copyright © 1999, Pervasive Software. All rights reserved.