Record Classes

TRecordField is an abstract class that is a generic wrapper for data fields in a record. It is intended for provider use only and clients cannot instantiate it.

TRecordFieldHandle is a concrete class that is a counted-pointer memory-management surrogate for record fields. It helps manage the destruction of a record instance containing a given field. Records are deleted when there are no remaining record or field handles that reference the record.

TRecord is an abstract class representing an array of fields. Providers must declare appropriate constructors when using this class. Clients should use instances of TRecordHandle.

TRecordHandle is a concrete class that is one of two counted-pointer memory-management surrogates for TRecord and its subclasses (the other counted-pointer memory- management surrogate being TRecordField Handle). Clients should obtain record handles for records from classes such as TRecordSource.

TRecordUnsignedCharField and TRecordUnsignedCharFieldHandle implement the equivalent of:

  typedef TRecordFieldOf<unsigned char, unsigned char> 
      TRecordUnsignedCharField;
  TRecordFieldHandleOf<unsigned char, unsigned char>
      TRecordUnsignedCharFieldHandle;

  typedef TRecordFieldOf<short, short> 
      TRecordShortField;
  TRecordFieldHandleOf<short, short>
      TRecordShortFieldHandle;

  typedef TRecordFieldOf<long, long> 
      TRecordLongField;
  TRecordFieldHandleOf<long, long>
      TRecordLongFieldHandle;

  typedef TRecordFieldOf<double, double> 
      TRecordDoubleField;
  TRecordFieldHandleOf<double, double>
      TRecordDoubleFieldHandle;