Função Boolean
Aplica-se a:
Canvas apps Fluxos de área de trabalho CLI de aplicativos Power Pages Power Platform orientados por modelo
Converte uma cadeia de texto, número ou valor sem tipo para um valor booleano.
Descrição
Utilize a função Boolean para converter outros tipos num valor booleano. O valor booleano é true, false ou blank.
Na maioria dos casos, a coerção de tipo ocorre automaticamente e a função Boolean não precisa de ser utilizada explicitamente. Por exemplo, If( "true", 1, 0 ) irá obter 1, uma vez que a cadeia de texto "true" é convertida automaticamente num booleano. A função Boolean é útil quando se pretende uma conversão explícita ou quando utiliza um valor sem tipo.
Sintaxe
booleano( String )
booleano( StringSingleColumnTable )
- string - obrigatório. A(s) cadeia(s) a converter. Tem de ser uma versão que não seja sensível às maiúsculas e minúsculas de
"true"ou"false". Estas cadeias não estão localizadas. A cadeia de caracteres em branco e vazia também é aceita e convertida em um espaço em branco. Todas as outras cadeias de texto obtêm um erro.
booleano( Número )
booleano( NumberSingleColumnTable )
- Número - Obrigatório. O(s) número(s) a converter.
0é convertido em falso e todos os outros números são convertidos em verdadeiros. valores em branco são aceitos e convertidos em branco .
booleano( Não digitado )
- Não digitado - Obrigatório. O valor sem tipo a converter. Os valores aceitáveis dependem do fornecedor sem tipo. Para JSON, os valores booleanos de JSON
true,falseenullsão aceites e correspondem aos valores true, false e blank no Power Fx. Os valores de cadeia ou número são aceites conforme descrito para as sobrecargas Cadeia e Número descritas anteriormente.
Exemplos
Utilização básica
| Fórmula | Descrição | Resultado |
|---|---|---|
| booleano( "verdadeiro" ) | Converte a cadeia de texto "true" para um valor booleano. |
verdadeiro |
| booleano( "falso" ) | Converte a cadeia de texto "false" para um valor booleano. |
falso |
| booleano( "VERDADEIRO" ) | Converte a cadeia de texto "TRUE" para um valor booleano. |
verdadeiro |
| booleano( "TrUe" ) | Converte a cadeia de texto "TrUe" para um valor booleano. |
verdadeiro |
| booleano( "Verdadeiro" ) | Tenta converter a cadeia de texto "Truthful" num valor booleano, mas, visto que não é uma variação que não é sensível às maiúsculas e minúsculas de true e false, é obtido um erro. |
erro (argumento inválido) |
| booleano( Em branco() ) | Converta o valor blank num valor booleano. | em branco |
| booleano( 0 ) | Converta o número 0 num valor booleano. |
falso |
| booleano( 1 ) | Converta o número 1 num valor booleano. |
verdadeiro |
| booleano( -1234 ) | Converta o número -1234 num valor booleano. |
verdadeiro |
Utilização sem tipo
| Fórmula | Descrição | Resultado |
|---|---|---|
| booleano( ParseJSON( "{ ""bool"": true }" ).bool ) | Converte o valor sem tipo true (um JSON booleano) num valor booleano. |
verdadeiro |
| booleano( ParseJSON( "{ ""bool"": null }" ).bool ) | Converte o valor sem tipo null (um JSON null) num valor booleano. |
em branco |
| booleano( ParseJSON( "{ ""bool"": "true" }" ).bool ) | As tentativas de converter o valor sem tipo "true" (uma cadeia JSON) num valor booleano, mas, visto que não é um valor booleano válido no JSON, é obtido um erro. |
erro (argumento inválido) |
| booleano( ParseJSON( "[ verdadeiro, falso, nulo ]" ).bool ) | Tenta converter uma matriz de valores booleanos numa tabela de coluna única. As tabelas de coluna única não são suportadas com valores sem tipo e, em vez disso, deve ser utilizada a fórmula ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) ) ou ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) ). |
erro (argumento inválido) |
Tabelas de coluna única
| Fórmula | Descrição | Resultado |
|---|---|---|
| booleano( [ "verdadeiro", "falso", em branco() ] ) | Converte a tabela de coluna única de cadeias de texto numa tabela de coluna única de valores booleano. | [ true, false, blank ] |
| booleano( [ "verdadeiro", "falsificado" ] ) | Converte a tabela de coluna única de cadeias de texto numa tabela de coluna única de valores booleano. Uma vez que o segundo registo nesta tabela não é uma variação que não é sensível às maiúsculas e minúsculas de true e false, é obtido um erro para este registo. |
[ true, erro (argumento inválido) ] |
| booleano( [ 1, 2, 0 ] ) | Converte a tabela de coluna única de números numa tabela de coluna única de valor booleano. | [ true, true, false ] |