13  The _storc() and _storclen() Functions
--------------------------------------------------------------------------------

     The Extend system's _storc() function is used to assign a new
     character value to a Clipper variable (if passed by reference) or
     an array element.

     To do this, _storc() first allocates space for the data and copies
     the specified string into it.  It then creates a new VALUE
     containing an OREF to the newly allocated area.  It then looks into
     the Eval Stack to find the specified parameter.  If the parameter
     is a reference to a variable (a VREF), _storc() locates the
     variable and overwrites its VALUE with the new VALUE.  If the
     specified parameter is an array, _storc() uses the array's OREF to
     locate the array.  It then overwrites the specified array element
     with the new VALUE.  If the specified parameter is neither a VREF
     nor an array, _storc() simply copies the new VALUE over the
     parameter's Eval Stack entry.  This changes the parameter value (as
     seen, for example, by _parc() ) but has no effect on any variable
     or array element.