MySQL :: MySQL 8.4 C API 開發人員指南 :: 6.4.5 mysql_stmt_bind_param()

版本 8.4

MySQL 8.4 C API 開發人員指南 / ... / mysql_stmt_bind_param()

6.4.5 mysql_stmt_bind_param()

bool
mysql_stmt_bind_param(MYSQL_STMT *stmt,
                      MYSQL_BIND *bind)

描述

mysql_stmt_bind_param() 用於繫結傳遞給 mysql_stmt_prepare() 之 SQL 語句中參數標記的輸入資料。它使用 MYSQL_BIND 結構來提供資料。bind 是 MYSQL_BIND 結構陣列的位址。用戶端程式庫預期陣列包含查詢中存在的每個 ? 參數標記的一個元素。

假設您準備了以下語句

INSERT INTO mytbl VALUES(?,?,?)

當您繫結參數時，MYSQL_BIND 結構的陣列必須包含三個元素，並且可以像這樣宣告

MYSQL_BIND bind[3];

如需 MYSQL_BIND 結構的成員以及它們應如何設定以提供輸入值的描述，請參閱第 6.2 節，「C API 預處理語句資料結構」。

傳回值

成功時傳回零。發生錯誤時傳回非零值。

錯誤

CR_UNSUPPORTED_PARAM_TYPE

不支援轉換。可能是 buffer_type 值無效或不是支援的類型之一。
CR_OUT_OF_MEMORY

記憶體不足。
CR_UNKNOWN_ERROR

發生未知的錯誤。

範例

請參閱第 6.4.11 節，「mysql_stmt_execute()」中的範例。