Class: TRecord

Declaration: Record.h

Taxonomy Categories:

Member Functions:


Interface Category:

API.

Inherits From:

MCollectible, MReferenceCounted

Inherited By:

None.

Purpose:

This abstract class represents an array of fields. Clients will typically not need this class or its derived classes, but will most often use instances of the associated counted pointer memory management surrogate, TRecordHandle.

Instantiation:

Abstract class; do not allocate.

Deriving Classes:

None.

Concurrency:

Not multithread safe.

Resource Use:

No special requirements.

Other Considerations:

None.

Member Function: TRecord::~TRecord

virtual ~ TRecord ()

Interface Category:

API.

Purpose:

Destructor.

Calling Context:

Called to destroy an object.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TRecord::GetField

virtual TRecordFieldHandle GetField (FieldPosition) const

Interface Category:

API.

Purpose:

Returns a handle to the field at the given position.

Calling Context:

Call this function directly.

Parameters:

Return Value:

A handle to the field at the given position.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TRecord::GetFieldCount

virtual FieldCount GetFieldCount () const

Interface Category:

API.

Purpose:

Returns the number of fields in the record.

Calling Context:

Call this function directly.

Parameters:

Return Value:

The number of fields in the record.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TRecord::operator>>=

virtual TStream & operator >>=(TStream &) const

Interface Category:

API.

Purpose:

Stream-out operator.

Calling Context:

Called to stream out data.

Parameters:

Return Value:

Returns a reference to the stream the object streams itself out to.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TRecord::operator<<=

virtual TStream & operator <<= (TStream &)

Interface Category:

API.

Purpose:

Stream-in operator.

Calling Context:

Called to stream in data.

Parameters:

Return Value:

Returns a reference to the stream the object streams itself in from.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TRecord::TRecord

  1. TRecord ()
  2. TRecord (const TRecord &)

Interface Category:

API.

Purpose:

  1. Default constructor.
  2. Copy constructor.

Calling Context:

  1. Called by the stream-in operators and any other function that needs to construct an uninitialized object.
  2. Called to copy an object.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TRecord::CreateFieldHandle

virtual TRecordFieldHandle CreateFieldHandle (const TRecordField & field)

Interface Category:

API.

Purpose:

Creates a field handle for a record field. Intended for providers only.

Calling Context:

Called by the GetField member function of a derived class.

Parameters:

Return Value:

A field handle for the specified record field.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.

Member Function: TRecord::Unreachable

virtual void Unreachable ()

Interface Category:

API.

Purpose:

For framework internal debugging.

Calling Context:

This is a Taligent internal member function. It should not be called by the clients.

Parameters:

Return Value:

None.

Exceptions:

Throws no exceptions, passes all exceptions through.

Concurrency:

Not multithread safe.

Other Considerations:

None.
Click the icon to mail questions or corrections about this material to Taligent personnel.
Copyright©1995 Taligent,Inc. All rights reserved.