TO_BOOLEAN¶

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) e INF (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 | +------+---------------+