• NAME Table
• DESCRIPTION
• METHODS
• new(string $tableName)
• insertTuple(Tuple $tuple)
• deleteTuple(Column $key)
• retrieveTuple(Column $key)
• enumerate()
• enumerateKeys()
• save()

NAME Table

This package is part of the OODatabase manpage.

Copyright &copy 1997 Curtis E. Dyreson. All rights reserved.

DESCRIPTION

This class represents a table in a the OODatabase::Database manpage. A table is a dbm file. Each entry in the table is a the OODatabase::Tuple manpage. The class has been configured to use either BSD, GDBM, or BigDB files. You must edit this package to configure it.

METHODS

new(string $tableName)

• string $tableName
  
- The name of the table (a dbm file name).

Create a table with the give name (opens a dbm file). Second line.

insertTuple(Tuple $tuple)

the OODatabase::Tuple manpage $tuple - The tuple to insert.

Insert a the OODatabase::Tuple manpage into the table. Will replace an existing tuple so be careful.

deleteTuple(Column $key)

• Column $key
  
- The key for the tuple to retrieve, must be a the OODatabase::Persistent manpage object.

Delete a tuple. The function returns true or false depending on whether or not the tuple found and deleted.

retrieveTuple(Column $key)

• Column $key
  
- The key for the tuple to retrieve, must be a the OODatabase::Persistent manpage object.

Retrieve a tuple with the given key from the table. This routine will retrieve a tuple from the table, or if the tuple is not found it will return 0. Use as follows.

   # we want to retrieve the tuple for the key "hi"
   $key = Id::fromString("hi");
   # try to retrieve it 
   $r = $table->retrieveTuple($key);    
   # let's test if we found it
   if ($r) { 
     # key was found in the table 
   else { 
     # key was not found
     }

enumerate()

Return a reference to the dbm file.

enumerateKeys()

Return a list of the keys.

save()

Close the DBM file