Función booleana

Artigo
07/11/2024

Aplícase a: Aplicacións de lenzo Fluxos de escritorio Aplicacións baseadas en modelos Power Pages Power Platform CLI

Converte unha cadea de texto, un número ou un valor sen escribir nun valor booleano.

Descripción

Use a función Booleana para converter outros tipos nun valor booleano. O valor booleano é true, false ou en branco.

Na maioría dos casos, a coerción do tipo ocorre automaticamente e non é necesario utilizar a función booleana de forma explícita. Por exemplo, If( "true", 1, 0 ) devolverá 1 xa que a cadea de texto "true" convértese automaticamente nun booleano. A función booleana é útil cando se desexa unha conversión explícita ou cando se utiliza un valor sen escribir.

Sintaxe

Booleano( Cadea )
Booleano( StringSingleColumnTable )

String - Obrigatorio. As cadeas que hai que converter. Debe ser unha versión que non distingue entre maiúsculas e minúsculas de "true" ou "false". Estas cadeas non están localizadas. As cadeas en branco e baleiras tamén se aceptan e convértense nun valor en branco. Todas as outras cadeas de texto devolven un erro.

Booleano(Número)
Booleano( NumberSingleColumnTable )

Number: Obrigatorio. Os números que hai que converter. 0 convértese en false e todos os demais números convértense en true. Os valores en branco acéptanse e convértense nun valor en branco.

Booleano( Sen tipificación )

Untyped - Obrigatorio. O valor sen escribir para converter. Os valores aceptables dependen do provedor non tipificado. Para JSON, acéptanse os valores booleanos JSON true, false e null, correspondentes aos valores de true, false e blank en Power Fx. Os valores de cadea ou de número acéptanse como se indica para as sobrecargas String e Number descritas anteriormente.

Exemplos

Uso básico

Fórmula	Descripción	Resultado
Boolean( "true" )	Converte a cadea de texto `"true"` nun valor booleano.	true
Boolean( "false" )	Converte a cadea de texto `"false"` nun valor booleano.	false
Boolean( "TRUE" )	Converte a cadea de texto `"TRUE"` nun valor booleano.	true
Boolean( "TrUe" )	Converte a cadea de texto `"TrUe"` nun valor booleano.	true
Boolean( "Truthful" )	Inténtase converter a cadea de texto `"Truthful"` a un valor booleano, pero como non é unha variación que non distingue entre maiúsculas e minúsculas de `true` e `false`, devólvese un erro.	erro (argumento non válido)
Boolean( Blank() )	Converta o valor blank nun valor booleano.	blank
Boolean( 0 )	Converta o número `0` nun valor booleano.	false
Boolean( 1 )	Converta o número `1` nun valor booleano.	true
Boolean( -1234 )	Converta o número `-1234` nun valor booleano.	true

Uso non tipificado

Fórmula	Descripción	Resultado
Boolean( ParseJSON( "{ ""bool"": true }" ).bool )	Converte o valor non tipificado `true` (un booleano JSON) nun valor booleano.	true
Boolean( ParseJSON( "{ ""bool"": null }" ).bool )	Converte o valor non tipificado `null` (un JSON nulo) nun valor booleano.	blank
Boolean( ParseJSON( "{ ""bool"": "true" }" ).bool )	Intenta converter o valor non tipificado `"true"` (unha cadea JSON) nun valor booleano, pero como non é un valor booleano válido en JSON, devólvese un erro.	erro (argumento non válido)
Boolean( ParseJSON( "[ true, false, null ]" ).bool )	Intenta converter unha matriz de valores booleanos nunha táboa de columna única. As táboas dunha soa columna non se admiten con valores non tipificados, polo que debería utilizarse a fórmula `ForAll( Table(ParseJSON( "[true, false, null]" )), Boolean( ThisRecord.Value ) )` ou `ForAll( ParseJSON( "[true, false, null]" ), Boolean( ThisRecord ) )`.	erro (argumento non válido)

Táboas dunha soa columna

Fórmula	Descripción	Resultado
Boolean( [ "true", "false", Blank() ] )	Converte a táboa dunha soa columna de cadeas de texto nunha táboa dunha soa columna de valores booleanos.	[ true, false, blank ]
Boolean( [ "true", "falsified" ] )	Converte a táboa dunha soa columna de cadeas de texto nunha táboa dunha soa columna de valores booleanos. Dado que o segundo rexistro desta táboa non é unha variación que non distingue entre maiúsculas e minúsculas de `true` e `false`, devólvese un erro para este rexistro.	[ true, erro (argumento non válido) ]
Boolean( [ 1, 2, 0 ] )	Converte a táboa dunha soa columna de números nunha táboa dunha soa columna de valores booleanos.	[ true, true, false ]

Compartir por