From ce5d09156a851a92345806df63de5d33445b971d Mon Sep 17 00:00:00 2001 From: Philip Olson Date: Thu, 20 Mar 2008 01:26:26 +0000 Subject: [PATCH] removed dead sesam docs git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@255534 c90b9560-bf6c-de11-be94-00142212c4b1 --- reference/sesam/functions/sesam-query.xml | 169 ------------------ reference/sesam/functions/sesam-rollback.xml | 88 --------- reference/sesam/functions/sesam-seek-row.xml | 151 ---------------- .../sesam/functions/sesam-settransaction.xml | 167 ----------------- 4 files changed, 575 deletions(-) delete mode 100644 reference/sesam/functions/sesam-query.xml delete mode 100644 reference/sesam/functions/sesam-rollback.xml delete mode 100644 reference/sesam/functions/sesam-seek-row.xml delete mode 100644 reference/sesam/functions/sesam-settransaction.xml diff --git a/reference/sesam/functions/sesam-query.xml b/reference/sesam/functions/sesam-query.xml deleted file mode 100644 index c4690b32f7..0000000000 --- a/reference/sesam/functions/sesam-query.xml +++ /dev/null @@ -1,169 +0,0 @@ - - - - - sesam_query - Perform a SESAM SQL query and prepare the result - - - - &reftitle.description; - - stringsesam_query - stringquery - boolscrollable - - - sesam_query sends a query to the currently - active database on the server. It can execute both "immediate" - SQL statements and "select type" queries. If an "immediate" - statement is executed, then no cursor is allocated, and any - subsequent sesam_fetch_row or - sesam_fetch_result call will return an empty - result (zero columns, indicating end-of-result). - - - When using "scrollable" cursors, the cursor can be freely - positioned on the result set. For each "scrollable" query, there - are global default values for the scrolling type (initialized to: - SESAM_SEEK_NEXT) and the scrolling offset - which can either be set once by - sesam_seek_row or each time when fetching a - row using sesam_fetch_row. - - - For "immediate" statements, the number of affected rows is saved - for retrieval by the sesam_affected_rows - function. - - - - - &reftitle.parameters; - - - - query - - - The query statement. - - - - - scrollable - - - For "select type" statements, a result descriptor and a (scrollable or - sequential, depending on the optional boolean - scrollable parameter) cursor will be allocated. - If scrollable is omitted, the cursor will be - sequential. - - - - - - - - - &reftitle.returnvalues; - - Returns a SESAM "result identifier" on success, or &false; on error. This - result id is used by the other functions. - - - - - &reftitle.examples; - - - - Show all rows of the "phone" table as a HTML table - - -\n"; -// Add title header with column names above the result: -if ($cols = sesam_field_array($result)) { - echo "Result:\n"; - echo "\n"; - for ($col = 0; $col < $cols["count"]; ++$col) { - $colattr = $cols[$col]; - /* Span the table head over SESAM's "Multiple Fields": */ - if ($colattr["count"] > 1) { - echo "" . $colattr["name"] . - "(1.." . $colattr["count"] . ")\n"; - $col += $colattr["count"] - 1; - } else - echo "" . $colattr["name"] . "\n"; - } - echo "\n"; -} - -do { - // Fetch the result in chunks of 100 rows max. - $ok = sesam_fetch_result($result, 100); - for ($row=0; $row < $ok["rows"]; ++$row) { - echo " \n"; - for ($col = 0; $col < $ok["cols"]; ++$col) { - if (isset($ok[$col][$row])) { - echo "" . $ok[$col][$row] . "\n"; - } else { - echo "-empty-\n"; - } - } - echo "\n"; - } -} while ($ok["truncated"]); // while there may be more data - -echo "\n"; -// free result id -sesam_free_result($result); -?> -]]> - - - - - - - &reftitle.seealso; - - - sesam_fetch_row - sesam_fetch_result - - - - - - - diff --git a/reference/sesam/functions/sesam-rollback.xml b/reference/sesam/functions/sesam-rollback.xml deleted file mode 100644 index 7329f8ff4b..0000000000 --- a/reference/sesam/functions/sesam-rollback.xml +++ /dev/null @@ -1,88 +0,0 @@ - - - - - sesam_rollback - Discard any pending updates to the SESAM database - - - - &reftitle.description; - - boolsesam_rollback - - - - sesam_rollback discards any pending updates - to the database. Also affected are result cursors and result - descriptors. - - - At the end of each script, and as part of the - sesam_disconnect function, an implied - sesam_rollback is executed, discarding any - pending changes to the database. - - - - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.examples; - - - Discarding an update to the SESAM database - -)") - && sesam_execimm ("INSERT INTO othertable VALUES (*, 'Another Test', 1)")) { - sesam_commit(); - } else { - sesam_rollback(); - } -} -?> -]]> - - - - - - - &reftitle.seealso; - - - sesam_commit - - - - - - - diff --git a/reference/sesam/functions/sesam-seek-row.xml b/reference/sesam/functions/sesam-seek-row.xml deleted file mode 100644 index 6f1fd72f36..0000000000 --- a/reference/sesam/functions/sesam-seek-row.xml +++ /dev/null @@ -1,151 +0,0 @@ - - - - - sesam_seek_row - Set scrollable cursor mode for subsequent fetches - - - - &reftitle.description; - - boolsesam_seek_row - stringresult_id - intwhence - intoffset - - - Sets the scrollable cursor mode for subsequent fetches. - - - - - &reftitle.parameters; - - - - result_id - - - result_id is a valid result id (select - type queries only, and only if a "scrollable" cursor was - requested when calling sesam_query). - - - - - whence - - - whence sets the global default value for the - scrolling type, it specifies the scroll type to use in subsequent - fetch operations on "scrollable" cursors, which can be set to the - following predefined constants: - - Valid values for <parameter>whence</parameter> - - - - Value - Constant - Meaning - - - - - 0 - SESAM_SEEK_NEXT - read sequentially - - - - 1 - SESAM_SEEK_PRIOR - read sequentially backwards - - - - 2 - SESAM_SEEK_FIRST - - fetch first row (after fetch, the default is set to - SESAM_SEEK_NEXT) - - - - 3 - SESAM_SEEK_LAST - - fetch last row (after fetch, the default is set to - SESAM_SEEK_PRIOR) - - - - 4 - SESAM_SEEK_ABSOLUTE - - fetch absolute row number given as - offset (Zero-based. After fetch, the - default is set to SESAM_SEEK_ABSOLUTE, - and the offset value is auto-incremented) - - - - 5 - SESAM_SEEK_RELATIVE - - fetch relative to current scroll position, where - offset can be a positive or negative - offset value (this also sets the default "offset" value for - subsequent fetches). - - - - -
- - - - - offset - - - An optional parameter which is only evaluated (and required) if - whence is either - SESAM_SEEK_RELATIVE or - SESAM_SEEK_ABSOLUTE. - - - - - - - - - &reftitle.returnvalues; - - &return.success; - - - - - diff --git a/reference/sesam/functions/sesam-settransaction.xml b/reference/sesam/functions/sesam-settransaction.xml deleted file mode 100644 index f2f5c15ad3..0000000000 --- a/reference/sesam/functions/sesam-settransaction.xml +++ /dev/null @@ -1,167 +0,0 @@ - - - - - sesam_settransaction - Set SESAM transaction parameters - - - - &reftitle.description; - - boolsesam_settransaction - intisolation_level - intread_only - - - Overrides the default values for the isolation level - and read-only transaction parameters (which are set in - the SESAM configuration file), in order to optimize subsequent queries and - guarantee database consistency. The overridden values are used for the - next transaction only. See the SESAM handbook for detailed explanation of - the semantics. - - - This function can only be called before starting a transaction, not after - the transaction has been started already. - - - The values set by sesam_settransaction will override - the default setting specified in the SESAM configuration file. - - - - - &reftitle.parameters; - - - - isolation_level - - - - - Valid values for <parameter>isolation_level</parameter> - parameter - - - - - Value - Constant - Meaning - - - - - 1 - SESAM_TXISOL_READ_UNCOMMITTED - Read Uncommitted - - - 2 - SESAM_TXISOL_READ_COMMITTED - Read Committed - - - 3 - SESAM_TXISOL_REPEATABLE_READ - Repeatable Read - - - 4 - SESAM_TXISOL_SERIALIZABLE - Serializable - - - -
- - - - - read_only - - - - - Valid values for <parameter>read_only</parameter> parameter - - - - - Value - Constant - Meaning - - - - - 0 - SESAM_TXREAD_READWRITE - Read/Write - - - 1 - SESAM_TXREAD_READONLY - Read-Only - - - -
- - - - - - - - - &reftitle.returnvalues; - - Returns &true; if the values are valid, and the - settransaction operation was successful, &false; - otherwise. - - - - - &reftitle.examples; - - - Setting SESAM transaction parameters - - -]]> - - - - - - - -