- カテゴリ:
TO_BOOLEAN¶
入力テキストまたは数値式を BOOLEAN 値に変換します。
- こちらもご参照ください。
構文¶
TO_BOOLEAN( <string_or_numeric_expr> )
引数¶
string_or_numeric_expr
BOOLEAN 値に評価できる文字列式または数値式。
戻り値¶
BOOLEAN 値または NULL を返します。
string_or_numeric_expr
が TRUE と評価された場合は、 TRUE を返します。string_or_numeric_expr
が FALSE と評価された場合は、 FALSE を返します。入力が NULL の場合は、エラーを報告せずに NULL を返します。
使用上の注意¶
文字列式の場合、
'true'
、't'
、'yes'
、'y'
、'on'
、'1'
は TRUEを返します。'false'
、'f'
、'no'
、'n'
、'off'
、'0'
は FALSEを返します。他のすべての文字列はエラーを返します。
文字列の評価は大文字と小文字を区別しません。
数値式の場合:
0
は、 FALSE を返します。ゼロ以外のすべての数値は TRUE を返します。
FLOAT データ型から変換する場合、
NaN
(非数値)やINF
(無限大)のような数値以外の値はエラーを返します。
例¶
以下の例では、 TO_BOOLEAN 関数を使用しています。
テーブルを作成してデータを挿入します。
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 |
+-------+------+------+
文字列を BOOLEAN 値に変換します。
SELECT s, TO_BOOLEAN(s) FROM test_boolean;
+------+---------------+
| S | TO_BOOLEAN(S) |
|------+---------------|
| yes | True |
| no | False |
| NULL | NULL |
+------+---------------+
数値を BOOLEAN 値に変換します。
SELECT n, TO_BOOLEAN(n) FROM test_boolean;
+------+---------------+
| N | TO_BOOLEAN(N) |
|------+---------------|
| 1 | True |
| 0 | False |
| NULL | NULL |
+------+---------------+