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.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 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

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.

License

Boost License 1.0.