|
|
| int db::Table::open |
( |
Database & |
dbp, |
|
|
const NameChar * |
table_name, |
|
|
CursorMode |
cursor_mode = DB_CURSOR_FOR_READ, |
|
|
TxIsolation |
isolation = DB_DEFAULT_ISOLATION | |
|
) |
| | |
Open an existing table named table_name in the dbp database.
- Parameters:
-
| dbp | The database in which to find the table. (required) |
| table_name | The name of the table to open. (required) |
| cursor_mode | The cursor mode to use. |
| isolation | The isolation level to use in this cursor. If DB_DEFAULT_ISOLATION is selected, the isolation level of the transaction will be used (recommended). |
- Returns:
- DB_NOERROR When successful.
- DB_EINVAL Caused by: invalid table_name, invalid cursor_mode, or invalid transaction isolation mode.
- DB_ENAME table_name is not in a valid format. Valid name is letter(aA-zZ)+zero or more aplhanumeric characters. Underscore is considered a valid character.
- DB_ESTATE Object state is not compatible with the method called. Storage is already opened.
- Postcondition:
- The table is in DB_TABLE_BROWSING mode.
|