mysql_stmt_close(3)

mysql_stmt_close3

Name

mysql_stmt_close - Closes a prepared statement

Synopsis

#include <mysql.h>
my_bool mysql_stmt_close(MYSQL_STMT * stmt);

Description

Closes a prepared statement and deallocates the statement handle. If the current statement has pending or unread results, this function cancels them so that the next query can be executed.

Parameter

•

stmt - a statement handle, which was previously allocated by mysql_stmt_init(3).

Return value

Returns zero on success, nonzero on error (when communicating with the server). The statement is deallocated, regardless of the error.

Notes

•

If you want to reuse the statement handle with a different SQL command, use mysql_stmt_reset(3).

See Also

•

mysql_stmt_init(3)

•

mysql_stmt_reset(3)

Releases

3 releases since Debian 12 (Bookworm); the text changed 1 time.

  1. 12
  2. 13–Arch

From mariadb 13.0.2-2 in Arch Linux 2026-11-01. Also shipped by mariadb-lts. Parsed by carta from the page's man source.