ARRAY_FIRST 标量函数

ARRAY_FIRST 函数返回数组的最小数组下标值。

Read syntax diagramSkip visual syntax diagram ARRAY_FIRST ( array-expression )
该模式是 SYSIBM。
array-expression
数组类型的 SQL 变量， SQL 参数或全局变量，或者数组类型的参数标记的 CAST 规范。

结果的数据类型是数组下标的数据类型，对于普通数组为 INTEGER。 如果 array-expression 不为空，并且数组的基数大于零，那么结果的值为最小数组下标值，对于普通数组为 1。

结果可以为空; 如果 array-variable 为空或数组的基数为零，那么结果为空值。

示例

  1. 将普通数组变量 SPECIALNUMBERS 中的第一个索引值返回到 SQL 变量 E_CONSTIDX。
    SET E_CONSTIDX = ARRAY_FIRST(SPECIALNUMBERS)
    结果为 1。
  2. 给定具有索引值和电话号码的关联数组变量 PHONELIST : "Home" 为 "4163053745" ， "Work" 为 "4163053746" ， "妈妈" 为 "416-4789683" ， 将数组中 最小 索引的值分配给名为 X的 字符串 变量。
    SET X = ARRAY_FIRST(PHONELIST)
    将 "Home" 的值分配给 X。 访问与索引值 "Home" 关联的元素值，并将其分配给 SQL 变量 NUMBER_TO_CALL:
    SET NUMBER_TO_CALL = PHONELIST[X]