De functie Boolean

  • Artikel

Van toepassing op: Canvas-apps Bureaubladstromen Modelgestuurde apps Power Platform CLI

Converteert een tekenreeks, getal of niet-getypeerde waarde naar een booleaanse waarde.

Omschrijving

Gebruik de functie Boolean om andere typen om te zetten in een booleaanse waarde. Een booleaanse waarde is true, false of leeg.

In de meeste gevallen vindt typeconversie automatisch plaats en hoeft de functie Boolean niet expliciet te worden gebruikt. If( "true", 1, 0 ) retourneert bijvoorbeeld 1 als de tekenreeks "true" automatisch wordt geconverteerd naar een booleaanse waarde. De functie Boolean is handig wanneer een expliciete conversie gewenst is of wanneer een niet-getypeerde waarde wordt gebruikt.

Syntaxis

Boolean( String )
Boolean( StringSingleColumnTable )

  • String: vereist. De tekenreeksen die moeten worden geconverteerd. Moet een niet-hoofdlettergevoelige versie zijn van "true" of "false". Deze tekenreeksen worden niet gelokaliseerd. blanco en lege tekenreeksen worden ook geaccepteerd en geconverteerd naar een blanco. Alle andere tekstreeksen retourneren een fout.

Boolean( Number )
Boolean( NumberSingleColumnTable )

  • Number: vereist. De getallen die moeten worden geconverteerd. 0 wordt geconverteerd naar false en alle andere getallen worden geconverteerd naar true. blanco waarden worden geaccepteerd en geconverteerd naar een blanco.

Boolean( Untyped )

  • Untyped: vereist. De niet-getypeerde waarde die moet worden geconverteerd. Aanvaardbare waarden zijn afhankelijk van de niet-getypeerde provider. Voor JSON worden de booleaanse JSON-waarden true, false en null geaccepteerd, die overeenkomen met true, false en blanco waarden in Power Fx. Tekenreeks- of getalwaarden worden geaccepteerd zoals eerder beschreven voor String en Number.

Voorbeelden

Basisgebruik

Formule Omschrijving Result
Boolean( "true" ) Converteert de tekenreeks "true" naar een booleaanse waarde. true
Boolean( "false" ) Converteert de tekenreeks "false" naar een booleaanse waarde. false
Boolean( "TRUE" ) Converteert de tekenreeks "TRUE" naar een booleaanse waarde. true
Boolean( "TrUe" ) Converteert de tekenreeks "TrUe" naar een booleaanse waarde. true
Boolean( "Truthful" ) Probeert de tekenreeks "Truthful" te converteren naar een booleaanse waarde, maar aangezien het geen hoofdletterongevoelige variant is van true en false, wordt een fout geretourneerd. fout (ongeldig argument)
Boolean( Blank() ) Converteert de blanco waarde naar een booleaanse waarde. leeg
Boolean( 0 ) Converteert het getal 0 naar een booleaanse waarde. false
Boolean( 1 ) Converteert het getal 1 naar een booleaanse waarde. true
Boolean( -1234 ) Converteert het getal -1234 naar een booleaanse waarde. true

Gebruik van niet-getypeerd

Formule Omschrijving Result
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Converteert de niet-getypeerde waarde true (een booleaanse JSON) naar een booleaanse waarde. true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Converteert de niet-getypeerde waarde null (een JSON-null) naar een booleaanse waarde. leeg
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Probeert de niet-getypeerde waarde "true" (een JSON-tekenreeks) naar een booleaanse waarde te converteren, maar aangezien het geen geldige booleaanse waarde is in JSON, wordt er een fout geretourneerd. fout (ongeldig argument)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Probeert een matrix van booleaanse waarden te converteren naar een tabel met één kolom. Tabellen met één kolom worden niet ondersteund met niet-getypeerde waarden en in plaats daarvan moet de formule ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) of ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) worden gebruikt. fout (ongeldig argument)

Tabellen met één kolom

Formule Omschrijving Result
Boolean( [ "true", "false", Blank() ] ) Converteert de tabel met één kolom met tekenreeksen naar een tabel met één kolom met booleaanse waarden. [ true, false, leeg ]
Boolean( [ "true", "falsified" ] ) Converteert de tabel met één kolom met tekenreeksen naar een tabel met één kolom met booleaanse waarden. Aangezien de tweede record in deze tabel geen niet-hoofdlettergevoelige variant is van true en false, wordt een fout geretourneerd voor deze record. [ true, error (invalid argument) ]
Boolean( [ 1, 2, 0 ] ) Converteert de tabel met één kolom met getallen naar een tabel met één kolom met booleaanse waarden. [ true, true, false ]