[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
AFILL()
Fill an array with a specified value
------------------------------------------------------------------------------
Syntax
AFILL(<aTarget>, <expValue>,
[<nStart>], [<nCount>]) --> aTarget
Arguments
<aTarget> is the array to be filled.
<expValue> is the value to be placed in each array element. It can
be an expression of any valid data type.
<nStart> is the position of the first element to be filled. If this
argument is omitted, the default value is one.
<nCount> is the number of elements to be filled starting with
element <nStart>. If this argument is omitted, elements are filled from
the starting element position to the end of the array.
Returns
AFILL() returns a reference to <aTarget>.
Description
AFILL() is an array function that fills the specified array with a
single value of any data type (including an array, code block, or NIL)
by assigning <expValue> to each array element in the specified range.
Warning! AFILL() cannot be used to fill multidimensional arrays.
CA-Clipper implements multidimensional arrays by nesting arrays within
other arrays. Using AFILL() with a multidimensional array will
overwrite subarrays used for the other dimensions of the array.
Examples
. This example, creates a three-element array. The array is
then filled with the logical value, (.F.). Finally, elements in
positions two and three are assigned the new value of true (.T.):
LOCAL aLogic[3]
// Result: aLogic is { NIL, NIL, NIL }
AFILL(aLogic, .F.)
// Result: aLogic is { .F., .F., .F. }
AFILL(aLogic, .T., 2, 2)
// Result: aLogic is { .F., .T., .T. }
Files Library is CLIPPER.LIB.
See Also:
AADD()
AEVAL()
DBSTRUCT()
DIRECTORY()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson