- Categorias:
TO_BOOLEAN¶
Converte o texto de entrada ou a expressão numérica em um valor BOOLEAN.
- Consulte também:
Sintaxe¶
TO_BOOLEAN( <string_or_numeric_expr> )
Argumentos¶
string_or_numeric_expr
Uma expressão de cadeia de caracteres ou expressão numérica que pode ser avaliada em um valor BOOLEAN.
Retornos¶
Retorna um valor BOOLEAN ou NULL.
Retorna TRUE se
string_or_numeric_expr
for avaliado como TRUE.Retorna FALSE se
string_or_numeric_expr
for avaliado como FALSE.Se a entrada for NULL, retorna NULL sem relatar um erro.
Notas de uso¶
Para uma expressão de cadeia de caracteres:
'true'
,'t'
,'yes'
,'y'
,'on'
,'1'
retornam TRUE.'false'
,'f'
,'no'
,'n'
,'off'
,'0'
retornam FALSE.Todas as outras cadeias de caracteres retornam um erro.
As avaliações das cadeias de caracteres não diferenciam maiúsculas de minúsculas.
Para uma expressão numérica:
0
retorna FALSE.Todos os valores numéricos diferentes de zero retornam TRUE.
Ao converter do tipo de dados FLOAT, os valores não numéricos, como
NaN
(não é um número) eINF
(infinito), retornam um erro.
Exemplos¶
Os exemplos a seguir usam a função TO_BOOLEAN.
Criar uma tabela e inserir dados:
CREATE OR REPLACE TABLE test_boolean(
b BOOLEAN,
n NUMBER,
s STRING);
INSERT INTO test_boolean VALUES
(true, 1, 'yes'),
(false, 0, 'no'),
(null, null, null);
SELECT * FROM test_boolean;
+-------+------+------+
| B | N | S |
|-------+------+------|
| True | 1 | yes |
| False | 0 | no |
| NULL | NULL | NULL |
+-------+------+------+
Converta uma cadeia de caracteres de texto em um valor BOOLEAN:
SELECT s, TO_BOOLEAN(s) FROM test_boolean;
+------+---------------+
| S | TO_BOOLEAN(S) |
|------+---------------|
| yes | True |
| no | False |
| NULL | NULL |
+------+---------------+
Converta um número em um valor BOOLEAN:
SELECT n, TO_BOOLEAN(n) FROM test_boolean;
+------+---------------+
| N | TO_BOOLEAN(N) |
|------+---------------|
| 1 | True |
| 0 | False |
| NULL | NULL |
+------+---------------+