Fonction Boolean
S’applique à :
Applications Canvas Flux 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
booléen( Chaîne )
booléen( Tableau de colonnes uniques de chaînes )
- Chaîne - 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. Les chaînes vides et vierges sont également acceptées et converties en chaînes vides. Toutes les autres chaînes de texte renvoient une erreur.
booléen( Numéro )
booléen( NombreTableauColonneUnique )
- Numéro - Obligatoire. Le(s) nombre(s) à convertir.
0est converti en faux et tous les autres nombres sont convertis en vrai. Les valeurs vides sont acceptées et converties en valeurs vides.
booléen( Non typé )
- Non typé - Obligatoire. Valeur sans type à convertir. Les valeurs acceptables dépendent du fournisseur sans type. Pour JSON, les valeurs booléennes JSON
true,false, etnullsont 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 |
|---|---|---|
| booléen( "vrai" ) | Convertit la chaîne de texte "true" en valeur booléenne. |
vrai |
| booléen( "faux" ) | Convertit la chaîne de texte "false" en valeur booléenne. |
FAUX |
| booléen( "VRAI" ) | Convertit la chaîne de texte "TRUE" en valeur booléenne. |
vrai |
| booléen( "Vrai" ) | Convertit la chaîne de texte "TrUe" en valeur booléenne. |
vrai |
| booléen( "Véridique" ) | 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 invalide) |
| booléen( Vide() ) | Convertit la valeur blank en valeur booléenne. | vide |
| booléen( 0 ) | Convertit le nombre 0 en valeur booléenne. |
FAUX |
| booléen( 1 ) | Convertit le nombre 1 en valeur booléenne. |
vrai |
| booléen( -1234 ) | Convertit le nombre -1234 en valeur booléenne. |
vrai |
Utilisation sans type
| Formula | Description | Result |
|---|---|---|
| booléen( ParseJSON( "{ ""bool"" : true }" ).bool ) | Convertit la valeur sans type true (une valeur booléenne JSON) en une valeur booléenne. |
vrai |
| booléen( ParseJSON( "{ ""bool"" : null }" ).bool ) | Convertit la valeur sans type null (une valeur nulle JSON) en une valeur booléenne. |
vide |
| booléen( 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 invalide) |
| booléen( ParseJSON( "[ vrai, faux, 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 invalide) |
Tables à une seule colonne
| Formula | Description | Result |
|---|---|---|
| booléen( [ "vrai", "faux", vide() ] ) | Convertit la table à une seule colonne de chaînes de texte en une table à une seule colonne de valeurs booléennes. | [ true, false, blank ] |
| booléen( [ "vrai", "falsifié" ] ) | 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) ] |
| booléen( [ 1, 2, 0 ] ) | Convertit la table à une seule colonne de nombres en une table à une seule colonne de valeur booléenne. | [ true, true, false ] |