summaryrefslogtreecommitdiff
path: root/ext/pdo/php_pdo_driver.h
diff options
context:
space:
mode:
authorGeorge Peter Banyard <girgias@php.net>2020-12-23 01:48:58 +0100
committerGeorge Peter Banyard <girgias@php.net>2021-01-06 10:20:57 +0000
commitca5fcb83bfb54e930736f6fdf31ffbae6c479f78 (patch)
tree744cb52ab582ea804c72cd7b556810b9a110fec0 /ext/pdo/php_pdo_driver.h
parent01c8fe8fc030f488985f72d886eedd44209e1b96 (diff)
downloadphp-git-ca5fcb83bfb54e930736f6fdf31ffbae6c479f78.tar.gz
Add/expand comments for PDO handlers
Diffstat (limited to 'ext/pdo/php_pdo_driver.h')
-rw-r--r--ext/pdo/php_pdo_driver.h6
1 files changed, 5 insertions, 1 deletions
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