fill for conversions

Fill and Align.

Signature

> fill --width --alignment --character

Parameters

• --width {int}: The width of the output. Defaults to 1
• --alignment {string}: The alignment of the output. Defaults to Left (Left(l), Right(r), Center(c/m), MiddleRight(cr/mr))
• --character {string}: The character to fill with. Defaults to ' ' (space)

Input/output types:

input	output
filesize	string
int	string
list<any>	list<string>
list<filesize>	list<string>
list<int>	list<string>
list<number>	list<string>
list<string>	list<string>
number	string
string	string

Examples

Fill a string on the left side to a width of 15 with the character '─'

> 'nushell' | fill -a l -c '─' -w 15
nushell────────

Fill a string on the right side to a width of 15 with the character '─'

> 'nushell' | fill -a r -c '─' -w 15
────────nushell

Fill a string on both sides to a width of 15 with the character '─'

> 'nushell' | fill -a m -c '─' -w 15
────nushell────

Fill a number on the left side to a width of 5 with the character '0'

> 1 | fill --alignment right --character '0' --width 5
00001

Fill a number on both sides to a width of 5 with the character '0'

> 1.1 | fill --alignment center --character '0' --width 5
01.10

Fill a filesize on the left side to a width of 5 with the character '0'

> 1kib | fill --alignment middle --character '0' --width 10
0001024000