Format:Yesno

Documentația formatuluiafișeazămodificăistoricregenerează

Aceasta este pagina de documentație pentru Format:Yesno. Pagina descrie modul de folosire al formatului și conține categoriile de care acesta aparține, precum și orice altceva ce nu face parte din formatul propriu-zis.

{{yesno}} evaluează o valoare de intrare și produce un rezultat normalizat, implicit da sau un șir gol, în funcție de conținutul valorii și de mai multe opțiuni configurabile. Nu este destinat utilizării în textul articolelor, ci în codul formatelor complexe.

Utilizare

Formatul distinge cinci tipuri de valori de intrare, furnizate prin primul parametru fără nume:

1. Da: formele yes, y, da, d, t, true, on și 1, fără a ține cont de majuscule și minuscule; de exemplu, {{yesno|tRuE|yes=foo}} → foo
2. Nu: formele no, n, nu, f, false, off și 0, fără a ține cont de majuscule și minuscule; de exemplu, {{yesno|oFf|no=bar}} → bar
3. Gol: când parametrul este definit, dar nu conține nicio valoare; de exemplu, {{yesno||blank=gol}} → gol
4. Negație: când valoarea este ¬ sau parametrul lipsește cu totul; de exemplu, {{yesno|¬|¬=nedefinit}} sau {{yesno|¬=nedefinit}} → nedefinit și nedefinit
5. Orice altceva: orice altă valoare; de exemplu, {{yesno|alt text|def=valoare implicită}} → valoare implicită

Implicit, formatul returnează „da” în primul și al cincilea caz, iar în celelalte cazuri returnează un șir gol.

Există și următoarea variantă pentru utilizările în care valoarea implicită trebuie să fie negativă:

• {{yesno-no}} – returnează întotdeauna no (sau rezultatul înlocuitor specificat prin |no=), cu excepția cazului în care este furnizată explicit o valoare pozitivă; cu alte cuvinte, returnează no și pentru valori goale, lipsă sau care nu sunt recunoscute drept pozitive.

Personalizarea rezultatului

Rezultatul implicit al formatului poate fi personalizat prin cinci parametri cu nume: |yes=, |no=, |blank=, |¬= și |def=. Dacă acești parametri sunt specificați, formatul se comportă astfel:

1. Da: formatul returnează conținutul parametrului |yes=; dacă acesta nu este specificat, returnează „da”. De exemplu:
   • {{yesno|d|yes=Da}} produce „Da”
   • {{yesno|d|yes=pozitiv}} produce „pozitiv”
2. Nu: formatul returnează conținutul parametrului |no=; dacă acesta nu este specificat, returnează un șir gol. De exemplu:
   • {{yesno|n|no=Nu}} produce „Nu”
   • {{yesno|n|no=negativ}} produce „negativ”
3. Gol: formatul returnează conținutul parametrului |blank= sau, dacă acesta nu este specificat, conținutul parametrului |no=; în lipsa ambilor parametri, returnează un șir gol.
   • {{yesno|blank=gol}} produce „gol”
   • {{yesno|no=negativ}} produce „negativ”
   • {{yesno|blank=gol|no=negativ}} produce „gol”
4. Negație: formatul returnează conținutul parametrului |¬=; dacă acesta nu este specificat, returnează un șir gol. De exemplu:
   • {{yesno|¬|¬=nedefinit}} produce „nedefinit”
5. Orice altceva: formatul returnează conținutul parametrului |def= sau, dacă acesta nu este specificat, conținutul parametrului |yes=; în lipsa ambilor parametri, returnează „da”.
   • {{yesno|alt text|def=implicit}} produce „implicit”
   • {{yesno|alt text|yes=pozitiv}} produce „pozitiv”
   • {{yesno|alt text|def=implicit|yes=pozitiv}} produce „implicit”

Pentru parametrii cu nume, specificarea unei valori goale nu este echivalentă cu omiterea parametrului. Un parametru cu nume și valoare goală indică formatului că rezultatul personalizat trebuie să fie un șir gol. De exemplu:

• {{yesno|alt text}} produce „da”
• {{yesno|alt text|def=}} produce „” [gol]

Distincții logice

Prezentare generală a valorilor logice ale {{yesno}} și a textelor asociate
Valoarea de intrare parametrul 1 (1=)	În cod	Valoare logică	Rezultat implicit		Rezultat când sunt specificate: yes=Pozitiv no=Negativ blank=Gol ¬=Nedefinit def=Implicit	Notă
yes, y, da, d, t, true, on, 1*	{{Yesno|da}}	da prin definiție	„da”		„Pozitiv”	* Nu se face distincție între majuscule și minuscule
Alt text	{{Yesno|Alt text}}	da implicit	„da”		„Implicit”	„Pozitiv” când def=[omis]
no, n, nu, f, false, off, 0*	{{Yesno|nu}}	nu prin definiție	„” [gol]		„Negativ”	* Nu se face distincție între majuscule și minuscule
[gol]	{{Yesno|}}	gol	„” [gol]		„Gol”	„Negativ” când blank=[omis]
1=[gol]	{{Yesno|1=}}	gol	„” [gol]		„Gol”	„Negativ” când blank=[omis]
¬	{{Yesno|¬}}	¬	„” [gol]		„Nedefinit”
[omis]	{{Yesno}}	¬	„” [gol]		„Nedefinit”

Comparație cu {{Yesno-no}}
Valoarea parametrului 1 (1=)	{{Yesno}}	{{Yesno-no}}
yes, y, da, d, t, true, on, 1*	„da”	„yes”
Alt text	„da”	„no”
no, n, nu, f, false, off, 0*	„” [gol]	„no”
[gol]	„” [gol]	„no”
1=[gol]	„” [gol]	„no”
¬	„” [gol]	„no”
[omis]	„” [gol]	„no”

Lista completă a parametrilor

Primul parametru fără nume este valoarea de intrare care trebuie evaluată. Ceilalți parametri, toți cu nume și opționali, reprezintă valorile returnate pentru rezultatul logic corespunzător. Dacă sunt specificați, aceștia înlocuiesc valorile returnate implicit.

{{Yesno
  | Valoare de intrare
  | yes   = Rezultat pentru o valoare pozitivă
  | no    = Rezultat pentru o valoare negativă
  | blank = Rezultat pentru o valoare goală
  | ¬     = Rezultat pentru ¬ sau pentru un parametru lipsă
  | def   = Rezultat pentru orice altă valoare
}}

Vezi și

• ¬ (U+00AC) – semnul negației
• Modul:Yesno – funcție Lua pentru interpretarea valorilor de tip boolean; comportamentul și valorile acceptate nu sunt identice cu cele ale formatului
• {{yesno-no}} – variantă care returnează implicit no dacă valoarea nu este explicit pozitivă

TemplateData

Aceasta este documentația TemplateData pentru format folosită de Editorul vizual și alte unelte.

Yesno

Evaluează o valoare de intrare și o normalizează; implicit returnează „da” pentru o valoare pozitivă sau nerecunoscută și un șir gol pentru o valoare negativă, goală ori nedefinită.

Parametrii formatului[Gestionează datele formatului]

Parametru		Descriere	Tip	Stare
Valoare de intrare	1	Valoarea care trebuie evaluată	Șir	sugerat
Rezultat pentru «da»	yes	Specifică rezultatul formatului atunci când valoarea de intrare este yes, y, da, d, t, true, on sau 1, fără a ține cont de majuscule și minuscule	Șir	opțional
Rezultat pentru «nu»	no	Specifică rezultatul formatului atunci când valoarea de intrare este no, n, nu, f, false, off sau 0, fără a ține cont de majuscule și minuscule	Șir	opțional
Rezultat pentru valoare goală	blank	Specifică rezultatul formatului atunci când primul parametru este definit, dar valoarea sa este goală	Șir	opțional
Rezultat pentru ¬	¬	Specifică rezultatul formatului atunci când valoarea de intrare este ¬ sau când primul parametru lipsește cu totul	Șir	opțional
Rezultat implicit	def	Specifică rezultatul formatului atunci când valoarea de intrare este definită, dar nu este una dintre valorile recunoscute drept pozitivă, negativă, ¬ sau goală	Șir	opțional

Documentația de mai sus este transclusă din Format:Yesno/doc. (modifică | istoric)
Editorii pot experimenta în paginile sandbox (creează | oglindește) și testcases (creează) ale acestui format.
Adăugați categorii la subpagina /doc. Subpagini ale acestui format.