Help:ParserFunctions

From Homestar Runner Wiki

Revision as of 23:33, 27 October 2007

This wiki has an extension installed, called ParserFunctions. Here's how to use them:

#expr:

expr solves mathematical expressions. It does not work with strings, if you want to use those, see ifeq. It also only works with numerical entries.

#if:

The if function is an if-then-else system. It measures if the condition string is empty, it does the else text. If it is not empty, it does the than text. The syntax is:

{{#if: <condition string> | <then text> | <else text> }}

Its most common usage is in templates, where if the user defines a parameter, then it shows this text. If the user does not specify it, it shows a default. Example:

{{#if: {{{parameter|}}} | Parameter is defined | Parameter is not defined }}

If the user types {{templatename|parameter=true}} or something similar, the result is "Parameter is defined". However, if they type {{templatename}}, the result it "Parameter is not defined".

This does not solve expressions. For example, if you type {{#if: 30 - 30 = 50 | 1 | 0 }}, the result will be 1, since 30 - 30 = 50 is not empty. If you want to do if-then-else using expressions, see #ifexpr.

#ifeq:

ifeq compares two strings and then does an then-else process. To use:

{{#ifeq: <text 1> | <text 2> | <if equal> | <if not equal> }}

If text 1 and text 2 are equal, then it does the <ifequal> text. Otherwise, it does the <ifnotequal> text.

Some examples:

• {{#ifeq: {{NAMESPACE}} | Help | This page is in the Help Namespace | This page is not in the Help Namespace }} shows up as This page is in the Help Namespace.
• {{#ifeq: 7 | +000007 | Seven = Seven | Seven is not equal to Seven }} shows up as Seven = Seven

ifeq is case-sensitive.

{{#ifeq: capital | Capital | Equal | Not Equal }} shows up as Not Equal.

#ifexist:

ifexist does an if-then-else process depending on if a page exists. Syntax:

{{#ifexist: <page name> | <if exists> | <if does not exist> }}

ifexist does not work with interwiki links.

Example:

{{#ifexist: sbemail | [[Strong Bad Email]] | [[Main Page]] }} gives Strong Bad Email because "sbemail" exists.

#ifexpr:

ifexpr is a combination of if-then-else and expr. It can only be done with numbers, just like expr. Syntax:

{{#ifexpr: <expression> | <if true> | <if false> }}

Some examples:

• {{#ifexpr: 30 / 40 = 120 | yes | no }} shows up as no.
• {{#ifexpr: {{PAGENAME}} = ParserFunctions | This is a help page | No}} shows up as Expression error: Unrecognised word "parserfunctions" because PAGENAME is not a number.

#switch:

#time:

#rand:

rand generated a random number. It has been depreciated in current versions of ParserFunctions, but the HRWiki uses an older version that still has rand. Syntax:

{{rand: <minimum> | <maximum> }}

The minimum is the smallest number it can generate, the maximum is the largest.

Examples:

• {{#rand: 1 | 50 }} generates 10.
• {{#rand: 1 | 500000 }} generates 425441.
• {{#rand: .5 | 5.5 }} generates 4.