sesam_rollback
(PHP 3 CVS only)
sesam_rollback -- Discard any pending updates to the SESAM
database
Description
bool sesam_rollback ( void )
Returns: TRUE on success, FALSE on errors
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.
See also: sesam_commit(). Example 1. Discarding an update
to the SESAM database
<?php
if (sesam_connect ("mycatalog", "myschema",
"otto")) {
if (sesam_execimm ("INSERT INTO mytable VALUES (*,
'Small Test', <0, 8, 15>)")
&& sesam_execimm ("INSERT INTO othertable VALUES
(*, 'Another Test', 1)")) {
sesam_commit();
} else {
sesam_rollback();
}
}
?>
sesam_seek_row
(PHP 3 CVS only)
sesam_seek_row -- Set scrollable cursor mode for subsequent
fetches
Description
bool sesam_seek_row ( string result_id, int whence [, int
offset])
result_id is a valid result id (select type queries only,
and only if a "scrollable" cursor was requested
when calling sesam_query()).
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:
Table 1. Valid values for "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 is an optional parameter which is only evaluated
(and required) if whence is either SESAM_SEEK_RELATIVE or
SESAM_SEEK_ABSOLUTE.
