What are tables

diff -r 4816d766a08a -r f345bda72bc4 Symbian3/PDK/Source/GUID-83BE15D8-511F-592D-A93B-C71BD6FB1B08.dita --- a/Symbian3/PDK/Source/GUID-83BE15D8-511F-592D-A93B-C71BD6FB1B08.dita Tue Mar 30 11:42:04 2010 +0100 +++ b/Symbian3/PDK/Source/GUID-83BE15D8-511F-592D-A93B-C71BD6FB1B08.dita Tue Mar 30 11:56:28 2010 +0100 @@ -1,14 +1,47 @@ - - - - - -What are tablesThis topic describes the structure of a table. A table is an item that can be stored in the Comms Database.

A table is a set of records. All records in a table are the same type. A table is also a container and an element.

There are two types of table:

a table that has records defined at system compile time - these records have named fields and are defined by Symbian OS.
a table that consists of records defined at run time - these records are user defined records - they are not known to Symbian OS when Symbian OS is built.

Tables that have records defined at system compile - time

A table that has records defined at system compile time is represented by the templated class CMDBRecordSet <T>. The template parameter defines the record type. The template parameter is a Symbian OS defined record.

You create a table object on the heap. You use the new - (Eleave) construction to create this object.

The CommsDat API implements the table as an array of records and uses RPointerArray <T> as the array. The CommsDat API implements RPointerArray<T> in the base class CMDBRecordSetBase, because this behaviour is common to all tables. Tools and applications can access the array and can use the sort behaviour provided by RPointerArray<T> to sort records.

Tables that have user defined records

A table that has user defined records is represented by the CMDBGenericRecord. The class has the behaviour that allows it to represent a record and a set of records. Internally, the class has an array that can contain the records.

You use the CommsDat::CCDRecordBase::RecordFactoryL() factory function to create a CMDBGenericRecord object.

\ No newline at end of file + + + + + +What +are tablesThis topic describes the structure of a table. A table is an item +that can be stored in the Comms Database. +

A table is a set of records. All records in a table are the same type. +A table is also a container and an element.

There are two types of table:

a table that has records +defined at system compile time - these records have named fields and are defined +by Symbian platform.
a table that consists +of records defined at run time - these records are user defined records - +they are not known to Symbian platform when Symbian platform is built.

Tables that have records defined at system compile + time

A table that has records defined at system compile time +is represented by the templated class CMDBRecordSet <T>. +The template parameter defines the record type. The template parameter is +a Symbian platform defined record.

You create a table +object on the heap. You use the new (Eleave) construction +to create this object.

+ +

The CommsDat API implements the table as an array of records and +uses RPointerArray <T> as +the array. The CommsDat API implements RPointerArray<T> in +the base class CMDBRecordSetBase, because +this behaviour is common to all tables. Tools and applications can access +the array and can use the sort behaviour provided by RPointerArray<T> to +sort records.

Tables that have user defined records

A table that +has user defined records is represented by the CMDBGenericRecord. +The class has the behaviour that allows it to represent a record and a set +of records. Internally, the class has an array that can contain the records.

You +use the CommsDat::CCDRecordBase::RecordFactoryL() factory +function to create a CMDBGenericRecord object.

+ \ No newline at end of file