Sdílet prostřednictvím


Funkce Boolean

Platí pro: aplikace plátna desktopové toky modelem řízené aplikace Power Platform CLI

Převede textový řetězec, číslo nebo netypovanou hodnotu na logickou hodnotu.

Description

Použijte funkci Boolean pro převod jiných typů na logickou hodnotu. Logická hodnota je true, false, nebo blank.

Ve většině případů se typ převodu děje automaticky a funkce Boolean nemusí být použita explicitně. Například If( "true", 1, 0 ) vrátí 1 jako textový řetězec "true" a automaticky se převede na logickou hodnotu. Funkce Boolean je užitečná, když je požadována explicitní konverze nebo když se používá netypovaná hodnota.

Syntaxe

Boolean( String )
Boolean( StringSingleColumnTable )

  • Řetězec - povinné. Řetězce, které chcete převést. Musí se jednat o verzi bez rozlišení malých a velkých písmen hodnoty "true" nebo "false". Tyto řetězce nejsou lokalizovány. blank a prázdný řetězec je také přijat a převeden na blank. Všechny ostatní textové řetězce vrátí chybu.

Boolean( Number )
Boolean( NumberSingleColumnTable )

  • Number – povinné. Čísla, která chcete převést. 0 se převede na false a všechna ostatní čísla jsou převedena na true. blank hodnoty jsou přijaty a převedeny na blank.

Boolean( Untyped )

  • Untyped – povinné. Netypovaná hodnota, která se má převést. Přijatelné hodnoty závisí na poskytovateli netypovaného objektu. Pro JSON jsou přijímány logické hodnoty JSON true, false a null odpovídající hodnotám true, false a blank v Power Fx. Hodnoty řetězce nebo čísel jsou přijímány tak, jak je uvedeno pro výše popsané přetížení Řetězec a Číslo.

Příklady

Základní použití

Vzorec Description Result
Boolean( "true" ) Převede textový řetězec "true" na logickou hodnotu. true
Boolean( "false" ) Převede textový řetězec "false" na logickou hodnotu. nepravda
Boolean( "TRUE" ) Převede textový řetězec "TRUE" na logickou hodnotu. true
Boolean( "TrUe" ) Převede textový řetězec "TrUe" na logickou hodnotu. true
Boolean( "Truthful" ) Pokusí se převést textový řetězec "Truthful" na logickou hodnotu, ale protože se nejedná o variaci nerozlišující malá a velká písmena true a false, je vrácena chyba. chyba (neplatný argument)
Boolean( Blank() ) Převede hodnotu blanka na logickou hodnotu. prázdný
Boolean( 0 ) Převede číslo 0 na logickou hodnotu. nepravda
Boolean( 1 ) Převede číslo 1 na logickou hodnotu. true
Boolean( -1234 ) Převede číslo -1234 na logickou hodnotu. true

Netypované použití

Vzorec Description Result
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Převede netypovanou hodnotu true (JSON Boolean) na logickou hodnotu. true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Převede netypovanou hodnotu null (JSON null) na logickou hodnotu. prázdný
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Pokusí se převést netypovanou hodnotu "true" (řetězec JSON) na logickou hodnotu, ale protože to není platná logická hodnota v JSON, vrátí se chyba. chyba (neplatný argument)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Pokusí se převést pole logických hodnot na tabulku s jedním sloupcem. Tabulky s jedním sloupcem nejsou podporovány s netypovanými hodnotami, ale je třeba použít vzorec ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) nebo ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). chyba (neplatný argument)

Tabulky s jedním sloupcem

Vzorec Description Result
Boolean( [ "true", "false", Blank() ] ) Převede jednosloupcovou tabulku textových řetězců na jednosloupcovou tabulku logických hodnot. [ true, false, blank ]
Boolean( [ "true", "falsified" ] ) Převede jednosloupcovou tabulku textových řetězců na jednosloupcovou tabulku logických hodnot. Vzhledem k tomu, že druhý záznam v této tabulce není variací bez rozlišení velkých a malých písmen hodnot true a false, je pro tento záznam vrácena chyba. [ true, error (invalid argument) ]
Boolean( [ 1, 2, 0 ] ) Převede jednosloupcovou tabulku čísel na jednosloupcovou tabulku logických hodnot. [ true, true, false ]