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

 compile()
 Compile a character expression
------------------------------------------------------------------------------
 Prototype

     ERRCODE compile(
                      WORKAREAP wa,
                      BYTEP cExpr
                    )

 Arguments

     wa is a pointer to self.

     cExpr is the character expression to be compiled.

 Description

     Compiles a CA-Clipper expression passed as a character string into a
     code block.

 Default Behavior

     The compile() macro compiles the character expression cExpr, a null-
     terminated string.

     The returned ERRCODE indicates success or failure.  An Item to the
     resulting code block is placed in wa->result.

     Warning!  If the expression in cExpr is NULL or larger than the
     legal limit for macro-compiled expressions (in the RDD system, this
     limit is 256 characters), a runtime error is generated.

     Warning!  The wa->Item in result must be deallocated later.

 Implementation Notes

     .  One common reason to subclass the compile() method is to save
        the Item held in wa->result in case it is needed for some other
        process.

 Files:  Header file is Rdd.api.