View source code Display the source code in std/string.d from which this page was generated on github. Improve this page 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. Page wiki View or edit the community-maintained wiki page associated with this page.

Function std.string.centerJustifier

Center justify r in a field width characters wide. fillChar is the character that will be used to fill up the space in the field that r doesn't fill.

Prototype

auto centerJustifier(Range)(
  Range r,
  size_t width,
  dchar fillChar = ' '
)
if (isForwardRange!Range && isSomeChar!(ElementEncodingType!Range));

Parameters

NameDescription
r string or forward range of characters
width minimum field width
fillChar used to pad end up to width characters

Returns

a lazy range of the center justified result

See Also

leftJustifier rightJustifier

Example

import std.algorithm : equal;
import std.utf : byChar;
assert(centerJustifier("hello", 2).equal("hello".byChar));
assert(centerJustifier("hello", 8).equal(" hello  ".byChar));
assert(centerJustifier("hello", 7, 'x').equal("xhellox".byChar));

Authors

Walter Bright, Andrei Alexandrescu, and Jonathan M Davis

License

Boost License 1.0.

Comments