Display the source code in std/string.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.string.center`

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


						
				S center(S)
				(
				

				  S s,
				

				  size_t width,
				

				  dchar fillChar = ' '
				

				)
				

				if (isSomeString!S);

Parameters

Name	Description
s	The string to center
width	Width of the field to center `s` in
fillChar	The character to use for filling excess space in the field

Returns

The resulting center-justified string. The returned string is GC-allocated. To avoid GC allocation, use centerJustifier instead.

Example

writeln(center("hello", 7, 'X')); // "XhelloX"
writeln(center("hello", 2, 'X')); // "hello"
writeln(center("hello", 9, 'X')); // "XXhelloXX"

Authors

Walter Bright, Andrei Alexandrescu, Jonathan M Davis, and David L. 'SpottedTiger' Davis

License

Boost License 1.0.