Jaa

Boolean-funktio

  • Artikkeli

Koskee seuraavia: Pohjaan perustuvat sovellukset Työpöytätyönkulut Mallipohjaiset sovellukset Power Platform CLI

Muuntaa tekstimerkkijonon, numeron tai tyypittämättömän arvon totuusarvoksi.

Description

Käytä Boolean-funktiota muuntaaksesi muita tyyppejä totuusarvoksi. Totuusarvo on true, false tai blank.

Useimmissa tapauksissa tyypin pakotus tapahtuu automaattisesti, eikä Boolean-funktiota tarvitse käyttää erikseen. Esimerkiksi If( "true", 1, 0 ) palauttaa arvon 1, koska tekstimerkkijono "true" muunnetaan automaattisesti totuusarvoksi. Boolean-funktio on hyödyllinen, kun haluat muuntaa tyypin erikseen tai kun käytät tyypittämätöntä arvoa.

Syntaksi

Boolean( String )
Boolean( StringSingleColumnTable )

  • String – Pakollinen. Muunnettavat merkkijonot. Täytyy olla "true"- tai "false"-arvon versio, jossa kirjainkoolla ei ole merkitystä. Näitä merkkijonoja ei ole lokalisoitu. Myös blank ja tyhjä merkkijono hyväksytään ja muunnetaan arvoksi blank. Kaikki muut tekstimerkkijonot palauttavat virheen.

Boolean( Number )
Boolean( NumberSingleColumnTable )

  • Number – Pakollinen. Muunnettavat numerot. 0 muunnetaan arvoon false ja kaikki numerot muunnetaan arvoon true. blank-arvot hyväksytään ja muunnetaan arvoksi blank.

Boolean( Untyped )

  • Untyped – Pakollinen. Muunnettava tyypittämätön arvo. Hyväksyttävät arvot riippuvat tyypittämätömästä palvelusta. Jos käytät JSON:ää, JSON-totuusarvot true, false ja null hyväksytään, ja ne vastaavat Power Fx:n true-, false- ja blank-arvoja. Merkkijono- tai lukuarvot hyväksytään aiemmin kuvatulla tavalla merkkijono - ja numero-ylikuormituksille.

Esimerkkejä

Peruskäyttö

Kaava Description Result
Boolean( "true" ) Muuntaa tekstimerkkijonon "true" totuusarvoksi. true
Boolean( "false" ) Muuntaa tekstimerkkijonon "false" totuusarvoksi. false
Boolean( "TRUE" ) Muuntaa tekstimerkkijonon "TRUE" totuusarvoksi. true
Boolean( "TrUe" ) Muuntaa tekstimerkkijonon "TrUe" totuusarvoksi. true
Boolean( "Truthful" ) Yrittää muuntaa tekstimerkkijonon "Truthful" totuusarvoksi, mutta koska se ei ole true- tai false-arvon merkkikokoriippumaton versio, funktio palauttaa virheen. virhe (virheellinen argumentti)
Boolean( Blank() ) Muunna blank-arvo totuusarvoksi. blank
Boolean( 0 ) Muunna numero 0 totuusarvoksi. false
Boolean( 1 ) Muunna numero 1 totuusarvoksi. true
Boolean( -1234 ) Muunna numero -1234 totuusarvoksi. true

Tyypittämätön käyttö

Kaava Description Result
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Muuntaa tyypittämättömän arvon true (JSON-totuusarvo) totuusarvoksi. true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Muuntaa tyypittämättömän arvon null (JSON null) totuusarvoksi. blank
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Yrittää muuntaa tyypittämättömän arvon "true" (JSON-merkkijono) totuusarvoksi, mutta koska se ei ole käypä totuusarvo JSON:ssä, funktio palauttaa virheen. virhe (virheellinen argumentti)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Yrittää muuntaa totuusarvoarvojen matriisin yksisarakkeiseksi taulukoksi. Yksisarakkeisia taulukoita ei tueta tyypittämättömien arvojen kanssa. Käytä sen sijaan funktiota ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) tai ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). virhe (virheellinen argumentti)

Yksisarakkeiset taulukot

Kaava Description Result
Boolean( [ "true", "false", Blank() ] ) Muuntaa tekstimerkkijonojen yksisarakkeisen taulukon totuusarvojen yksisarakkeiseksi taulukoksi. [ true, false, blank ]
Boolean( [ "true", "falsified" ] ) Muuntaa tekstimerkkijonojen yksisarakkeisen taulukon totuusarvojen yksisarakkeiseksi taulukoksi. Koska tämän taulukon toinen tietue ei ole true- tai false-arvon merkkikokoriippumaton virhe, tälle tietueelle palautetaan virhe. [ true, error (invalid argument) ]
Boolean( [ 1, 2, 0 ] ) Muuntaa numeroiden yksisarakkeisen taulukon totuusarvojen yksisarakkeiseksi taulukoksi. [ true, true, false ]