Catégories :

Fonctions de conversion

TO_BOOLEAN

Convertit le texte d’entrée ou l’expression numérique en valeur BOOLEAN.

Voir aussi :

TRY_TO_BOOLEAN

Syntaxe

TO_BOOLEAN( <string_or_numeric_expr> )
Copy

Arguments

string_or_numeric_expr

Expression de chaîne ou expression numérique pouvant correspondre à une valeur BOOLEAN.

Renvoie

Renvoie une valeur BOOLEAN ou NULL.

  • Renvoie TRUE si string_or_numeric_expr correspond à TRUE.

  • Renvoie FALSE si string_or_numeric_expr correspond à FALSE.

  • Si l’entrée est NULL, renvoie NULL sans signaler d’erreur.

Notes sur l’utilisation

  • Pour une expression de chaîne :

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

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

    • Toutes les autres chaînes renvoient une erreur.

    Les évaluations des chaînes sont insensibles à la casse.

  • Pour une expression numérique :

    • 0 renvoie FALSE.

    • Toutes les valeurs numériques non nulles renvoient TRUE.

    • Lors de la conversion à partir du type de données FLOAT, les valeurs non numériques, telles que NaN (pas un nombre) et INF (infini), renvoient une erreur.

Exemples

Les exemples suivants utilisent la fonction TO_BOOLEAN.

Créer une table et insérer des données :

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;
Copy
+-------+------+------+
| B     |    N | S    |
|-------+------+------|
| True  |    1 | yes  |
| False |    0 | no   |
| NULL  | NULL | NULL |
+-------+------+------+

Convertir une chaîne de texte en une valeur BOOLEAN :

SELECT s, TO_BOOLEAN(s) FROM test_boolean;
Copy
+------+---------------+
| S    | TO_BOOLEAN(S) |
|------+---------------|
| yes  | True          |
| no   | False         |
| NULL | NULL          |
+------+---------------+

Convertir un nombre en une valeur BOOLEAN :

SELECT n, TO_BOOLEAN(n) FROM test_boolean;
Copy
+------+---------------+
|    N | TO_BOOLEAN(N) |
|------+---------------|
|    1 | True          |
|    0 | False         |
| NULL | NULL          |
+------+---------------+