Display the source code in std/range/package.d from which this page was generated on github.

If you spot a problem with this page, click here to create a Bugzilla issue.

Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone.

Function `std.range.transposed`

Given a range of ranges, returns a range of ranges where the i'th subrange contains the i'th elements of the original subranges.


						
				Transposed!(RangeOfRanges,opt) transposed(TransverseOptions opt = TransverseOptions.assumeJagged, RangeOfRanges)
				(
				

				  RangeOfRanges rr
				

				)
				

				if (isForwardRange!RangeOfRanges && isInputRange!(ElementType!RangeOfRanges) && hasAssignableElements!RangeOfRanges);

Transposed currently defines save, but does not work as a forward range. Consuming a copy made with save will consume all copies, even the original sub-ranges fed into Transposed.

Parameters

Name	Description
opt	Controls the assumptions the function makes about the lengths of the ranges (i.e. jagged or not)
rr	Range of ranges

Example

import std.algorithm.comparison : equal;
int[][] ror = [
    [1, 2, 3],
    [4, 5, 6]
];
auto xp = transposed(ror);
assert(equal!"a.equal(b)"(xp, [
    [1, 4],
    [2, 5],
    [3, 6]
]));

Example

int[][] x = new int[][2];
x[0] = [1, 2];
x[1] = [3, 4];
auto tr = transposed(x);
int[][] witness = [ [ 1, 3 ], [ 2, 4 ] ];
uint i;

foreach (e; tr)
{
    writeln(array(e)); // witness[i++]
}

Authors

Andrei Alexandrescu, David Simcha, Jonathan M Davis, and Jack Stouffer. Credit for some of the ideas in building this module goes to Leonardo Maffi.

License

Boost License 1.0.

API Documentation

Function std.range.transposed

Parameters

Example

Example

Authors

License

Function `std.range.transposed`