Template:BSLfuncinfo: Difference between revisions
Jump to navigation
Jump to search
(changed my mind partway through, "funcname" is back to "name" now) |
Paradox-01 (talk | contribs) m (replaced font style underlined with heavy) |
||
(86 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
<includeonly>{| | <includeonly>{{Anchor|{{{name|placeholder}}}}} | ||
{| class="BSLFuncInfo" | |||
|- | |- | ||
|type: | |{{{type|}}}<!-- | ||
-->{{#if:{{{arg1name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{#if:{{{arg1optional|}}}|''|}}{{{arg1type|}}} {{#if:{{{arg1alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg1alttype|}}}}}|<br /> | |||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}<!-- | |||
|align="center"|{{{arg3type|}}} {{#if:{{{arg3alttype|}}}|< | -->{{#if:{{{arg2name|}}}|<br /> | ||
|align="center"|{{{arg4type|}}} {{#if:{{{arg4alttype|}}}|< | {{Pipe}}align="center"{{Pipe}}{{#if:{{{arg2optional|}}}|''|}}{{{arg2type|}}} {{#if:{{{arg2alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg2alttype|}}}}}|{{#if:{{{arg1name|}}}|<br /> | ||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}|}}<!-- | |||
-->{{#if:{{{arg3name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{#if:{{{arg3optional|}}}|''|}}{{{arg3type|}}} {{#if:{{{arg3alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg3alttype|}}}}}|{{#if:{{{arg2name|}}}|<br /> | |||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}|}}<!-- | |||
-->{{#if:{{{arg4name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{#if:{{{arg4optional|}}}|''|}}{{{arg4type|}}} {{#if:{{{arg4alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg4alttype|}}}}}|{{#if:{{{arg3name|}}}|<br /> | |||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}|}}<!-- | |||
-->{{#if:{{{arg5name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{#if:{{{arg5optional|}}}|''|}}{{{arg5type|}}} {{#if:{{{arg5alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg5alttype|}}}}}|{{#if:{{{arg4name|}}}|<br /> | |||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}|}}<!-- | |||
-->{{#if:{{{arg6name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{#if:{{{arg6optional|}}}|''|}}{{{arg6type|}}} {{#if:{{{arg6alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg6alttype|}}}}}|{{#if:{{{arg5name|}}}|<br /> | |||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}|}}<!-- | |||
-->{{#if:{{{arg7name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{#if:{{{arg7optional|}}}|''|}}{{{arg7type|}}} {{#if:{{{arg7alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg7alttype|}}}}}|{{#if:{{{arg6name|}}}|<br /> | |||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}|}}<!-- | |||
-->{{#if:{{{arg8name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{#if:{{{arg8optional|}}}|''|}}{{{arg8type|}}} {{#if:{{{arg8alttype|}}}|<span style="font-weight:1000;">or</span> {{{arg8alttype|}}}}}|{{#if:{{{arg7name|}}}|<br /> | |||
{{Pipe}}[[Image:Edit-pencil.png|link={{{name}}}|Edit this info]]}}|}} | |||
|- | |- | ||
|{{# | |'''{{{name}}}('''<!-- | ||
-->| | -->{{#if:{{{arg1name|}}}|<br /><!-- if this arg exists... --> | ||
{{Pipe}}align="center"{{Pipe}}'''<!-- create a cell, then... | |||
-->{{#if:{{{arg1optional|}}}|''|}}<!-- start italics if optional arg | |||
-->{{{arg1name|}}}<!-- print arg name | |||
-->{{#if:{{{arg1altname|}}}| <span style="font-weight:1000;">or</span> {{{arg1altname|}}}}}<!-- print " or " and alternate arg name if supplied | |||
-->}} | -->{{#if:{{{arg1optional|}}}|''|}}<!-- end italics if optional arg | ||
|style="font- | -->{{#if:{{{arg2name|}}}|, |}}|<br /><!-- and if there is a next arg, print a comma --> | ||
|style="font- | {{Pipe}}''' );}}<!-- else if no args, just close parentheses | ||
-->{{#if:{{{arg2name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}'''<!-- | |||
-->{{#if:{{{arg2optional|}}}|''|}}<!-- | |||
-->{{{arg2name|}}}<!-- | |||
|style="font- | -->{{#if:{{{arg2altname|}}}| <span style="font-weight:1000;">or</span> {{{arg2altname|}}}}}<!-- | ||
-->{{#if:{{{arg2optional|}}}|''|}}<!-- | |||
-->{{#if:{{{arg3name|}}}|, |}}|{{#if:{{{arg1name|}}}|<br /> | |||
{{Pipe}}''' ); |}}}}<!-- | |||
|style="font- | -->{{#if:{{{arg3name|}}}|<br /> | ||
{{Pipe}}align="center"{{Pipe}}'''<!-- | |||
-->{{#if:{{{arg3optional|}}}|''|}}<!-- | |||
-->{{{arg3name|}}}<!-- | |||
|style="font- | -->{{#if:{{{arg3altname|}}}| <span style="font-weight:1000;">or</span> {{{arg3altname|}}}}}<!-- | ||
-->{{#if:{{{arg3optional|}}}|''|}}<!-- | |||
-->{{#if:{{{arg4name|}}}|, |}}|{{#if:{{{arg2name|}}}|<br /> | |||
{{Pipe}}''' ); |}}}}<!-- | |||
-->{{#if:{{{arg4name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}'''<!-- | |||
-->{{#if:{{{arg4optional|}}}|''|}}<!-- | |||
-->{{{arg4name|}}}<!-- | |||
-->{{#if:{{{arg4altname|}}}| <span style="font-weight:1000;">or</span> {{{arg4altname|}}}}}<!-- | |||
-->{{#if:{{{arg4optional|}}}|''|}}<!-- | |||
-->{{#if:{{{arg5name|}}}|, |}}|{{#if:{{{arg3name|}}}|<br /> | |||
{{Pipe}}''' ); |}}}}<!-- | |||
-->{{#if:{{{arg5name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}'''<!-- | |||
-->{{#if:{{{arg5optional|}}}|''|}}<!-- | |||
-->{{{arg5name|}}}<!-- | |||
-->{{#if:{{{arg5altname|}}}| <span style="font-weight:1000;">or</span> {{{arg5altname|}}}}}<!-- | |||
-->{{#if:{{{arg5optional|}}}|''|}}<!-- | |||
-->{{#if:{{{arg6name|}}}|, |}}|{{#if:{{{arg4name|}}}|<br /> | |||
{{Pipe}}''' ); |}}}}<!-- | |||
-->{{#if:{{{arg6name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}'''<!-- | |||
-->{{#if:{{{arg6optional|}}}|''|}}<!-- | |||
-->{{{arg6name|}}}<!-- | |||
-->{{#if:{{{arg6altname|}}}| <span style="font-weight:1000;">or</span> {{{arg6altname|}}}}}<!-- | |||
-->{{#if:{{{arg6optional|}}}|''|}}<!-- | |||
-->{{#if:{{{arg7name|}}}|, |}}|{{#if:{{{arg5name|}}}|<br /> | |||
{{Pipe}}''' ); |}}}}<!-- | |||
-->{{#if:{{{arg7name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}'''<!-- | |||
-->{{#if:{{{arg7optional|}}}|''|}}<!-- | |||
-->{{{arg7name|}}}<!-- | |||
-->{{#if:{{{arg7altname|}}}| <span style="font-weight:1000;">or</span> {{{arg7altname|}}}}}<!-- | |||
-->{{#if:{{{arg7optional|}}}|''|}}<!-- | |||
-->{{#if:{{{arg8name|}}}|, |}}|{{#if:{{{arg6name|}}}|<br /> | |||
{{Pipe}}''' ); |}}}}<!-- | |||
-->{{#if:{{{arg8name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}'''<!-- | |||
-->{{#if:{{{arg8optional|}}}|''|}}<!-- | |||
-->{{{arg8name|}}}<!-- | |||
-->{{#if:{{{arg8altname|}}}| <span style="font-weight:1000;">or</span> {{{arg8altname|}}}}}<!-- | |||
-->{{#if:{{{arg8optional|}}}|''|}}|{{#if:{{{arg7name|}}}|<br /> | |||
{{Pipe}}''' ); |}}}} | |||
|- | |- | ||
|default: | |default: {{#if:{{{default|}}}|{{{default|}}}| --}}<!-- print "--" if there is no default return value for function | ||
|{{#if:{{{ | -->{{#if:{{{arg1default|}}}|<br /> | ||
|align="center"|{{{ | {{Pipe}}align="center"{{Pipe}}{{{arg1default|}}}|{{#if:{{{arg1name|}}}|<br /> | ||
|align="center"|{{{ | {{Pipe}}align="center"{{Pipe}} --|}}|}}<!-- | ||
|align="center"|{{{ | -->{{#if:{{{arg2default|}}}|<br /> | ||
|align="center"|{{{ | {{Pipe}}align="center"{{Pipe}}{{{arg2default|}}}|{{#if:{{{arg2name|}}}|<br /> | ||
|}</includeonly><noinclude> | {{Pipe}}align="center"{{Pipe}} --|}}|}}<!-- | ||
-->{{#if:{{{arg3default|}}}|<br /> | |||
''' | {{Pipe}}align="center"{{Pipe}}{{{arg3default|}}}|{{#if:{{{arg3name|}}}|<br /> | ||
{{Pipe}}align="center"{{Pipe}} --|}}|}}<!-- | |||
-->{{#if:{{{arg4default|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{{arg4default|}}}|{{#if:{{{arg4name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}} --|}}|}}<!-- | |||
-->{{#if:{{{arg5default|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{{arg5default|}}}|{{#if:{{{arg5name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}} --|}}|}}<!-- | |||
-->{{#if:{{{arg6default|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{{arg6default|}}}|{{#if:{{{arg6name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}} --|}}|}}<!-- | |||
-->{{#if:{{{arg7default|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{{arg7default|}}}|{{#if:{{{arg7name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}} --|}}|}}<!-- | |||
-->{{#if:{{{arg8default|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}}{{{arg8default|}}}|{{#if:{{{arg8name|}}}|<br /> | |||
{{Pipe}}align="center"{{Pipe}} --|}}|}} | |||
|}</includeonly><noinclude>'''BSLfuncinfo''' allows for standardized listing of BSL functions. Since BSL allows for functions to take up to eight arguments, and each argument can be described here by up to six parameters, this makes '''BSLfuncinfo''' the most complex template on the wiki. However, you'll rarely need to use more than a few of these parameters to describe an average function. | |||
Parameters: | Parameters: | ||
Line 53: | Line 124: | ||
:Return type of function; should be "int", "string", "float", "bool", or "void". | :Return type of function; should be "int", "string", "float", "bool", or "void". | ||
;<tt> | ;<tt>default</tt> | ||
:Default return value of function, if there is one at the time the level starts. | |||
;<tt>name</tt> | |||
:Name of function. | :Name of function. | ||
Line 59: | Line 133: | ||
:You don't have to use these unless the function is <u>not</u> available and working on one platform; set the appropriate parameter(s) to "no" if that is the case. | :You don't have to use these unless the function is <u>not</u> available and working on one platform; set the appropriate parameter(s) to "no" if that is the case. | ||
;<tt> | ;<tt>arg[1-8]optional</tt> | ||
:If this argument can be omitted, set this to "yes". | :If this argument can be omitted, set this to "yes". | ||
;<tt> | ;<tt>arg[1-8]default</tt> | ||
:Optional arguments have default assumed values that are used when the argument is not | :Optional arguments have default assumed values that are used when the argument is not provided; give those values here. | ||
;<tt> | ;<tt>arg[1-8]type</tt> | ||
:If these arguments to the BSL function exist, give their types here. | :If these arguments to the BSL function exist, give their types here. | ||
;<tt> | ;<tt>arg[1-8]name</tt> | ||
:If these arguments to the BSL function exist, give their names here. | :If these arguments to the BSL function exist, give their names here. | ||
;<tt> | ;<tt>arg[1-8]alttype</tt> | ||
:If a BSL function can take more than one kind of data in a given argument position, give the second argument type here. | :If a BSL function can take more than one kind of data in a given argument position, give the second argument type here. | ||
;<tt> | ;<tt>arg[1-8]altname</tt> | ||
:If a BSL function can take more than one kind of data in a given argument position, give the second argument name here. | :If a BSL function can take more than one kind of data in a given argument position, give the second argument name here. | ||
Below is a default blank call for all parameters up through the fourth function argument, to save some time. You can omit any parameters you don't need when adding this template to a page. | |||
<nowiki>{{</nowiki> | <nowiki>{{</nowiki>BSLfuncinfo | ||
|type= | |type= | ||
|default= | |||
|name= | |name= | ||
|mac= | |mac= | ||
Line 110: | Line 185: | ||
<nowiki>}}</nowiki> | <nowiki>}}</nowiki> | ||
[[Category: | [[Category:Table templates]]</noinclude> |
Latest revision as of 19:05, 8 December 2023
BSLfuncinfo allows for standardized listing of BSL functions. Since BSL allows for functions to take up to eight arguments, and each argument can be described here by up to six parameters, this makes BSLfuncinfo the most complex template on the wiki. However, you'll rarely need to use more than a few of these parameters to describe an average function.
Parameters:
- type
- Return type of function; should be "int", "string", "float", "bool", or "void".
- default
- Default return value of function, if there is one at the time the level starts.
- name
- Name of function.
- mac, win
- You don't have to use these unless the function is not available and working on one platform; set the appropriate parameter(s) to "no" if that is the case.
- arg[1-8]optional
- If this argument can be omitted, set this to "yes".
- arg[1-8]default
- Optional arguments have default assumed values that are used when the argument is not provided; give those values here.
- arg[1-8]type
- If these arguments to the BSL function exist, give their types here.
- arg[1-8]name
- If these arguments to the BSL function exist, give their names here.
- arg[1-8]alttype
- If a BSL function can take more than one kind of data in a given argument position, give the second argument type here.
- arg[1-8]altname
- If a BSL function can take more than one kind of data in a given argument position, give the second argument name here.
Below is a default blank call for all parameters up through the fourth function argument, to save some time. You can omit any parameters you don't need when adding this template to a page.
{{BSLfuncinfo |type= |default= |name= |mac= |win=
|arg1optional= |arg1default= |arg1type= |arg1name= |arg1alttype= |arg1altname=
|arg2optional= |arg2default= |arg2type= |arg2name= |arg2alttype= |arg2altname=
|arg3optional= |arg3default= |arg3type= |arg3name= |arg3alttype= |arg3altname=
|arg4optional= |arg4default= |arg4type= |arg4name= |arg4alttype= |arg4altname= }}