APIリファレンス
GDSQLiteStatement
一度prepareで解析し、値を変えて繰り返し実行できるSQLiteのSQL文です。
メソッド
run(params: Array = []) -> Dictionary, Errrun_many(rows: Array) -> Dictionary, Errone(params: Array = []) -> Variant, Errall(params: Array = []) -> Array, Errclose() -> voidis_valid() -> bool
run
run(params: Array = []) -> Dictionary, Err英語原文Execute a write statement and return affected rows.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
params | Array | [] | 事前に解析したSQL文のプレースホルダーに渡す値。 |
戻り値
Dictionary, Err
エラー
処理結果とエラー情報(Err)を返します。Errがnullなら成功です。失敗時にも途中までの結果が残る場合があるため、値を使う前にErrを確認してください。結果とErrを返す関数の中では、?でエラーをそのまま呼び出し元へ返せます。!はエラー時にプログラムを終了します。gd serveでは、そのリクエストの処理だけが終了します。
run_many
run_many(rows: Array) -> Dictionary, Err英語原文Execute a write statement for multiple argument sets.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
rows | Array | 省略不可 | 入力順の行。データベースの一括実行では各行が1組のパラメーターです。 |
戻り値
Dictionary, Err
エラー
処理結果とエラー情報(Err)を返します。Errがnullなら成功です。失敗時にも途中までの結果が残る場合があるため、値を使う前にErrを確認してください。結果とErrを返す関数の中では、?でエラーをそのまま呼び出し元へ返せます。!はエラー時にプログラムを終了します。gd serveでは、そのリクエストの処理だけが終了します。
one
one(params: Array = []) -> Variant, Err先頭行とErrを返します。行がなければErr.NOT_FOUNDを返します。
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
params | Array | [] | 事前に解析したSQL文のプレースホルダーに渡す値。 |
戻り値
Variant, Err
エラー
処理結果とエラー情報(Err)を返します。Errがnullなら成功です。失敗時にも途中までの結果が残る場合があるため、値を使う前にErrを確認してください。結果とErrを返す関数の中では、?でエラーをそのまま呼び出し元へ返せます。!はエラー時にプログラムを終了します。gd serveでは、そのリクエストの処理だけが終了します。
all
all(params: Array = []) -> Array, Err英語原文Return all read-only query rows.
引数
| 名前 | 型 | 省略時の値 | 説明 |
|---|---|---|---|
params | Array | [] | 事前に解析したSQL文のプレースホルダーに渡す値。 |
戻り値
Array, Err
エラー
処理結果とエラー情報(Err)を返します。Errがnullなら成功です。失敗時にも途中までの結果が残る場合があるため、値を使う前にErrを確認してください。結果とErrを返す関数の中では、?でエラーをそのまま呼び出し元へ返せます。!はエラー時にプログラムを終了します。gd serveでは、そのリクエストの処理だけが終了します。
close
close() -> void英語原文Release the prepared statement explicitly.
引数
引数はありません。
戻り値
void
値を返しません。
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。
is_valid
is_valid() -> bool英語原文Check whether both statement and connection are usable.
引数
引数はありません。
戻り値
bool
エラー
この関数は、結果とは別にErrを返す形式ではありません。結果の確認方法は、この関数の説明を参照してください。