Click above to get retro games delivered to your door ever month!

 trans()
 Copy one or more rows (records) from one workarea to another
------------------------------------------------------------------------------
 Prototype

     ERRCODE trans(
                    WORKAREAP wa,
                    DBTRANSINFOP dbTransInfo
                  )

 Arguments

     wa is a pointer to self.

     dbTransInfo is a pointer to a structure containing information about
     the transfer of data.

 Description

     Copies one or more rows between two tables in two different workareas.

 Default Behavior

     Copies multiple rows by passing each wa record to transRec() while the
     following conditions are met (these are the same conditions as
     dbEval()):

     .  If dbTransInfo->scope.nRecord is set to a number, evalBlock()
        is called once with that physical row (record) number

     .  If dbTransInfo->scope.nNext is set to a number, n: n
        iterations occur.

        Otherwise, evalBlock() is called for each record while wa->eof is not
        true and the dbTransInfo->scope.bWhile block evaluates to TRUE.

 Implementation Notes

     .  If you perform multiple iterations of this method, be careful
        to completely emulate the behavior of Xbase scoping.  This will offer
        the CA-Clipper developer maximum compatibility with the Xbase DML.
        Note especially that several of the scoping conditions exclude each
        other, so there are many opportunities for optimization.  The default
        behavior of this method provides a very high level of optimization
        with the default Xbase scoping.

 Files:  Header file is Rdd.api.