V_ARETRIEV() / V_ARET()
 Return a Clipper 5.0 type array which was stored in a DBV file
-------------------------------------------------------------------------------

    See V_FILLARR() and V_FILLEN() for retrieving arrays that were
    stored by an earlier version of the S'87 FlexFile library.

 Syntax

    V_ARETRIEV(  <cPointer>, [<nArea> | <cAlias>] )  ->  Array

 Arguments

    <cPointer> is a six byte pointer-field (FlexFile's version of a
    memo-field).

    <nArea> or <cAlias> refers to the number or name of the target DBV
    work area. If not specified, the current DBV work area is assumed.

 Returns

    V_ARETRIEV() will return the array pointed to by <cPointer>. On
    error, V_ARETRIEV() will return (.F.).  Use V_ERROR() to fetch the
    error code associated with a failed V_ARETRIEV().

 Description

    V_ARETRIEV() retrieves arrays stored in a DBV file. It works on the
    same principal as the V_RETRIEVE() function. The function retrieves the
    array and all nested arrays as they were saved by V_AREPLACE().

 Notes

    If you have a DBV file which contains an array which was saved by
    FlexFile S'87 version 1.01 or less, you must use the V_FILLARR()
    function to convert the array to one compatible with this function.

    All arrays stored with FlexFile's S87 version 1.02 or greater (and,
    of course, any arrays stored with FlexFile's 5.0 versions) are
    compatible with this function.

 Examples

    LOCAL ray

    // Open the DBF file and its associated DBV file.
    // Assume the array stored in the V_AREPLACE() example.
    USE dbf_file         // Has a 6 byte pointer-field: vlf.
    V_USE( "dbv_file" )  // Already contains a stored array

    // Retrieve the array (and its nested array).
    ray = V_ARETRIEV( vlf )