RealList (recognized field pairs)

Top  Previous  Next

 

 

RealList

&FieldPairsQueue

The RealList property is a reference to the structure that holds all the field pairs recognized by the BufferedPairsClass object.

Use the AddPair method to add field pairs to the RealList property. For each field pair, the RealList property includes the designated "Left" field, the designated "Right" field, plus a "Buffer" field you can use as an intermediate storage area (a save area).

The "Left," "Right," and "Buffer" designations are reflected in other BufferedPairsClass method names (for example, field assignment methods--AssignLeftToRight and AssignRightToBuffer) so you can easily and accurately control the movement of data between the three sets of fields.

Implementation:

During initialization, the BufferedPairsClass initialization method "points" the inherited List property to the RealList property so there is, in fact, only one list of fields which may be referred to as RealList.

RealList is a reference to a QUEUE declared in ABUTIL.INC as follows:

BufferedPairsQueue QUEUE,TYPE

Left                ANY

Right               ANY

Buffer              ANY

                  END

The Init method creates the List and RealList properties; the Kill method disposes of them. AddPair adds field pairs to the RealList property.

See Also:     AddPair, Init, Kill