Limnoria-doc/use/plugins/format.rst
2011-06-28 08:13:53 +02:00

2.6 KiB

The Format plugin

upper <text>

Returns <text> uppercased.

bold <text>

Returns <text> bolded.

format <format string> [<arg> ...]

Expands a Python-style format string using the remaining args. Just be sure always to use %s, not %d or %f or whatever, because all the args are strings.

color <foreground> [<background>] <text>

Returns <text> with foreground color <foreground> and background color <background> (if given)

repr <text>

Returns the text surrounded by double quotes.

replace <substring to translate> <substring to replace it with> <text>

Replaces all non-overlapping occurrences of <substring to translate> with <substring to replace it with> in <text>.

capitalize <text>

Returns <text> capitalized.

underline <text>

Returns <text> underlined.

lower <text>

Returns <text> lowercased.

cut <size> <text>

Cuts <text> down to <size> by chopping off the rightmost characters in excess of <size>. If <size> is a negative number, it chops that many characters off the end of <text>.

join <separator> <string 1> [<string> ...]

Joins all the arguments together with <separator>.

reverse <text>

Returns <text> in reverse-video.

title <text>

Returns <text> titlecased.

field <number> <text>

Returns the <number>th space-separated field of <text>. I.e., if text is "foo bar baz" and <number> is 2, "bar" is returned.

concat <string 1> <string 2>

Concatenates two strings. Do keep in mind that this is not the same thing as join "", since if <string 2> contains spaces, they won't be removed by concat.

translate <chars to translate> <chars to replace those with> <text>

Replaces <chars to translate> with <chars to replace those with> in <text>. The first and second arguments must necessarily be the same length.