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 )
Compliance
Clipper
Files
Library is vm
Seealso
AADD(), AEVAL(), DBSTRUCT(), DIRECTORY()