Função booliana
Aplica-se a:
Aplicativos Canvas Fluxos de desktop Aplicativos orientados a modelos Power Pages 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
booliano( String )
booliano( 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. blank e string vazia também são aceitas e convertidas em um blank. Todas as outras cadeias de caracteres de texto retornam um erro.
booliano( Número )
booliano( NúmeroTabelaColunaÚnica )
- Número - Obrigatório. Os números a serem convertidos.
0é convertido para falso e todos os outros números são convertidos para verdadeiro. valores em branco são aceitos e convertidos em um espaço em branco.
booliano( Não tipado )
- Sem tipo - 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 |
|---|---|---|
| booliano( "verdadeiro" ) | Converte a cadeia de caracteres de texto "true" em um valor booliano. |
verdadeiro |
| booliano( "falso" ) | Converte a cadeia de caracteres de texto "false" em um valor booliano. |
falso |
| booliano( "VERDADEIRO" ) | Converte a cadeia de caracteres de texto "TRUE" em um valor booliano. |
verdadeiro |
| booliano( "Verdadeiro" ) | Converte a cadeia de caracteres de texto "TrUe" em um valor booliano. |
verdadeiro |
| booliano( "Verdadeiro" ) | 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) |
| booliano( Em branco() ) | Converte o valor blank em um valor booliano. | em branco |
| booliano( 0 ) | Converte o número 0 em um valor booliano. |
falso |
| booliano( 1 ) | Converte o número 1 em um valor booliano. |
verdadeiro |
| booliano( -1234 ) | Converte o número -1234 em um valor booliano. |
verdadeiro |
Uso sem tipo
| Fórmula | Description | Result |
|---|---|---|
| booliano( ParseJSON( "{ ""bool"": verdadeiro }" ).bool ) | Converte o valor sem tipo true (um booliano JSON) em um valor booliano. |
verdadeiro |
| booliano( ParseJSON( "{ ""bool"": nulo }" ).bool ) | Converte o valor sem tipo null (um nulo JSON) em um valor booliano. |
em branco |
| booliano( ParseJSON( "{ ""bool"": "verdadeiro" }" ).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) |
| booliano( ParseJSON( "[ verdadeiro, falso, nulo ]" ).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 |
|---|---|---|
| booliano( [ "verdadeiro", "falso", Em branco() ] ) | Converte a tabela de coluna única de cadeias de caracteres de texto em uma tabela de coluna única de valores boolianos. | [ true, false, blank ] |
| booliano( [ "verdadeiro", "falsificado" ] ) | 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) ] |
| booliano( [ 1, 2, 0 ] ) | Converte a tabela de coluna única de números em uma tabela de coluna única de valores boolianos. | [ true, true, false ] |