asSqlString
与えられた文字列をSQLの文字列リテラルを表す文字列に変換します。
info
- 値の変換には
asSqlValue()を、識別子の変換にはasSqlIdentifier()をそれぞれ利用できます。
構文
asSqlString(rawString) => string
asSqlString(rawString, useSingleQuote) => string
引数
-
rawString:stringSQLの文字列リテラルへ変換する文字列です。
-
useSingleQuote:boolean|undefined(省略可)引用符が必要な識別子に単引用符(
")を使うかどうかです。trueなら単引用符を使い、falseなら二重引用符(")を使います。この引数の指定は任意です。指定がない場合、単引用符を使います(
true)。
返値: string
変換結果の文字列です。
引数 rawString を引用符で囲んだ値が返ります。
使用する引用符は引数 useSingleQuote の値によって異なり、true なら単引用符(')を、false なら二重引用符(")を使います。
引数 rawString に引用符が含まれる場合、useSingleQuote が true なら単引用符を '' に、useSingleQuote が false なら二重引用符を "" にそれぞれ置換します。
note
- 予期しない値の衝突を防ぐため、引用符のエスケープは常に行われます。
解説
与えられた文字列をSQLの文字列リテラルを表す文字列に変換します。
SQL文の中で文字列リテラルを要求する箇所に値を挿入する際に利用できます。