עזרה:הוראות תנאי

מתוך ויקיפדיה, האנציקלופדיה החופשית

יש לך הודעות חדשות (השווה לגרסה הקודמת).

הוראות תנאי (או ParserFunctions) הן הוראות שמאפשרות ליצור תבניות מתוחכמות יותר, שמתאימות למצבים רבים יותר.

תחביר הפונקציות הוא {{#שם הפונקציה:פרמטרים המופרדים בסימן | ביניהם}}.

בפונקציות ניתן להשתמש הן בשמן העברי והן בשמן האנגלי.

בעבר היו בשימוש התבניות {{תנאי}}, {{בחר}}, {{בדיקת קיום דף}} ו{{השוואה2}}. במקומן יש להשתמש כיום בפונקציות "#תנאי", "#בחר", "#קיים" ו"#שווה" בהתאמה.

[עריכה] הפונקציות

[עריכה] חשב

הפונקציה הזו מאפשרת לחשב ביטויים מתמטיים ולוגיים. הפונקציה מוציאה הודעת שגיאה בחלוקות ב־0 וכדומה.

שם עברי: #חשב
שם אנגלי: ‎#expr
תחביר: {{#חשב:החישוב}}

אופרטורים זמינים:

אופרטור	פעולה	קוד לדוגמה	תוצאה
	הצגת המספרים	{{#חשב:25}} {{#חשב:123456789012345}} {{#חשב:0.000001}}	25 1.2345678901234E+14 1E-06
( )	קיבוץ פעולות	{{#חשב:(30 + 7) * 7}}	259
+	מספר חיובי	{{#חשב:+30 * +7}}	210
-	מספר שלילי	{{#חשב:-30 * -7}}	210
not	אופרטור "NOT" לוגי	{{#חשב:not 0 * 7}} {{#חשב:not 30 + 7}}	7 7
*	כפל	{{#חשב:30 * 7}}	210
/	חילוק, זהה ל־div	{{#חשב:30 / 7}}	4.2857142857143
div	חילוק, זהה ל־/ ללא חלוקת מספרים שלמים	{{#חשב:30 div 7}} {{#חשב:5 div 2 * 2 + 5 mod 2}}	4.2857142857143 6
mod	"מודולוס", השארית של החלוקה לאחר הפיכת שני המספרים למספרים שלמים. אזהרה: div ו־mod שונים מכל שפות התכנות.	{{#חשב:30 mod 7}} {{#חשב:-8 mod -3}} {{#חשב:-8 mod +3}} {{#חשב:8 mod 2.7}} {{#חשב:8 mod 3.2}} {{#חשב:8.9 mod 3}}	2 -2 -2 0 2 2
+	חיבור	{{#חשב:30 + 7}}	37
-	חיסור	{{#חשב:30 - 7}}	23
round	מעגל את המספר הראשון למספר השני של הספרות אחרי הנקודה	{{#חשב:30 / 7 round 3}} {{#חשב:30 / 7 round 0}} {{#חשב:3456 round -2}}	4.286 4 3500
=	שיוויון (מספרי ולוגי)	{{#חשב:<nowiki>30 = 7}}</nowiki>	0
<>	אי־שיוויון, זהה ל־!=	{{#חשב:30 <> 7}}	1
!=	אי־שיוויון, זהה ל־<>, "XOR" לוגי	{{#חשב:<nowiki>1 != 0}}</nowiki>	1
<	קטן מ־	{{#חשב:30 < 7}}	0
>	גדול מ־	{{#חשב:30 > 7}}	1
<=	קטן מ־ או שווה ל־	{{#חשב:30 <= 7}}	0
>=	גדול מ־ או שווה ל־	{{#חשב:30 >= 7}}	1
and	"AND" לוגי	{{#חשב:4 < 5 and 4 mod 2}}	0
or	"OR" לוגי	{{#חשב:4 < 5 or 4 mod 2}}	1

[עריכה] תנאי

הפונקציה הזו מאפשרת בוחרת בין שתי אפשרויות: אם ביטוי שהועבר לה קיים (כלומר, לא ריק ולא 0), היא מחזירה משהו אחד; אם לא, היא מחזירה משהו אחר.

שם עברי: #תנאי
שם אנגלי: ‎#if
תחביר: {{#תנאי:הביטוי לבדיקה|מה לכתוב אם הביטוי קיים|מה לכתוב אם הביטוי אינו קיים}}

התבנית היא בעיקר בשימוש בתבניות, כדי לבדוק האם הועבר להן פרמטר מסוים, אך ייתכנו שימושים נוספים רבים.

[עריכה] שווה

הפונקציה הזו היא כמו "#תנאי", אך היא בוררת בין האפשרויות על בסיס השוואה בין שני ביטויים שהועברו לה.

שם עברי: #שווה
שם אנגלי: ‎#ifeq
תחביר: {{#שווה:הביטוי הראשון להשוואה|הביטוי השני להשוואה|מה לכתוב אם הביטויים שווים|מה לכתוב אם הביטויים אינם שווים}}

[עריכה] חשב תנאי

הפונקציה הזו היא כמו "#תנאי", אך בוררת בין האפשרויות על בסיס בדיקה האם החישוב שהועבר לה (הנכתב בתחביר זהה לזה של הפונקציה "#חשב") קיים (כלומר לא 0), או לא.

שם עברי: #חשב תנאי
שם אנגלי: ‎#ifexpr
תחביר: {{#חשב תנאי:החישוב|מה לכתוב אם החישוב קיים|מה לכתוב אם החישוב אינו קיים}}

[עריכה] בחר

הפונקציה הזו מאפשרת לבחור בין כמה אפשרויות, על בסיס בדיקת ערכו של ביטוי שהועבר. למשל, ניתן לקבוע מה לכתוב כשיש ערכים שונים לפרמטר.

שם עברי: #בחר
שם אנגלי: ‎#switch

הפונקציה נכתבת באופן הבא: {{#בחר:הביטוי לבדיקה|
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|
ערך לדוגמה=מה לכתוב אם זהו ערך הביטוי|
#ברירת מחדל=מה לכתוב אם ערך הביטוי אינו אחד הערכים שנכתבו לעיל}}

השם האנגלי של "#ברירת מחדל" הוא ‎#default, וגם בו ניתן להשתמש. ניתן גם להשמיטו, ואז לא נכתב כלום אם הביטוי הוא לא אחד מהערכים הנ"ל.

ניתן כמובן להשתמש בכמה ערכים אפשריים של הביטוי שרוצים – ניתן להשתמש בערך אחד, ולעומת זאת ניתן להשתמש במאה ערכים. (השימוש בערך אחד בלבד אינו מומלץ, שכן לשם כך בדיוק קיימת הפונקציה "#שווה".)

אחד השימושים בתבנית הוא כדי לבדוק את ערכו של פרמטר מסוים שהועבר לתבנית ולהחזיר ערך על בסיסו, ואפשר גם להשתמש בתבנית כדי לקבל ערך שונה כשמשתנה מערכת משתנה, למשל כשהיום משתנה, או החודש משתנה.