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

AFILL()

Fill an array with a specified value
---------------------------------------------------------------------------------

 Syntax

        AFILL( <aArray>, <xValue>, [<nStart>], [<nCount>] ) --> aTarget  

 Arguments

        <aArray>   Name of array to be filled.      

        <xValue>   Expression to be globally filled in <aArray>      

        <nStart>   Subscript starting position      

        <nCount>   Number of subscript to be filled    

 Returns

        <aTarget>   an array pointer.    

 Description

      This function will fill each element of an array named <aArray> with
      the value <xValue>. If specified, <nStart> denotes the beginning
      element to be filled and the array elements will continue to be
      filled for <nCount> positions. If Not specified, the value of
      <nStart> will be 1, and the value of <nCount> will be the value  of
      LEN(<aArray>); thus, all subscript positions in the array  <aArray>
      will be filled with the value of <xValue>.

      This function will work on only a single dimension of <aArray>.  If
      there are array pointer references within a subscript <aArray>,
      those values will be lost, since this function will overwrite those
      values with new values.

 Examples

      LOCAL aTest:={Nil,0,1,2}
      Afill(aTest,5)

Status

      Ready

 Compliance

      This function is CA Clipper compliant

 Files

      Library is vm