שתף באמצעות

פונקציה בוליאנית

  • מאמר

חל על: יישומי בד ציור זרימות שולחן עבודה יישומים מונחי-דגמים Power Pages Power Platform CLI

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

תיאור‬‏‫‬

השתמש בפונקציה בוליאנית להמרת סוגים אחרים לערך בוליאני. ערך בוליאני הוא ערך true, ‏false או blank.

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

תחביר

בוליאנית( מחרוזת )
בוליאנית( StringSingleColumnTable )

  • String - נדרש. המחרוזת שיש להמיר. חייבת להיות גרסה חסרת רגישות לאותיות גדולות של "true" או "false". מחרוזות אלו אינן מתורגמות. מחרוזות blank וגם מחרוזת ריקה מתקבלת ומומרת ל-blank. כל שאר מחרוזות הטקסט מחזירות שגיאה.

בוליאנית( מספר )
בוליאנית( NumberSingleColumnTable )

  • Number - נדרש. המספרים שיש להמיר. 0 מומר ל- false וכל שאר המספרים מומרים ל- true. ערכים ריקים מתקבלים ומומרים ל- blank.

בוליאני( לא מסווג )

  • Untyped - נדרש. הערך הלא מסווג להמרה. ערכים מקובלים תלויים בספק הלא מסווג. עבור JSON, ערכים בוליאניים של JSON true, false, ו- null מתקבלים, בהתאמה לערכים true‏, false‏, ו- blank ב- Power Fx. ערכי מחרוזת או מספרים מתקבלים כמתואר עבור העמסות המחרוזת והמספר שתוארו קודם לכן.

דוגמאות

שימוש בסיסי

נוסחה תיאור‬‏‫‬ תוצאה
בוליאני( "true" ) ממיר את מחרוזת הטקסט "true" לערך בוליאני. true
בוליאני( "false" ) ממיר את מחרוזת הטקסט "false" לערך בוליאני. שקר
בוליאני( "TRUE" ) ממיר את מחרוזת הטקסט "TRUE" לערך בוליאני. true
בוליאני( "TrUe" ) ממיר את מחרוזת הטקסט "TrUe" לערך בוליאני. true
בוליאני( "Truthful" ) ניסיונות להמיר את מחרוזת הטקסט "Truthful" לערך בוליאני, אך מכיוון שזו אינה וריאציה חסרת רגישות לאותיות גדולות של true ו- false, מוחזרת שגיאה. שגיאה (‏‏ארגומנט לא חוקי)
בוליאני( ריק() ) המר את הערך הריק לערך בוליאני. ריק
בוליאני( 0 ) המר את המספר 0 לערך בוליאני. שקר
בוליאני( 1 ) המר את המספר 1 לערך בוליאני. true
בוליאני( ‎-1234 ) המר את המספר -1234 לערך בוליאני. true

שימוש לא מסווג

נוסחה תיאור‬‏‫‬ תוצאה
בוליאני( ParseJSON( "{ ""bool"": true }" ).bool ) ממירה את הערך הלא מסווג true (בוליאני של JSON) לערך בוליאני. true
בוליאני( ParseJSON( "{ ""bool"": null }" ).bool ) ממירה את הערך הלא מסווג null ‏(null של JSON) לערך בוליאני. ריק
בוליאני( ParseJSON( "{ ""bool"": "true" }" ).bool ) ניסיונות להמיר את הערך הלא מסווג "true" (מחרוזת JSON) לערך בוליאני, אך מכיוון שהוא אינו ערך בוליאני חוקי ב- JSON, מוחזרת שגיאה. שגיאה (‏‏ארגומנט לא חוקי)
בוליאני( ParseJSON( "[ true, false, null ]" ).bool ) ניסיונות להמיר מערך של ערכים בוליאניים לטבלת עמודות אחת. טבלאות של עמודות בודדות אינן נתמכות עם ערכים לא מסווגים, ובמקום זאת יש להשתמש בנוסחה ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) או ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). שגיאה (‏‏ארגומנט לא חוקי)

טבלאות בעלות עמודה יחידה

נוסחה תיאור‬‏‫‬ תוצאה
בוליאני( [ "true", "false", Blank() ] ) ממירה את טבלת בת עמודה אחת של מחרוזות טקסט לטבלת עמודה אחת של ערכים בוליאניים. [ true, false, blank ]
בוליאני( [ "true", "falsified" ] ) ממירה את טבלת בת עמודה אחת של מחרוזות טקסט לטבלת עמודה אחת של ערכים בוליאניים. מכיוון שהרשומה השנייה בטבלה זו אינה וריאציה חסרת רגישות לאותיות גדולות של true ו- false, מוחזרת שגיאה עבור רשומה זו. [ true‏, שגיאה ‏‏(ארגומנט לא חוקי) ]
בוליאני( [ ‎1, 2, 0 ] ) ממירה את טבלת בת עמודה אחת של מספרים לטבלת עמודה אחת של ערך בוליאני. [ true, true, false ]