From ca5fcb83bfb54e930736f6fdf31ffbae6c479f78 Mon Sep 17 00:00:00 2001 From: George Peter Banyard Date: Wed, 23 Dec 2020 01:48:58 +0100 Subject: Add/expand comments for PDO handlers --- ext/pdo/php_pdo_driver.h | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'ext/pdo/php_pdo_driver.h') diff --git a/ext/pdo/php_pdo_driver.h b/ext/pdo/php_pdo_driver.h index ea78eb187d..8345d7f81e 100644 --- a/ext/pdo/php_pdo_driver.h +++ b/ext/pdo/php_pdo_driver.h @@ -255,7 +255,11 @@ typedef char *(*pdo_dbh_last_id_func)(pdo_dbh_t *dbh, const char *name, size_t * * specific data ... */ typedef int (*pdo_dbh_fetch_error_func)(pdo_dbh_t *dbh, pdo_stmt_t *stmt, zval *info); -/* fetching of attributes */ +/* fetching of attributes + * There are 3 return states: + * * -1 for errors while retrieving a valid attribute + * * 0 for attempting to retrieve an attribute which is not supported by the driver + * * any other value for success, *val must be set to the attribute value */ typedef int (*pdo_dbh_get_attr_func)(pdo_dbh_t *dbh, zend_long attr, zval *val); /* checking/pinging persistent connections; return SUCCESS if the connection -- cgit v1.2.1