DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

db join

API Ref

db join
	db.cX
	db.cY
	db.cZ
	...

Description(db join)

The db join command joins the specified cursors and returns a cursor handle that can be used to iterate through the joined {key data} pairs. The returned cursor handle is bound to a Tcl command of the form dbN.cX, where X is an integer starting at 0 (for example, db0.c0 and db0.c1). It is through this Tcl command that the script accesses the cursor methods.

The returned join cursor has limited cursor functionality, and only the dbc get and dbc close commands will succeed.

See Equality join for more information on the underlying requirements for joining.

In a transaction-protected environment, all the cursors listed must have been created within the same transaction.

In the case of error, a Tcl error is thrown.


APIRef

Copyright (c) 1996-2005 Sleepycat Software, Inc. - All rights reserved.