GETPOSTVALIDATE()
 Postvalidate the current Get object
------------------------------------------------------------------------------
 Syntax

     GETPOSTVALIDATE(<oGet>) --> lSuccess

 Arguments

     <oGet> is a reference to the current Get object.

 Returns

     GETPOSTVALIDATE() returns a logical value indicating whether the Get
     object has been postvalidated successfully.

 Description

     GETPOSTVALIDATE() is a Get system function that validates a Get object
     after editing, including evaluating Get:postBlock (the VALID clause) if
     present.

     The return value indicates whether the GET has been postvalidated
     successfully.  If a CLEAR GETS is issued during postvalidation,
     Get:exitState is set to GE_ESCAPE and GETPOSTVALIDATE() returns true
     (.T.).

 Notes

     .  In the default system, a Get:exitState of GE_ESCAPE cancels
        the current GET and terminates READMODAL().

 Examples

     .  This example calls GETPOSTVALIDATE to determine whether or not
        the VALID clause of oGet is satisfied.  If not, then the user is not
        allowed to exit from the Get object.

        IF (! GETPOSVALIDATE (oGet))
           oGet : exitState := GE_NOEXIT
        ENDIF

 Files   Library is CLIPPER.LIB, source file is Getsys.prg.