- Catégories :
TO_BOOLEAN¶
Convertit le texte d’entrée ou l’expression numérique en valeur BOOLEAN.
- Voir aussi :
Syntaxe¶
TO_BOOLEAN( <string_or_numeric_expr> )
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) etINF
(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;
+-------+------+------+
| 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;
+------+---------------+
| 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;
+------+---------------+
| N | TO_BOOLEAN(N) |
|------+---------------|
| 1 | True |
| 0 | False |
| NULL | NULL |
+------+---------------+