AELEMENT( ) 函式
由元素下標值返回數組元素的編號。
語法
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( ) 函式。
