Partajați prin

Funcția Boolean

  • Articol

Se aplică pentru: planșă de lucru aplicații Fluxuri desktop Aplicații bazate pe model Power Pages Power Platform CLI

Convertește un șir de text, un număr sau o valoare netipificată într-o valoare booleană.

Descriere

Utilizați funcția Boolean pentru a converti alte tipuri într-o valoare booleană. O valoare Boolean value etse true, false sau blank.

În cele mai multe cazuri, constrângerea de tip are loc automat, iar funcția Boolean nu trebuie utilizată în mod explicit. De exemplu, If( "true", 1, 0 ) va returna 1 deoarece șirul de text "true" este convertit automat într-un boolean. Funcția Boolean este utilă atunci când se dorește o conversie explicită sau când se utilizează o valoare netipificată.

Sintaxă

Boolean( Șir )
Boolean( StringSingleColumnTable )

  • String - Obligatoriu. Șirurile de convertit. Trebuie să fie o versiune care nu ține seama de majuscule și minuscule de "true" sau "false". Aceste șiruri nu sunt localizate. blank și șirul gol este, de asemenea, acceptat și convertit într-un blank. Toate celelalte șiruri de text returnează o eroare.

Boolean( Număr )
Boolean( NumberSingleColumnTable )

  • Număr - Obligatoriu. Numerele de convertit. 0 este convertit în fals și toate celelalte numere sunt convertite în adevărat. valorile necompletate sunt acceptate și convertite într-un blank.

Boolean( Netipărit )

  • Untyped - Obligatoriu. Valoarea netipificată de convertit. Valorile acceptabile depind de furnizorul netipificat. Pentru JSON, valorile JSON boolean true, false și null sunt acceptate, correspunzând valorilor true, false și blank în Power Fx. Valorile șirurilor sau numerelor sunt acceptate așa cum este subliniat pentru supraîncărcările String și Number descrise mai devreme.

Exemple

Utilizare de bază

Formula Descriere Rezultat
Boolean( „adevărat” ) Convertește șirul de text "true" la o valoare boolean. adevărat
Boolean( „fals” ) Convertește șirul de text "false" la o valoare boolean. fals
Boolean( „ADEVĂRAT”) Convertește șirul de text "TRUE" la o valoare boolean. adevărat
Boolean( „Adevărat” ) Convertește șirul de text "TrUe" la o valoare boolean. adevărat
Boolean( „Adevărat” ) Încercările de a converti șirul de text "Truthful" într-o valoare booleană, dar deoarece nu este o variație care nu face distincție între majuscule și minuscule a true și false, este returnată o eroare. eroare (argument nevalid)
Boolean( Blank() ) Convertește valoarea blank la o valoare booleană. necompletat
Boolean( 0 ) Convertește numărul 0 la o valoare booleană. fals
Boolean( 1 ) Convertește numărul 1 la o valoare booleană. adevărat
Boolean( -1234 ) Convertește numărul -1234 la o valoare booleană. adevărat

Utilizare netipificată

Formula Descriere Rezultat
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Convertește valoarea netipificată true (o booleană JSON) într-o valoare booleană. adevărat
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Convertește valoarea netipificată null (un null JSON) într-o valoare booleană. necompletat
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Încercările de a converti valoarea netipificată "true" (un șir JSON) într-o valoare booleană, dar deoarece nu este o valoare booleană validă în JSON, este returnată o eroare. eroare (argument nevalid)
Boolean( ParseJSON( "[ adevărat, fals, nul ]" ).bool ) Încercările de a converti o matrice de valori booleene într-un tabel cu o singură coloană. Tabelele cu o singură coloană nu sunt acceptate cu valori netipizate și, în schimb, trebuie utilizată formula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) sau ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). eroare (argument nevalid)

Tabele cu o singură coloană

Formula Descriere Rezultat
Boolean( [ „adevărat”, „fals”, Blank() ] ) Convertește tabelul cu o singură coloană de șiruri de text într-un tabel cu o singură coloană de valori booleene. [ true, false, blank ]
Boolean( [ "adevărat", "falsificat" ] ) Convertește tabelul cu o singură coloană de șiruri de text într-un tabel cu o singură coloană de valori booleene. Deoarece a doua înregistrare din acest tabel nu este o variație care nu ține seama de majuscule și minuscule pentru true și false, este returnată o eroare pentru această înregistrare. [ true, error (invalid argument) ]
Boolean( [ 1, 2, 0 ] ) Convertește tabelul cu o singură coloană de numere într-un tabel cu o singură coloană de valoare boolean. [ true, true, false ]