ascan( ) 函数

示例 请参阅

在数组中搜索与一个表达式具有相同数据和数据类型的元素。

语法

ASCAN(ArrayName, eExpression [, nStartElement [, 
nElementsSearched]])

参数

ArrayName

指定要在其中进行搜索的数组。

eExpression

指定要搜索的常规表达式。

nStartElement

指定开始搜索的元素号(含此元素)。如果忽略参数 nStartElement,则默认搜索整个数组。

nElementsSearched

指定要搜索的元素数目。如果忽略参数 nStartElement 和 nElementSearched,将从第一个元素开始搜索到最后一个元素。

附注
有两种方式可以引用二维内存变量数组中的某个元素。第一种方法为引用确定元素在数组的第几行和第几列的两个下标值,另一种方法为使用元素编号。此函数和其他操作二维数组的函数需要元素的编号值 ( nStartElement 和 nElementsSearched )。使用 AELEMENT( ) 函数可将二维数组中元素的行列下标值转换成编号。

返回值类型
数值型


说明
如果找到了匹配元素,ASCAN( )函数将返回找到的元素编号。如果没有找到匹配元素,
ASCAN( ) 的返回值为零。
字符数据成功匹配的条件由 SET EXACT 命令决定。如果 SET EXACT 为 ON,数组元素与查找表达式必须逐字符匹配并且长度相等;如果 SET EXACT 为 OFF,只要元素与到表达式末尾为止的字符相匹配,匹配即成功。有关字符串匹配条件的详细内容,请参阅 SET EXACT 主题中的“字符串比较表”。