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

     ERRCODE compile(
                          AREAP wa,
                          BYTEP cExpr
                       )

 Arguments

     wa is a pointer to self.

     cExpr is the character expression to be compiled.

 Description

     The compile() method 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->valResult.

     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 item in wa->valResult must be deallocated later.

 Implementation Notes

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

 Files  Header file is Rdd.api.