~ubuntu-branches/ubuntu/natty/evolution-data-server/natty

« back to all changes in this revision

Viewing changes to libdb/docs/api_java/dbt_bulk_class.html

  • Committer: Bazaar Package Importer
  • Author(s): Didier Roche
  • Date: 2010-05-17 17:02:06 UTC
  • mfrom: (1.1.79 upstream) (1.6.12 experimental)
  • Revision ID: james.westby@ubuntu.com-20100517170206-4ufr52vwrhh26yh0
Tags: 2.30.1-1ubuntu1
* Merge from debian experimental. Remaining change:
  (LP: #42199, #229669, #173703, #360344, #508494)
  + debian/control:
    - add Vcs-Bzr tag
    - don't use libgnome
    - Use Breaks instead of Conflicts against evolution 2.25 and earlier.
  + debian/evolution-data-server.install,
    debian/patches/45_libcamel_providers_version.patch:
    - use the upstream versioning, not a Debian-specific one 
  + debian/libedata-book1.2-dev.install, debian/libebackend-1.2-dev.install,
    debian/libcamel1.2-dev.install, debian/libedataserverui1.2-dev.install:
    - install html documentation
  + debian/rules:
    - don't build documentation it's shipped with the tarball

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!--$Id$-->
2
 
<!--Copyright 1997-2002 by Sleepycat Software, Inc.-->
3
 
<!--All rights reserved.-->
4
 
<!--See the file LICENSE for redistribution information.-->
5
 
<html>
6
 
<head>
7
 
<title>Berkeley DB: DbMultipleDataIterator</title>
8
 
<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit.">
9
 
<meta name="keywords" content="embedded,database,programmatic,toolkit,b+tree,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,java,C,C++">
10
 
</head>
11
 
<body bgcolor=white>
12
 
<a name="2"><!--meow--></a>
13
 
<table width="100%"><tr valign=top>
14
 
<td>
15
 
<h1>DbMultipleDataIterator</h1>
16
 
</td>
17
 
<td align=right>
18
 
<a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a>
19
 
</td></tr></table>
20
 
<hr size=1 noshade>
21
 
<tt>
22
 
<h3><pre>
23
 
import com.sleepycat.db.*;
24
 
<p>
25
 
public class DbMultipleDataIterator
26
 
{
27
 
        public DbMultipleDataIterator(Dbt data);
28
 
<p>
29
 
        public boolean next(Dbt data);
30
 
}
31
 
<p>
32
 
public class DbMultipleKeyDataIterator
33
 
{
34
 
        public DbMultipleKeyDataIterator(Dbt data);
35
 
<p>
36
 
        public boolean next(Dbt key, Dbt data);
37
 
}
38
 
<p>
39
 
public class DbMultipleRecnoDataIterator
40
 
{
41
 
        public DbMultipleRecnoDataIterator(Dbt data);
42
 
<p>
43
 
        public boolean next(Dbt key, Dbt data);
44
 
}
45
 
</pre></h3>
46
 
<h1>Description</h1>
47
 
<p>If either of the <a href="../api_java/dbc_get.html#DB_MULTIPLE">Db.DB_MULTIPLE</a> or <a href="../api_java/dbc_get.html#DB_MULTIPLE_KEY">Db.DB_MULTIPLE_KEY</a> flags
48
 
were specified to the <a href="../api_java/db_get.html">Db.get</a> or <a href="../api_java/dbc_get.html">Dbc.get</a> method, the data
49
 
<a href="../api_java/dbt_class.html">Dbt</a> returned by those interfaces will refer to a buffer that
50
 
is filled with data.  Access to that data is through the following
51
 
classes.
52
 
<p>All instances of the bulk retrieval classes may be used only once,
53
 
and to traverse the bulk retrieval buffer in the forward direction
54
 
only.  However, they are nondestructive, so multiple iterators can be
55
 
instantiated and used on the same returned data <a href="../api_java/dbt_class.html">Dbt</a>.
56
 
<p><dl compact>
57
 
<p><dt>DbMultipleDataIterator<dd>This class is used to iterate through data returned using the
58
 
<a href="../api_java/dbc_get.html#DB_MULTIPLE">Db.DB_MULTIPLE</a> flag from a database belonging to any access method.
59
 
The constructor takes the data <a href="../api_java/dbt_class.html">Dbt</a> returned by the call to
60
 
<a href="../api_java/db_get.html">Db.get</a> or <a href="../api_java/dbc_get.html">Dbc.get</a> that used the <a href="../api_java/dbc_get.html#DB_MULTIPLE">Db.DB_MULTIPLE</a>
61
 
flag.  The next() method takes a <a href="../api_java/dbt_class.html">Dbt</a> that will be filled in with
62
 
a reference to a buffer, a size, and an offset that together yield the
63
 
next data item in the original bulk retrieval buffer.  The next() method
64
 
returns false if no more data are available, and true otherwise.
65
 
<p><dt>DbMultipleKeyDataIterator<dd>This class is used to iterate through data returned using the
66
 
<a href="../api_java/dbc_get.html#DB_MULTIPLE_KEY">Db.DB_MULTIPLE_KEY</a> flag from a database belonging to the Btree or
67
 
Hash access methods.  The constructor takes the data <a href="../api_java/dbt_class.html">Dbt</a>
68
 
returned by the call to <a href="../api_java/db_get.html">Db.get</a> or <a href="../api_java/dbc_get.html">Dbc.get</a> that used the
69
 
<a href="../api_java/dbc_get.html#DB_MULTIPLE_KEY">Db.DB_MULTIPLE_KEY</a> flag.  The next() method takes two <a href="../api_java/dbt_class.html">Dbt</a>s,
70
 
one for a key and one for a data item, that will each be filled in with
71
 
a reference to a buffer, a size, and an offset that together yield the
72
 
next key or data item in the original bulk retrieval buffer.  The next()
73
 
method returns false if no more data are available, and true
74
 
otherwise.
75
 
<p><dt>DbMultipleRecnoDataIterator<dd>This class is used to iterate through data returned using the
76
 
<a href="../api_java/dbc_get.html#DB_MULTIPLE_KEY">Db.DB_MULTIPLE_KEY</a> flag from a database belonging to the Recno or
77
 
Queue access methods.  The constructor takes the data <a href="../api_java/dbt_class.html">Dbt</a>
78
 
returned by the call to <a href="../api_java/db_get.html">Db.get</a> or <a href="../api_java/dbc_get.html">Dbc.get</a> that used the
79
 
<a href="../api_java/dbc_get.html#DB_MULTIPLE_KEY">Db.DB_MULTIPLE_KEY</a> flag.  The next() method takes two <a href="../api_java/dbt_class.html">Dbt</a>s,
80
 
one for a key and one for a data item, that will each be filled in with
81
 
a reference to a buffer, a size, and an offset that together yield the
82
 
next key or data item in the original bulk retrieval buffer.  The record
83
 
number contained in the key item should be accessed using the
84
 
<a href="../api_java/dbt_class.html">Dbt.get_recno_key_data</a> method.  The next() method returns false if no
85
 
more data are available, and true otherwise.
86
 
</dl>
87
 
</tt>
88
 
<table width="100%"><tr><td><br></td><td align=right>
89
 
<a href="../api_java/c_index.html"><img src="../images/api.gif" alt="API"></a><a href="../reftoc.html"><img src="../images/ref.gif" alt="Ref"></a>
90
 
</td></tr></table>
91
 
<p><font size=1><a href="http://www.sleepycat.com">Copyright Sleepycat Software</a></font>
92
 
</body>
93
 
</html>