diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-83BE15D8-511F-592D-A93B-C71BD6FB1B08.dita --- a/Symbian3/SDK/Source/GUID-83BE15D8-511F-592D-A93B-C71BD6FB1B08.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-83BE15D8-511F-592D-A93B-C71BD6FB1B08.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,47 +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:

- -
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.

+ + + + + +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