From 2df9f94a9201b7907015624dbebd70af44296f33 Mon Sep 17 00:00:00 2001 From: Branden J Brown Date: Tue, 3 Mar 2026 23:33:22 -0500 Subject: [PATCH] docs on bind functions --- sqlite/sqlite3.kk | 30 ++++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) diff --git a/sqlite/sqlite3.kk b/sqlite/sqlite3.kk index 18537e0..66023ba 100644 --- a/sqlite/sqlite3.kk +++ b/sqlite/sqlite3.kk @@ -169,20 +169,30 @@ pub fun statement/int(stmt: statement, col: int): int pub fun statement/text(stmt: statement, col: int): string capi/column-text(stmt.cref, col.int32) -pub fun statement/bind-float64(stmt: statement, col: int, value: float64): sqlite-result - capi/bind-double(stmt.cref, col.int32, value).trusted-result +// Bind a float64 value to a statement parameter. +// The first pararmeter number is 1. +pub fun statement/bind-float64(stmt: statement, param: int, value: float64): sqlite-result + capi/bind-double(stmt.cref, param.int32, value).trusted-result -pub fun statement/bind-int64(stmt: statement, col: int, value: int64): sqlite-result - capi/bind-int64(stmt.cref, col.int32, value).trusted-result +// Bind an int64 value to a statement parameter. +// The first parameter number is 1. +pub fun statement/bind-int64(stmt: statement, param: int, value: int64): sqlite-result + capi/bind-int64(stmt.cref, param.int32, value).trusted-result -pub fun statement/bind-null(stmt: statement, col: int): sqlite-result - capi/bind-null(stmt.cref, col.int32).trusted-result +// Bind NULL to a statement parameter. +// The first parameter number is 1. +pub fun statement/bind-null(stmt: statement, param: int): sqlite-result + capi/bind-null(stmt.cref, param.int32).trusted-result -pub fun statement/bind-text(stmt: statement, col: int, value: string): sqlite-result - capi/bind-text(stmt.cref, col.int32, value).trusted-result +// Bind a string to a statement parameter. +// The first parameter number is 1. +pub fun statement/bind-text(stmt: statement, param: int, value: string): sqlite-result + capi/bind-text(stmt.cref, param.int32, value).trusted-result -pub fun statement/bind-zeroblob(stmt: statement, col: int, length: int64): sqlite-result - capi/bind-zeroblob(stmt.cref, col.int32, length).trusted-result +// Bind a BLOB value initialized to `length` zeros to a statement parameter. +// The first parameter number is 1. +pub fun statement/bind-zeroblob(stmt: statement, param: int, length: int64): sqlite-result + capi/bind-zeroblob(stmt.cref, param.int32, length).trusted-result // Set all bound parameters to NULL. pub fun statement/clear-bindings(stmt: statement): sqlite-result