Amin: ۱ نسخه واردشده

2021-10-19T01:52:48Z

۱ نسخه واردشده

→ نسخهٔ قدیمی‌تر	نسخهٔ ‏۱۹ اکتبر ۲۰۲۱، ساعت ۱۱:۵۲
(بدون تفاوت)

dezfulwiki>Jeeputer: Jeeputer صفحهٔ الگو:If empty/توضیحات را به الگو:اگر خالی/توضیحات منتقل کرد

2021-05-19T15:28:10Z

Jeeputer صفحهٔ الگو:If empty/توضیحات را به الگو:اگر خالی/توضیحات منتقل کرد

صفحهٔ تازه

{{زیرصفحه توضیحات}}
{{میانبر الگو|ifempty}}
{{High-risk| 589,000+ }}
{{سرنویس|[[الگو:Ifempty]] and [[الگو:Ifempty]] redirect here.}}

{{چپ‌چین}}
This is the {{الگو|if empty}} template.

This template is used inside other templates. It takes up to nine parameters (unnamed parameters 1-9) and returns the first found to be defined and non-empty. If none is found, nothing is returned. Typical usage is like this:
: <code><nowiki>{{Ifempty|{{{logo|}}} |{{{image|}}} |{{{picture|}}} |default.svg}}</nowiki></code>
: {{95%|<nowiki>("Return {{{logo|}}} if it has a value, else {{{image|}}} if it has a value, else {{{picture|}}} if it has a value, else return "default.svg".")</nowiki>}}
This returns the first of the parameters ''logo'' and ''image'' that is defined and non-empty, otherwise "default.svg".

===Rationale===
The MediaWiki parameter default function doesn't return the default value for empty parameters. That is, <code><nowiki>{{{logo|default.svg}}}</nowiki></code> does not return "default.svg" if the template was called like this: <code><nowiki>{{الگو|logo=}}</nowiki></code>.

The usual workaround for a single parameter is:
: <code><nowiki>{{#if:{{{logo|}}} |{{{logo}}} |default.svg}}</nowiki></code>
: {{95%|<nowiki>("If {{{logo}}} has a value, return it, else return "default.svg".")</nowiki>}}

But this becomes complex when several parameters are to be checked:
: <code><nowiki>{{#if:{{{logo|}}} |{{{logo}}} |{{#if:{{{image|}}} |{{{image}}} |{{#if:{{{picture|}}} |{{{picture}}} |default.svg}} }} }}</nowiki></code>
: {{95%|<nowiki>("If {{{logo}}} has a value, return it; else if {{{image}}} has a value, return that; else if {{{picture}}} has a value, return that; else return "default.svg".)</nowiki>}}
In these cases, {{Tlf|if empty}} produces the simpler syntax (as above):
: <code><nowiki>{{Ifempty|{{{logo|}}} |{{{image|}}} |{{{picture|}}} |default.svg}}</nowiki></code>

====Piping====
Parameters used with {{Tlf|if empty}} must be [[لوله‌کشی (یونیکس)|pipe]]d – i.e. include the [[خط عمودی|vertical bar (pipe) symbol]] {{Nowrap|("{{Thinsp}}|{{Thinsp}}")}} as a trailing character – so that empty or undefined parameters aren't treated as text and returned incorrectly. Hence, for example, <code><nowiki>{{{logo|}}}</nowiki></code>, <code><nowiki>{{{image|}}}</nowiki></code> and <code><nowiki>{{{picture|}}}</nowiki></code> rather than {{Param|logo}}, {{Param|image}} and {{Param|picture}} in the above examples.

===Examples===
{{Aligned table|class=wikitable
|cols=3 |col1style=padding-right:1.0em; |col2style=padding-left:0.5em;padding-right:1.0em; |col3style=padding-left:0.5em;
|row1style=background:whitesmoke;padding-left:0.5em;font-weight:bold;
| Code | Result |
| {{الگوک|if empty}} | {{Ifempty}} | Returns an empty string.
| {{الگوک|if empty|one}} | {{Ifempty|one}} | Returns the first parameter that is defined and not empty.
| {{الگوک|if empty|one|two}} | {{Ifempty|one|two}} |
| {{الگوک|if empty|one|two|three|four}} | {{Ifempty|one|two|three|four}} |
| {{الگوک|if empty||two}} | {{Ifempty||two}} | The first parameter is empty/undefined, so is passed over.
| {{الگوک|if empty||two|three|four}} | {{Ifempty||two|three|four}} |
| {{الگوک|if empty||two||four}} | {{Ifempty||two||four}} |
| <code><nowiki>{{Ifempty|||||||||nine}}</nowiki></code> | {{Ifempty|||||||||nine}} |
| <code><nowiki>{{Ifempty||||||||||ten}}</nowiki></code> | {{Ifempty||||||||||ten}} | Empty string returned if maximum of nine parameters exceeded.
| {{الگوک|if empty|}} | {{Ifempty|}} | The only parameter is empty or undefined, so returns an empty string.
| {{الگوک|if empty||||}} | {{Ifempty||||}} | Returns an empty string.
| <code><nowiki>{{Ifempty|{{{1|}}}|{{{2|}}}|three}}</nowiki></code> | {{Ifempty|{{{1|}}}|{{{2|}}}|three}} |
| <code><nowiki>{{Ifempty|{{{1}}}|{{{2}}}|three}}</nowiki></code> | {{Ifempty|{{{1}}}|{{{2}}}|three}} | No pipe-characters following the names of the first two parameters ("1" and "2"), so the first of these returned as text ("{{{1}}}").
| <code><nowiki>{{Ifempty|{{{logo|}}}|two}}</nowiki></code> | {{Ifempty|{{{logo|}}}|two}} |
| <code><nowiki>{{Ifempty|{{{logo}}}|two}}</nowiki></code> | {{Ifempty|{{{logo}}}|two}} | No pipe-character following the parameter name "logo", so the text "{{{logo}}}" returned.
| <code><nowiki>{{Ifempty|2=x}}</nowiki></code> | {{Ifempty|2=x}} | Whether parameter 1 is undefined or empty does not matter.
| <code><nowiki>{{Ifempty|p=q}}</nowiki></code> | {{Ifempty|p=q}} | The template identifies the parameters it receives as parameters 1 to 9, not using names such as "p", etc.
}}

===See also===
* {{tlspc|if all}}
* {{tlspc|if either}}
* {{tlspc|px}} assists in handling image-width parameters within templates.
* [[Help:Parameter default]]
{{پایان چپ‌چین}}

<includeonly>
{{#ifeq:{{SUBPAGENAME}}|sandbox | |

[[رده:الگو:If-then-else]]
}}
</includeonly>

الگو:اگر خالی/توضیحات - تاریخچهٔ نسخه‌ها

Amin: ۱ نسخه واردشده

dezfulwiki>Jeeputer: Jeeputer صفحهٔ الگو:If empty/توضیحات را به الگو:اگر خالی/توضیحات منتقل کرد