الدالة Boolean
ينطبق على:
تطبيقات اللوحة تدفقات سطح المكتب التطبيقات المستندة إلى النموذج Power Pages Power Platform CLI
تحويل سلسلة نصية أو رقم أو قيمة غير مصنفة إلى قيمة منطقية.
الوصف
استخدم الدالة Boolean لتحويل أنواع أخرى إلى قيمة منطقية. القيمة المنطقية هي صواب أو خطأ أو فراغ.
في معظم الحالات، يحدث نوع الاندماج تلقائيًا، ويجب عدم استخدام الدالة Boolean بشكل واضح. على سبيل المثال، ستقوم الدالة If( "true", 1, 0 ) بإرجاع 1 بينما يتم تحويل السلسلة النصية "true" إلى قيمة منطقية بشكل تلقائي. تُعد الدالة Boolean مفيدة عند الرغبة في إجراء تحويل صريح أو عند استخدام قيمة غير مصنفة.
بناء الجملة
منطقي ( سلسلة )
منطقي( سترينجسينجليكولموديبل )
- سلسلة - مطلوب. السلسلة المُراد تحويلها. يجب أن تكون عبارة عن إصدار لا يتحسس حالة الأحرف في
"true"أو"false". هذه السلاسل غير مترجمة. يتم أيضا قبول السلسلة الفارغة والفارغة وتحويلها إلى فارغة . أما جميع السلاسل النصية الأخرى فتُرجع خطأ.
منطقي ( عدد )
منطقي ( نمبرسينجل كولومولدتيبل )
- الرقم - مطلوب. الرقم المراد تحويله.
0يتم تحويله إلى false ويتم تحويل جميع الأرقام الأخرى إلى true. يتم قبول القيم الفارغة وتحويلها إلى فارغة .
منطقي ( غير مكتوب)
- غير مكتوب- مطلوب. القيمة غير المصنفة المراد تحويلها. تعتمد القيم المقبولة على الموفر غير المصنف. بالنسبة إلى JSON، يتم قبول القيمة المنطقية JSON
trueوfalseوnull، وهي تتطابق مع قيم صواب وخطأ وفراغ في Power Fx. يتم قبول قيم السلسلة أو الأرقام كما هو ملخص للحملات الزائدة للسلسلة و الرقم الموضحة سابقا.
الأمثلة
الاستخدام الأساسي
| الصيغة | الوصف | نتيجة |
|---|---|---|
| منطقي ( "صحيح") | تحويل السلسلة النصية "true" إلى قيمة منطقية. |
صحيح |
| منطقي ( "خطأ") | تحويل السلسلة النصية "false" إلى قيمة منطقية. |
خطأ |
| منطقي ( "صحيح") | تحويل السلسلة النصية "TRUE" إلى قيمة منطقية. |
صحيح |
| منطقي ( "TrUe") | تحويل السلسلة النصية "TrUe" إلى قيمة منطقية. |
صحيح |
| منطقي ( "صادق") | تحاول تحويل السلسلة النصية "Truthful" إلى قيمة منطقية، ولكن نظرًا لكونها شكل مختلف لا يتحسس حالة الأحرف من true وfalse، يتم إرجاع خطأ. |
خطأ (وسيطة غير صالحة) |
| منطقي( فارغ() ) | تحويل القيمة الفارغة إلى قيمة منطقية. | خلبي |
| منطقي( 0 ) | تحويل الرقم 0 إلى قيمة منطقية. |
خطأ |
| منطقي( 1 ) | تحويل الرقم 1 إلى قيمة منطقية. |
صحيح |
| منطقي( -1234 ) | تحويل الرقم -1234 إلى قيمة منطقية. |
صحيح |
استخدام غير مصنف
| الصيغة | الوصف | نتيجة |
|---|---|---|
| منطقي ( ParseJSON ( "{ ""bool": true }").bool) | تحويل القيمة غير المصنفة true (قيمة منطقية JSON) إلى قيمة منطقية. |
صحيح |
| منطقي( ParseJSON ( "{ "bool": null }") | تحويل القيمة غير المصنفة null (قيمة فارغة JSON) إلى قيمة منطقية. |
خلبي |
| منطقي ( ParseJSON ( "{ "bool"": "true" }" ).bool ) | تحاول تحويل القيمة غير المصنفة "true" (سلسلة JSON) إلى قيمة منطقية، ولكن نظرا لأنها ليست قيمة منطقية صالحة في JSON، يتم إرجاع خطأ. |
خطأ (وسيطة غير صالحة) |
| منطقي( ParseJSON ( "[ صحيح ، خطأ ، فارغ]" ).bool ) | تحاول تحويل صفيف من القيم المنطقية إلى جدول عمود واحد. جداول العمود الواحد غير مدعومة بقيم غير مصنفة، وبدلاً من ذلك يجب استخدام الصيغة ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) أو ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). |
خطأ (وسيطة غير صالحة) |
جداول عمود واحد
| الصيغة | الوصف | نتيجة |
|---|---|---|
| منطقي( [ "صواب"، "خطأ"، فارغ()] ) | تحويل جدول العمود الواحد من السلاسل النصية إلى جدول عمود واحد من القيم المنطقية. | [ true, false, blank ] |
| منطقي ( [ "صحيح" ، "مزور" ] ) | تحويل جدول العمود الواحد من السلاسل النصية إلى جدول عمود واحد من القيم المنطقية. بما أن السجل الثاني في هذا الجدول ليس شكلاً مختلفًا لا يتحسس حالة الأحرف في true وfalse، يتم إرجاع خطأ لهذا السجل. |
[ true, error (invalid argument) ] |
| منطقي( [ 1, 2, 0 ] ) | تحويل جدول العمود الواحد من الأرقام إلى جدول عمود واحد من القيم المنطقية. | [ true, true, false ] |