QUOTE_LITERAL 関数

QUOTE_LITERAL 関数は、指定された文字列を一重引用符付き文字列として返します。これにより、SQL ステートメントで文字列リテラルとして使用できます。入力パラメータが数値である場合、QUOTE_LITERAL はそれを文字列として扱います。埋め込まれている一重引用符およびバックスラッシュは適宜、二重引用符に変更されます。

構文

QUOTE_LITERAL(string)

引数

string

CHAR または VARCHAR 文字列。

戻り型

QUOTE_LITERAL 関数は、入力 string と同じデータ型である CHAR または VARCHAR の文字列を返します。

例

一重引用符を付けて文字列 ''CAT'' を返すには、次の例を使用します。

SELECT QUOTE_LITERAL('''CAT''');

+---------------+
| quote_literal |
+---------------+
| '''CAT'''     |
+---------------+

次の例では、TICKIT サンプルデータベースの CATEGORY テーブルからのデータを使用します。詳細については、「サンプルデータベース」を参照してください。

CATNAME 列を一重引用符で囲んで返すには、次の例を使用します。

SELECT catid, QUOTE_LITERAL(catname)
FROM category
ORDER BY 1,2;

+-------+---------------+
| catid | quote_literal |
+-------+---------------+
|     1 | 'MLB'         |
|     2 | 'NHL'         |
|     3 | 'NFL'         |
|     4 | 'NBA'         |
|     5 | 'MLS'         |
|     6 | 'Musicals'    |
|     7 | 'Plays'       |
|     8 | 'Opera'       |
|     9 | 'Pop'         |
|    10 | 'Jazz'        |
|    11 | 'Classical'   |
+-------+---------------+

CATID 列を一重引用符で囲んで返すには、次の例を使用します。

SELECT QUOTE_LITERAL(catid), catname
FROM category
ORDER BY 1,2;

+---------------+-----------+
| quote_literal |  catname  |
+---------------+-----------+
| '1'           | MLB       |
| '10'          | Jazz      |
| '11'          | Classical |
| '2'           | NHL       |
| '3'           | NFL       |
| '4'           | NBA       |
| '5'           | MLS       |
| '6'           | Musicals  |
| '7'           | Plays     |
| '8'           | Opera     |
| '9'           | Pop       |
+---------------+-----------+