transpose

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
transpose(<array>)
Summary

Returns a two-dimensional array after swapping the order of keys for each element of the array.

Introduced1.1
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
array

A two-dimensional array variable whose elements are numbers, and whose keys are sequential numbers.

Example
transpose(myArray)
put transpose(censusByHousehold) into censusByGroup
Values
NameTypeDescription
return

The transpose function returns an array.

RelatedKeyword: inverse, element
Function: keys, transpose, matrixMultiply
Glossary: array, return, element
Control Structure: function
Description

Use the transpose function to swap rows and columns in a matrix.

A two-dimensional array is an array whose elements have a two-part key to describe them. You can visualize such an array as a set of rows and columns:the first part of each element's key is the row number, and the second part is the column number. For example, the expression myArray[3,2] describes the element of myArray which is in the third row, second column.

The transpose function simply swaps rows for columns. In other words, for each element in the array, the corresponding element in transpose(array) has its two parts switched one for the other. The value in the third row, second column is moved to the second row, third column.

The transpose function is its own inverse : you can transpose a transposed array again to recover the original array.

Important: If the array has missing elements, the transpose function will fail to work. For example, an array that contains elements myArray[1,1], myArray[1,2], and myArray[2,2] cannot be transposed because the element myArray[2,1] a/is missing.

Tagsproperties