Função booliana
Aplica-se a:
Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo Power Platform CLI
Converte um valor de cadeia de caracteres de texto, número ou sem tipo em um valor booliano.
Description
Use a função Boolean para converter outros tipos em um valor booliano. Um valor booliano é true, false ou blank.
Na maioria dos casos, a coerção de tipo acontece automaticamente e a função Boolean não precisa ser usada de forma explícita. Por exemplo, If( "true", 1, 0 ) retornará 1 enquanto a cadeia de caracteres de texto "true" é automaticamente convertida em um booliano. A função Boolean é útil quando uma conversão explícita é desejada ou ao usar um valor sem tipo.
Sintaxe
Boolean( String )
Boolean( StringSingleColumnTable )
- String - obrigatório. As cadeias de caracteres a serem convertidas. Deve ser uma versão que não diferencia maiúsculas de minúsculas de
"true"ou"false". Essas cadeias de caracteres não são localizadas. Uma cadeia de caracteres blank e vazia também é aceita e convertida em um blank. Todas as outras cadeias de caracteres de texto retornam um erro.
Boolean( Number )
Boolean( NumberSingleColumnTable )
- Number - obrigatório. Os números a serem convertidos.
0é convertido em false e todos os outros números são convertidos em true. Valores blank são aceitos e convertidos em um blank.
Boolean( Untyped )
- Untyped - obrigatório. O valor sem tipo a ser convertido. Os valores aceitáveis dependem do provedor sem tipo. Para JSON, os valores boolianos JSON
true,falseenullsão aceitos, correspondendo aos valores true, false e blank no Power Fx. Os valores de cadeia de caracteres ou número são aceitos conforme descrito para as sobrecargas de Cadeia de Caracteres e Número descritas anteriormente.
Exemplos
Uso básico
| Fórmula | Description | Result |
|---|---|---|
| Boolean( "true" ) | Converte a cadeia de caracteres de texto "true" em um valor booliano. |
true |
| Boolean( "false" ) | Converte a cadeia de caracteres de texto "false" em um valor booliano. |
false |
| Boolean( "TRUE" ) | Converte a cadeia de caracteres de texto "TRUE" em um valor booliano. |
true |
| Boolean( "TrUe" ) | Converte a cadeia de caracteres de texto "TrUe" em um valor booliano. |
true |
| Boolean( "Truthful" ) | Tenta converter a cadeia de caracteres de texto "Truthful" em um valor booliano, mas como não é uma variação que não diferencia maiúsculas de minúsculas de true e false, um erro é retornado. |
erro (argumento inválido) |
| Boolean( Blank() ) | Converte o valor blank em um valor booliano. | blank |
| Boolean( 0 ) | Converte o número 0 em um valor booliano. |
false |
| Boolean( 1 ) | Converte o número 1 em um valor booliano. |
true |
| Boolean( -1234 ) | Converte o número -1234 em um valor booliano. |
true |
Uso sem tipo
| Fórmula | Description | Result |
|---|---|---|
| Boolean( ParseJSON( "{ ""bool"": true }" ).bool ) | Converte o valor sem tipo true (um booliano JSON) em um valor booliano. |
true |
| Boolean( ParseJSON( "{ ""bool"": null }" ).bool ) | Converte o valor sem tipo null (um nulo JSON) em um valor booliano. |
blank |
| Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool ) | Tenta converter o valor sem tipo "true" (uma cadeia de caracteres JSON) em um valor booliano, mas como não é um valor booliano válido em JSON, um erro é retornado. |
erro (argumento inválido) |
| Boolean( ParseJSON( "[ true, false, null ]" ).bool ) | Tenta converter uma matriz de valores boolianos em uma tabela de coluna única. As tabelas de coluna única não são compatíveis com valores sem tipo e, em vez disso, a fórmula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) ou ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ) deve ser usada. |
erro (argumento inválido) |
Tabelas de coluna única
| Fórmula | Description | Result |
|---|---|---|
| Boolean( [ "true", "false", Blank() ] ) | Converte a tabela de coluna única de cadeias de caracteres de texto em uma tabela de coluna única de valores boolianos. | [ true, false, blank ] |
| Boolean( [ "true", "falsified" ] ) | Converte a tabela de coluna única de cadeias de caracteres de texto em uma tabela de coluna única de valores boolianos. Como o segundo registro nesta tabela não é uma variação que não diferencia maiúsculas de minúsculas de true e false, um erro será retornado para esse registro. |
[ true, error (argumento inválido) ] |
| Boolean( [ 1, 2, 0 ] ) | Converte a tabela de coluna única de números em uma tabela de coluna única de valores boolianos. | [ true, true, false ] |