mirror of https://github.com/pragma-/pbot.git
1.6 KiB
1.6 KiB
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.