Categorias:

Funções de conversão

TRY_TO_BOOLEAN

Uma versão especial de TO_BOOLEAN que executa a mesma operação (ou seja, converte uma expressão de entrada em um valor booliano), mas com suporte para tratamento de erros. Se a conversão não puder ser realizada, TRY_TO_BOOLEAN retornará um valor NULL em vez de gerar um erro.

Para obter mais informações, consulte Funções de conversão de tratamento de erros.

Sintaxe

TRY_TO_BOOLEAN( <string_expr> )
Copy

Argumentos

string_expr

Uma expressão de cadeia de caracteres que pode ser avaliada como um valor BOOLEAN.

Retornos

Esta função retorna um valor do tipo BOOLEAN.

Notas de uso

O argumento de entrada deve ser uma expressão de cadeia de caracteres. A função avalia a expressão de cadeia de caracteres da seguinte forma:

  • 'true', 't', 'yes', 'y', 'on', '1' retornam TRUE.

  • 'false', 'f', 'no', 'n', 'off', '0' retornam FALSE.

  • Todas as outras cadeias de caracteres retornam NULL.

As avaliações das cadeias de caracteres não diferenciam maiúsculas de minúsculas.

Exemplos

Este exemplo usa a função TRY_TO_BOOLEAN.

SELECT TRY_TO_BOOLEAN('True')  AS "T",
       TRY_TO_BOOLEAN('False') AS "F",
       TRY_TO_BOOLEAN('Not valid')  AS "N";
Copy
+------+-------+------+
| T    | F     | N    |
|------+-------+------|
| True | False | NULL |
+------+-------+------+

Para obter mais exemplos, consulte TO_BOOLEAN.