Edit File - File Manager

Edit File: seq_class.html

<html>
<head>
<title>Berkeley DB: db_sequence_create</title>
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++">
</head>
<body bgcolor=white>
<table width="100%"><tr valign=top>
<td>
db_sequence_create
</td>
<td align=right>
<a href="../../db4-devel-4.7.25/api_c/api_core.html"><img src="../../db4-devel-4.7.25/images/api.gif" alt="API"></a>
<a href="../../db4-devel-4.7.25/ref/toc.html"><img src="../../db4-devel-4.7.25/images/ref.gif" alt="Ref"></a></td>
</tr></table>
<hr size=1 noshade>
<tt>
<pre>
#include &lt;db.h&gt;

typedef struct __db_sequence DB_SEQUENCE;

int
db_sequence_create(DB_SEQUENCE **seq, DB *db, u_int32_t flags);
</pre>
<hr size=1 noshade>
Description: db_sequence_create
The DB_SEQUENCE handle is the handle used to manipulate a
sequence object. A sequence object is stored in a record in a
database.
DB_SEQUENCE handles are free-threaded if the <a href="../../db4-devel-4.7.25/api_c/env_open.html#DB_THREAD">DB_THREAD</a>
flag is specified to the <a href="../../db4-devel-4.7.25/api_c/seq_open.html">DB_SEQUENCE-&gt;open</a> method when the sequence is opened.
Once the <a href="../../db4-devel-4.7.25/api_c/seq_close.html">DB_SEQUENCE-&gt;close</a> or <a href="../../db4-devel-4.7.25/api_c/seq_remove.html">DB_SEQUENCE-&gt;remove</a> methods are called, the
handle may not be accessed again, regardless of the method's return.
Each handle opened on a sequence may maintain a separate cache of values
which are returned to the application using the <a href="../../db4-devel-4.7.25/api_c/seq_get.html">DB_SEQUENCE-&gt;get</a> method
either singly or in groups depending on its delta parameter.
The
DB_SEQUENCE method creates a
DB_SEQUENCE object that serves as the handle for a sequence.
Calling the <a href="../../db4-devel-4.7.25/api_c/seq_close.html">DB_SEQUENCE-&gt;close</a> or <a href="../../db4-devel-4.7.25/api_c/seq_remove.html">DB_SEQUENCE-&gt;remove</a> methods will discard the
handle.
The db_sequence_create method
returns a non-zero error value on failure
and 0 on success.

Parameters 
 seq<ul compact><li>The seq parameter references the memory into which the returned
structure pointer is stored.</ul>
 db<ul compact><li>The db parameter is an open database handle which holds the
persistent data for the sequence. The database may be of any type,
but may not have been configured to support duplicate data items.</ul>
 flags<ul compact><li>The flags parameter is currently unused, and must be set to 0.</ul>
 
 Errors
The db_sequence_create method
may fail and return one of the following non-zero errors:
 
EINVAL<ul compact><li>An
invalid flag value or parameter was specified.</ul>
 
<hr size=1 noshade>
 Class
DB_SEQUENCE
 See Also
<a href="../../db4-devel-4.7.25/api_c/seq_list.html">Sequences and Related Methods</a>
</tt>
<table width="100%"><tr><td> </td><td align=right>
<a href="../../db4-devel-4.7.25/api_c/api_core.html"><img src="../../db4-devel-4.7.25/images/api.gif" alt="API"></a><a href="../../db4-devel-4.7.25/ref/toc.html"><img src="../../db4-devel-4.7.25/images/ref.gif" alt="Ref"></a>
</td></tr></table>
Copyright (c) 1996,2008 Oracle. All rights reserved.
</body>
</html>

Back to File Manager