YashanDB ARRAY_APPEND函数

本文内容来自YashanDB官网，原文内容请见 https://doc.yashandb.com/yashandb/23.3/zh/开发手册/SQL参考手册/内置函数/ARRAY_APPEND.html

本函数遵循如下规则：

• 在PL中可以当作特殊的数组初始化函数使用。
• 函数结果不能作为INSERT语句的value使用。
• 不能对包含非标量类型成员的数组使用本函数。
• 执行本函数后，array_var中的成员数量并不会发生变化。
• 本函数不支持向量化计算。

array_var

数组变量，其值可以为：

• 一个存在的数组，数组成员必须为普通标量数据类型。
• NULL，此时将会生成一个以new_member的类型作为成员类型的数组（new_member不能为NULL），且新数组仅包含new_member一个成员。

new_member

通用表达式，其类型必须为与array_var数组成员相同，或可进行隐式转换的数据类型。

当array_var不为NULL时，new_member可以为NULL，表示向array_var数组末尾添加一个NULL成员。

示例（HEAP表）

SET serveroutput ON

DECLARE
  TYPE arr_type IS VARRAY(10) OF CHAR(5);
  a arr_type := arr_type('a', 'b', 'c');
  b arr_type;
BEGIN
  -- 向a的末尾添加一个成员'd'，生成临时数组并将该数组赋值给b
  b := ARRAY_APPEND(a, 'd');
  FOR i IN 1 .. b.COUNT LOOP
    IF b(i) IS NULL THEN
	  DBMS_OUTPUT.PUT_LINE(i||' is NULL');
    ELSE
      DBMS_OUTPUT.PUT_LINE(b(i));
    END IF;
  END LOOP;
END;
/
a
b
c
d

-- 首个参数为NULL时生成新数组
DECLARE
  TYPE arr_type IS VARRAY(10) OF CHAR(5);
  b arr_type;
BEGIN
  -- 生成新数组  
  b := ARRAY_APPEND(NULL, 'abcd');
  FOR i IN 1 .. b.COUNT LOOP
    IF b(i) IS NULL THEN
	  DBMS_OUTPUT.PUT_LINE(i||' is NULL');
    ELSE
      DBMS_OUTPUT.PUT_LINE(i||' is: '||b(i));
    END IF;
  END LOOP;
END;
/
1 is: abcd