3
0
mirror of https://github.com/pragma-/pbot.git synced 2024-12-25 20:22:37 +01:00
pbot/doc/Functions.md
2020-02-13 18:25:33 -08:00

1.4 KiB
Raw Blame History

Functions

This is a place-holder from the main README until I have time to flesh this out more. If youve already read that section, there is nothing new here.

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 Substitutions 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!

Heres 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.
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.