Transposes a matrix constructing the result in a provided uninitialized buffer.
- Template Parameters
-
| ValueType | A type of a matrix element. |
- Parameters
-
| [in] | column_matrix | A pointer to a matrix, of columns by rows elements, to transpose. |
| columns | A number of columns in the matrix to transpose. |
| rows | A number of rows in the matrix to transpose. |
| [in,out] | result | A pointer to an output buffer capable of holding n2 elements of the type ValueType. The elements of the transposition are constructed in respective positions in the result buffer. |
- Exceptions
-
| Any | exception generated from an invocation of copy-construction of ValueType. |
The function discards any existing content in result, i.e. no destruction of any existing data takes place. In order to perform assignment of the output values, rather than constructing new elements in result, use transpose_copy.
To transpose a matrix in place, use transpose_inplace.