Help:Parameter default: Difference between revisions

Revision as of 02:45, 31 December 2005

Latest revision as of 01:49, 4 February 2025

(40 intermediate revisions by 17 users not shown)

Line 1:

{{historical|reason=<br>Although some of it may still be relevant, this page describes techniques made obsolete by [[Help:ParserFunctions|ParserFunctions]] and [[Help:Lua|Lua]].|brief=y}}

{{h:hns}}

Notation'''Note:''' Information on this page therelates wikitextto {{{a}}}MediaWiki isversions written1.6 asand [a]later.

Notation: on this page the wikitext <code>{{{A}}}</code> is written as {{mono|[{{var|a}}]}}.

In a [[help:template|template]], [a|b] is equal to [a] if that is defined, and else equal to b.

In a [[help:template|template]], <code>[{{var|a}}|{{var|b}}]</code> is equal to {{mono|[{{var|a}}]}} if that is defined, and else equal to {{mono|{{var|b}}}}.

These results [a] and b can be end results, but they can also be parameter names, parameter values, template names, parts thereof, etc.

These results {{mono|[{{var|a}}]}} and {{mono|{{var|b}}}} can be end results, but they can also be parameter names, parameter values, template names, parts thereof, etc.

If the results are template names as part of template calls involving a parameter of the outer template which may be undefined, one can arrange that an inner template is called with a parameter depending on an undefined outer parameter only if the parameter concerned is not actually used in the inner template, e.g. dummy template {{timcTimc|x0}} can be called as <nowiki>{{tlx|x0|[a]}}</nowiki> even if {{mono|[{{var|a}}]}} is undefined, see e.g. {{timTim|foreach/pass1}}.

==Limitation==

In the case of multiple default parts, only the first applies: <code>[a|b|c|d]</code> is equivalent with <code>[a|b]</code>. The default part can only contain "<code>|"</code> as part of full template, parameter or link syntax within it, and within {{xtag|nowiki-tags}}. Note that "<code>|"</code> can be avoided in table syntax by applying HTML coding (element "<nowiki><{{tag|table></nowiki>"}}).

The expression for the parameter name can also contain "<code>|"</code>, as part of full template or parameter syntax within it.

Examples, using <code><nowiki>{{x3}}</nowiki></code> containing <syntaxhighlight lang="wikitext" inline>{{{1}}}{{{1}}}{{{1}}}</syntaxhighlight> and <syntaxhighlight lang="wikitext" inline>{{t2}}</syntaxhighlight> containing <syntaxhighlight lang="wikitext" inline>start-{{{1}}}-middle-{{{2}}}-end</syntaxhighlight>:

*<syntaxhighlight lang="wikitext" inline>{{{a|b|c|d}}}</syntaxhighlight> gives <code>{{{A|b|c|d}}}</code>

*<syntaxhighlight lang="wikitext" inline>{{{a|{{x3|b}}}}}</syntaxhighlight> gives <code>{{{A|bbb}}}</code>

*<nowikisyntaxhighlight lang="wikitext" inline>{{{a|{{{b|c}}}}}}</nowikisyntaxhighlight> gives <code>{{{aA|{{{b|c}}}}}}</code>

*<syntaxhighlight lang="wikitext" inline>{{{a|[[b|c]]}}}</syntaxhighlight> gives <code>{{{A|[[b|c]]}}}</code>

*<nowikisyntaxhighlight lang="wikitext" inline>{{{{{x3|a}}|b}}}</nowikisyntaxhighlight> gives <code>{{{{{x3|a}}aaa|b}}}</code> - parameter aaa is undefined

*<nowikisyntaxhighlight lang="wikitext" inline>{{{{{{a|b}}}|c}}}</nowikisyntaxhighlight> gives <code>{{{{{{aA|b}}}|c}}}</code> - parameter b is undefined

*<nowikisyntaxhighlight lang="wikitext" inline>{{{a|<nowiki>b|c</nowiki><nowiki><}}}</nowikisyntaxhighlight>/nowiki>}}} gives <code>{{{aA|<nowiki>b|c</nowiki>}}}</code> - works fine for rendering text, but is not suitable for putting parameters b and c in a template call (there is no function for removing nowiki tags):

The expression for the parameter name can also contain "|", as part of full template or parameter syntax within it.

*:<syntaxhighlight lang="wikitext" inline>{{t2|{{{a|<nowiki>b|c</nowiki>}}}}}</syntaxhighlight> gives <code>start-b|c-middle-{{{2}}}-end</code>

*<syntaxhighlight lang="wikitext" inline>{{{a|b{{!}}c}}}</syntaxhighlight> gives <code>{{{a|b{{!}}c}}}</code>, and the bar will be interpreted by the next layer of templates.

Examples, using {{timc|x3}} and {{timc|t2}}:

*<nowiki>{{{a|b|c|d}}}</nowiki> gives {{{a|b|c|d}}}

*<nowiki>{{{a|{{x3|b}}}}}</nowiki> gives {{{a|{{x3|b}}}}}

*<nowiki>{{{a|{{{b|c}}}}}}</nowiki> gives {{{a|{{{b|c}}}}}}

*<nowiki>{{{a|[[b|c]]}}}</nowiki> gives {{{a|[[b|c]]}}}

*<nowiki>{{{a|<nowiki>b|c</nowiki><nowiki><</nowiki>/nowiki>}}} gives {{{a|<nowiki>b|c</nowiki>}}} - works fine for rendering text, but is not suitable for putting parameters b and c in a template call (there is no function for removing nowiki tags):

**<nowiki>{{t2|{{{a|<nowiki>b|c</nowiki><nowiki><</nowiki>/nowiki>}}}}} gives {{t2|{{{a|<nowiki>b|c</nowiki>}}}}}

*<nowiki>{{{{{x3|a}}|b}}}</nowiki> gives {{{{{x3|a}}|b}}} - parameter aaa is undefined

*<nowiki>{{{{{{a|b}}}|c}}}</nowiki> gives {{{{{{a|b}}}|c}}} - parameter b is undefined

==Expressions containing a parameter, with default==

Consider the expression [a[b|c]|f([b])] occurring in a template, where f([b]) denotes an expression in [b].

Conditions:

Assume:

*[a[b]] is undefined for all applicable [b] (all values of parameter b for which the template is called)

*[ac]=d (the template is called with ac=d)

Line 33 ⟶ 38:

Then the expression gives f([b]) if [b] is defined, and otherwise d.

Note that the assumptionsconditions require that no applicable [b] has value c. If one wants to be able to use all letters and digits in [b], and also allow null (the empty string), then for c one can take e.g. "@".

If it is desirable or at least acceptable that if [b] is empty, the result is not f("") but "", justand the likesame when [b] is undefined, we take d="", and can for example choose c and d to be the empty string too. Then we have the expression [a[b|]|f([b])] occurring in the template, giving f([b]) if [b] is defined, and otherwise the empty string, under the following assumptionsconditions:

*[a[b]] is undefined for all applicable [b] (all values of parameter b for which the template is called)

*the template is called with "a="

*the template is called with "a=" (while normally a parameter specification in a template call represents a choice the user of the template has, the need to specify "a=" is an unfortunate technical requirement imposed on the user of the template; it can be shielded from the user by putting the template call inside another template; on projects where server-strain is a concern this may not be desirable).

The same template can contain several expressions [a_''i'' [b_''i'' | c ] | f_''i'' ([b_''i'' ])]. By choosing all a_''i'' equal we need only one "a=" in the template call. Then the expressions are [a [b_''i'' | c ] | f_''i'' ([b_''i'' ])].

The name "a" can be chosen such that no other parameters of the template have a name starting with it; then the first condition is fulfilled (apart from the case, already discussed, that [b] is the empty string).

A special case is with constant functions f_''i'', i.e. not dependent on [b_''i'' ]. Then the expressions are [a [b_''i'' | c ] | f_''i'' ]. In the template call it only matters for each b_''i'' whether is gets a value, not which value. For convenience we can assign the empty string to those which are defined at all. Since no applicable [b] should have value c (see above), c should not be the empty string in this case. With d the empty string, the template serves as an array, where for index b_''i'' the array value is f_''i''. It is called with "ac=" and "b_''i''=", or even with a list of assignments "b_''i''=", giving a list of the corresponding array values. See {{Tim|Short DOW alt 2}}.

*the template is called with "a=" (whileWhile normally a parameter specification in a template call represents a choice the user of the template has, the need to specify "aac=" is an unfortunate technical requirement imposed on the user of the template; it can be shielded from the user by putting the template call inside another template; on projects where server-strain is a concern this may not be desirable).

The name "a" can be chosen such that no other parameters of the template have a name starting with it;, then the first condition is fulfilled (apart from the case, already discussed, that [b] is the empty string). A good choice is "if". Thus

:[if [b_''i'' | c ] | f_''i'' ([b_''i'' ])]

means

:if b_''i'' is defined then f_''i'' ([b_''i'' ])

c="" gives the if-statement which is shortest and with the best appearance, while e.g. c="u" (for "undefined") allows for the shortest specification in the template call to define b_''i'' ("b_''i''=") in cases where the value is irrelevant. The latter may be confusing in contexts where "empty" and "undefined" are usually treated as equivalent.

If the result, f([b]) or the empty string, is for final display only, i.e., not for use in expressions for template names, parameter names, parameter values, page names in links, etc., an alternative is using CSS, see [[MediaWiki talk:Common.css]].

For comparison using a="if" and c=d="", and also the shorter class name "if" instead of "HiddenStructure", the two lines are:

<syntaxhighlight lang="wikitext">

<span class=" if{{{b|}}} "> ... </span>

{{{ if{{{b|}}} | ... }}}

</syntaxhighlight>

In the second method the wikitext in the template is 15 characters shorter for each optional item, but each call is 4 characters ("if=|") longer.

In the first method conflicts with other class names have to be avoided, in the second method conflicts with other parameter names.

==Repetition==

A "for-loop" is achieved using

{{timTim|fors}}, containing:

----

<presyntaxhighlight lang="wikitext">{{fors/aux

|v@=

|c={{{call}}}

Line 58 ⟶ 84:

|pc4={{{pc4|=}}}|

1={{{1|@}}}|2={{{2|@}}}|3={{{3|@}}}

}}</presyntaxhighlight>

----
with {{timTim|fors/aux}}, containing:

----

<presyntaxhighlight lang="wikitext">{{{v{{{1}}}|{{{{{c}}}|{{{pc1}}}|{{{pc2}}}|{{{pc3}}}|{{{pc4}}}|{{{pv}}}={{{1}}}}}}}}

{{{v{{{2}}}|{{{s}}}{{{{{c}}}|{{{pc1}}}|{{{pc2}}}|{{{pc3}}}|{{{pc4}}}|{{{pv}}}={{{2}}}}}}}}

{{{v{{{3}}}|{{{s}}}{{{{{c}}}|{{{pc1}}}|{{{pc2}}}|{{{pc3}}}|{{{pc4}}}|{{{pv}}}={{{3}}}}}}}}</presyntaxhighlight>

----

In short form the latter consists of components

<codesyntaxhighlight lang="wikitext">[ v[''i''] | [s] {{[c]|[pc1]|[pc2]|[pc3]|[pc4]|[pv]=[''i'']}} ]</codesyntaxhighlight> (''i'' = 1, 2, 3, for ''i'' = 1 without [s])

or in terms of the parameters of the first template:

<codesyntaxhighlight lang="wikitext">[v[''i''|@] | [sep|] {{[call]|[pc1|]|[pc2|]|[pc3|]|[pc4|]|[pv|1]=[''i'']}} ]</codesyntaxhighlight>

This is indeed of the above-mentioned form <code>[a[b|c]|f([b])]</code>, with {{mono|1=a=v, b=''i'', c=@}}, and

<codesyntaxhighlight lang="wikitext">f(x) = [sep|] {{[call]|[pc1|]|[pc2|]|[pc3|]|[pc4|]|[pv|1]=x}}</codesyntaxhighlight>

The assumptions mentioned above apply for d equal to null, and provided that no [''i''] is equal to "@".

===Variations===

Since {{code|1=v@=null}} we can also take make the concatenation the outer operation:

<codesyntaxhighlight lang="wikitext">[v[''i''|@] | [sep|]] [v[''i''|@] | {{[call]|[pc1|]|[pc2|]|[pc3|]|[pc4|]|[pv|1]=[''i'']}} ]</codesyntaxhighlight>

==Conditional statement==

{{timTim|if}} contains:

----

<presyntaxhighlight lang="wikitext">{{{else{{{test|}}}|{{{test{{{test|}}}|{{{then|}}}}}}}}}</presyntaxhighlight>

----

or in short form:

<syntaxhighlight lang="text">[ else[test|] | [ test[test|] | [then|] ] ]</syntaxhighlight>

If [<code>{{bracket|test]}}</code> is defined this reduces to

<syntaxhighlight lang="text">[ else[test] | [ test[test] | [then|] ] ]</syntaxhighlight>

For test equal to null this reduces to [else<code>{{bracket|]else{{!}}}}</code>; otherwise, if no parameter name starting with "test" or "else" applies except these themselves, then this reduces to [then<code>{{bracket|]then{{!}}}}</code>.

If [<code>{{bracket|test]}}</code> is undefined we get

<syntaxhighlight lang="text">[ else | [then|] ]</syntaxhighlight>

==Last-but technique==

Somewhen maybe the last or last but ''x'' parameter value is needed, but number of inputted parameter is unknown. The following is a technique to get last "assigned" parameter value without using a template:<br>

<code>[4|[3|[2|[1|*]]]]</code>.

Then last but one can be achieved like this: ("ifu" is preassigned with empty)

<pre>

[[if[4|u]|3]|

[[if[3|u]|2]|

[[if[2|u]|1]|

[[if[1|u]|0]|*] //this line is actually useless, can be replaced by "*".

]

]

]

</pre>

I.e., to replace "4", "3", "2", "1" with D₄, D₃, D₂, D₁. And D<i>_x</i>=[if[<i>x</i>|u]|<i>x-1</i>]. Like this, you can get "last but <i>x</i>" parameter value. <br>

Examples, using <nowiki>{{timc|x3lastbut0}} and {{timc|t2lastbut1}}</nowiki>:

*<code><nowiki>{{lastbut0}}</nowiki></code> gives no input.

*<code><nowiki>{{lastbut0|a}}</nowiki></code> gives a.

*<code><nowiki>{{{lastbut0|a|b|c|d}|e|f|g|h|i|j}}</nowiki></code> gives {{{a|b|c|d}}} j.

*<code><nowiki>{{{a|[[blastbut1|c]]}ifu=}}</nowiki></code> gives {{{a|[[b|c]]}}}no input.

*<code><nowiki>{{lastbut1|ifu=|a}}</nowiki></code> gives no input.

*<code><nowiki>{{lastbut1|ifu=|a|b}}</nowiki></code> gives a.

*<code><nowiki>{{lastbut1|ifu=|a|b|c|d|e|f|g|h|i|j}}</nowiki></code> gives i.

*<code><nowiki>{{lastbut0|53=53|81=81|28=28}}</nowiki></code> gives 81 (finds maximum of a list of integers in the range 1 - 100)

See also {{Tim|max}}

==Server efficiency==

Line 109 ⟶ 162:

==See also==

*{{timTim|T opt par}} - examples

{{h:f|enname=Parameter default}}