pbot/doc/Functions.md

Functions

Functions are commands that accept input, manipulate it and then output the result. They are extremely useful with piping or command substituting.

For example, the uri_escape function demonstrated in the Substitution section earlier makes text safe for use in a URL. We also saw the sed and uc functions demonstrated in Piping.

<pragma-> uri_escape thing's & words
   <PBot> thing%27s%20%26%20words

As demonstrated previously, the sed function replaces text using a substitution regex. The uc function uppercases the text.

<pragma-> echo Hello world! | {sed s/world/universe/} | {uc}
   <PBot> HELLO UNIVERSE!

Here’s a short list of the Functions that come with PBot.

Name	Description
uri_escape	Percent-encodes unsafe URI characters.
sed	Performs sed-like regex substitution.
grep	Searches a string, using a regex, and prints the matching whole-word (e.g. echo pizza hamburger hotdog \| {grep burger} outputs hamburger).
pluralize	Intelligently makes a word or phrase plural.
unquote	Removes surrounding quotation marks.
title	Title-cases text. That is, lowercases the text then uppercases the first letter of each word.
ucfirst	Uppercases the first character of the text.
uc	Uppercases all characters.
lc	Lowercases all characters.

Additional Functions can be loaded via PBot Plugins. For examples, see Plugin/FuncBuiltins.pm and Plugin/FuncGrep.pm.