Partager via

Fonction Boolean

  • Article

S’applique à : Applications canevas Flux de bureau Applications pilotées par modèle Power Pages Power Platform CLI

Convertit une chaîne de texte, un nombre ou une valeur sans type en une valeur booléenne.

Description

Utilisez la fonction Boolean pour convertir d’autres types en une valeur booléenne. Une valeur booléene est true, false ou blank.

Dans la plupart des cas, le forçage de type se produit automatiquement et la fonction Boolean n’a pas besoin d’être utilisée explicitement. Par exemple, If( "true", 1, 0 ) renvoie 1 comme la chaîne de texte "true" est automatiquement convertie en fonction Boolean. La fonction Boolean est utile lorsqu’une conversion explicite est souhaitée ou lors de l’utilisation d’une valeur sans type.

Syntaxe

Boolean( String )
Boolean( StringSingleColumnTable )

  • String : obligatoire. La/es chaîne(s) à convertir. Doit être une version non sensible à la casse de "true" ou "false". Ces chaînes ne sont pas localisées. blank et la chaîne vide est également acceptée et convertie en une valeur blank. Toutes les autres chaînes de texte renvoient une erreur.

Boolean( Number )
Boolean( NumberSingleColumnTable )

  • Number : obligatoire. Le(s) nombre(s) à convertir. 0 est converti en false et tous les autres nombres sont convertis en true. Les valeurs blank sont acceptées et converties en blank.

Boolean( Untyped )

  • Sans type : obligatoire. Valeur sans type à convertir. Les valeurs acceptables dépendent du fournisseur sans type. Pour JSON, les valeurs booléennes JSON true, false, et null sont acceptées, correspondant aux valeurs true, false et blank dans Power Fx. Les valeurs de chaîne ou de nombre sont acceptées comme indiqué pour les surcharges Chaîne et Nombre décrites précédemment.

Examples

Utilisation de base

Formula Description Result
Boolean("true") Convertit la chaîne de texte "true" en valeur booléenne. true
Boolean( "false" ) Convertit la chaîne de texte "false" en valeur booléenne. faux
Boolean( "TRUE" ) Convertit la chaîne de texte "TRUE" en valeur booléenne. true
Boolean( "TrUe" ) Convertit la chaîne de texte "TrUe" en valeur booléenne. true
Boolean( "Truthful" ) Essaie de convertir la chaîne de texte "Truthful" en valeur booléenne, mais comme elle n’est pas une variante non sensible à la casse de true et false, une erreur est renvoyée. erreur (argument non valide)
Boolean( Blank() ) Convertit la valeur blank en valeur booléenne. blank
Boolean( 0 ) Convertit le nombre 0 en valeur booléenne. faux
Boolean( 1 ) Convertit le nombre 1 en valeur booléenne. true
Boolean( -1234 ) Convertit le nombre -1234 en valeur booléenne. true

Utilisation sans type

Formula Description Result
Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) Convertit la valeur sans type true (une valeur booléenne JSON) en une valeur booléenne. true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) Convertit la valeur sans type null (une valeur nulle JSON) en une valeur booléenne. blank
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) Essaie de convertir la valeur sans type "true" (une chaîne JSON) en une valeur booléenne, mais comme il ne s’agit pas d’une valeur booléenne valide dans JSON, une erreur est renvoyée. erreur (argument non valide)
Boolean( ParseJSON( "[ true, false, null ]" ).bool ) Essaie de convertir un tableau de valeurs booléennes en une table à une seule colonne. Les tables à une seule colonne ne sont pas prises en charge avec des valeurs sans type, et à la place la formule ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) ou ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) doit être utilisée. erreur (argument non valide)

Tables à une seule colonne

Formula Description Result
Boolean( [ "true", "false", Blank() ] ) Convertit la table à une seule colonne de chaînes de texte en une table à une seule colonne de valeurs booléennes. [ true, false, blank ]
Boolean( [ "true", "falsified" ] ) Convertit la table à une seule colonne de chaînes de texte en une table à une seule colonne de valeurs booléennes. Étant donné que le deuxième enregistrement de cette table n’est pas une variante insensible à la casse de true et false, une erreur est renvoyée pour cet enregistrement. [ true, erreur (argument non valide) ]
Boolean( [ 1, 2, 0 ] ) Convertit la table à une seule colonne de nombres en une table à une seule colonne de valeur booléenne. [ true, true, false ]