Function std.range.padRight
Extend the length of the input range r
by padding out the end of the range
with the element e
. The element e
must be of a common type with the
element type of the range r
as defined by CommonType
.
If n
is less than the length of of r
, then the contents of r
are
returned.
auto padRight(R, E)
(
R r,
E e,
size_t n
)
if (isInputRange!R && !isInfinite!R && !is(CommonType!(ElementType!R, E) == void));
The range primitives that the resulting range provides depends whether or not r
provides them. Except the functions back
and popBack
, which also require
the range to have a length as well as back
and popBack
Parameters
Name | Description |
---|---|
r | an input range with a length |
e | element to pad the range with |
n | the length to pad to |
Returns
A range containing the elements of the original range with the extra padding
See Also:
rightJustifier
Example
import std .algorithm .comparison : equal;
assert([1, 2, 3, 4] .padRight(0, 6) .equal([1, 2, 3, 4, 0, 0]));
assert([1, 2, 3, 4] .padRight(0, 4) .equal([1, 2, 3, 4]));
assert("abc" .padRight('_', 6) .equal("abc___"));
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.