Template:FunctionDeclaration

From Kolmafia
Revision as of 14:22, 31 December 2020 by Philmasterplus (talk | contribs) (Use question marks (?, a la TypeScript) instead of brackets for optional parameters. Brackets have a different meaning in ASH (maps), so using them for optional parameters was confusing.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Displays an ASH function's declaration. This is meant to be transcluded by other templates, rather than regular pages.

Template parameters

ParameterDescriptionTypeStatus
Function page namename

Name of a function page. '''This must be a data page.'''

Pagerequired
Overloaded function numberfunc

A function page may describe multiple overloaded functions under the same name. This parameter allows you to select one. Allowed values are 1-5, inclusive.

Numberrequired
Rendering formatformat

"" (empty string) = show everything, "signature" = only show parameter types (i.e. function signature). Default value is empty string (show everything).

Lineoptional
Show descriptions?desc

If set to "yes", also show the description of each function and its parameters below the declaration. Technically, any non-empty string works, but please use "yes" for ease of maintenance.

Lineoptional
Show parameter descriptions?param_desc

If set to "yes", also show the description of each function's parameters below the declaration. Technically, any non-empty string works, but please use "yes" for ease of maintenance.

Lineoptional

Examples

Wiki markup Result
Normal format
{{FunctionDeclaration|name=visit_url|func=1}}
buffer visit_url()
{{FunctionDeclaration|name=visit_url|func=2}}
buffer visit_urlstring url, boolean? use_POST = true, boolean? encoded = false )
Normal format with description
{{FunctionDeclaration|name=visit_url|func=1|desc=yes}}
buffer visit_url()
Returns the original HTML source of the page being overridden inside a relay override script.
{{FunctionDeclaration|name=visit_url|func=2|desc=yes}}
buffer visit_urlstring url, boolean? use_POST = true, boolean? encoded = false )
Visits a web page and returns its HTML source.
Normal format with description + parameter description
{{FunctionDeclaration|name=visit_url|func=1|desc=yes|param_desc=yes}}
buffer visit_url()
Returns the original HTML source of the page being overridden inside a relay override script.
{{FunctionDeclaration|name=visit_url|func=2|desc=yes|param_desc=yes}}
buffer visit_urlstring url, boolean? use_POST = true, boolean? encoded = false )
Visits a web page and returns its HTML source.
  • url: URL of the page to visit. If a relative URL is provided, it is treated as an in-game page.
  • use_POST: If true, makes an HTTP POST request when visiting the URL. Otherwise, makes a GET request.
  • encoded: If true, KoLmafia assumes that url has already been URL-encoded and will not encode it.
Signature format
{{FunctionDeclaration|name=visit_url|func=2|format=signature}}
buffer visit_urlstring, boolean?, boolean? )
Invalid or missing function number
{{FunctionDeclaration|name=visit_url|func=4}}
Invalid function number (func = "4") in Template:FunctionDeclaration
{{FunctionDeclaration|name=visit_url|func=0}}
Invalid function number (func = "0") in Template:FunctionDeclaration
{{FunctionDeclaration|name=visit_url}}
Invalid function number (func = "") in Template:FunctionDeclaration