AINS()

Insert a NIL value at an array subscript position.

Syntax

AINS( <aArray>, <nPos> ) --> aTarget

Arguments

<aArray> Array name.

<nPos> Subscript position in <aArray>

Returns

<aTarget> an array pointer reference.

Description

This function inserts a NIL value in the array named <aArray> at the <nPos>th position.

All array elements starting with the <nPos>th position will be shifted down one subscript position in the array list and the last item in the array will be removed completely. In other words, if an array element were to be inserted at the fifth subscript position, the element previously in the fifth position would now be located at the sixth position. The length of the array <aArray> will remain unchanged.

      LOCAL aArray:={"Harbour","is","Power!","!!!"}
      AINS(aArray,4)

Status

Ready

Compliance

This function is CA Clipper compliant

Files

Library is vm

See Also

• AADD()
• ACOPY()
• ADEL()
• AEVAL()
• AFILL()
• ASIZE()