由元素下标值返回数组元素的编号。
语法
AELEMENT(ArrayName, nRowSubscript [, nColumnSubscript])
参数
ArrayName
指定想要返回元素编号的数组名。
nRowSubscript
指定行下标。如果数组为一维数组，
AELEMENT( ) 函数的返回值为 nRowSubscript。
如果仅有参数 nRowSubscript，并且此值大于数组的行总数，将产生错误信息。
nColumnSubscript
Visual FoxPro 指定列下标。如果数组为二维数组，则需要 nRowSubscript 和 ColumnSubscript 两个参数。
返回值类型
数值型
说明
有两种方法引用二维数组中的元素。第一种方法用两个下标值指定元素在数组中的行和列，另一种方法则给出单个元素的编号。在第一种方法中提供元素的行和列下标后，
AELEMENT( ) 函数能返回元素的编号。
Visual FoxPro 函数 ADEL( )、ADIR( )、
AFIELDS( )、AINS( )、ALEN( )、ASCAN( )、
ASORT( ) 和 ASUBSCRIPT( ) 可以操作二维数组，并且需要通过元素编号来引用元素。
AELEMENT( ) 为这些函数提供了由下标值转化为元素编号的方法。使用 ASUBSCRIPT( )
函数可由编号值返回相应的行和列下标值。
下面的示例说明了如何创建一个具有二行三列的数组。DISPLAY MEMORY 命令按元素编号顺序显示每个元素的内容。
DIMENSION gaMyArray(2,3)
DISPLAY MEMORY LIKE gaMyArray
gaMyArray Pub A
( 1, 1) L .F. (element number 1)
( 1, 2) L .F. (element number 2)
( 1, 3) L .F. (element number 3)
( 2, 1) L .F. (element number 4)
( 2, 2) L .F. (element number 5)
( 2, 3) L .F. (element number 6)
一个元素可通过下标或编号来引用。命令 STORE 'INVOICE' TO gaMyArray(2,1) 和 STORE 'INVOICE' TO gaMyArray(4) 都将字符串 INVOICE 存入同一数组元素中。
在一维数组中，元素编号与行下标相同。因此对于一维数组，没有必要使用 AELEMENT( ) 函数。