数组函数和操作符
=================


下表显示了可用的 *数组* 类型的操作符。

**表.数组操作符**


.. list-table::
    :widths: auto
    :header-rows: 1

    * - 操作符
      - 描述
      - 例子
      - 结果
    * - =
      - 等于
      - ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3]	
      - t
    * - <>
      - 不等于
      - ARRAY[1,2,3] <> ARRAY[1,2,4]	
      - t
    * - <
      - 小于
      - ARRAY[1,2,3] < ARRAY[1,2,4]	
      - t
    * - >
      - 大于
      - ARRAY[1,4,3] > ARRAY[1,2,4]	
      - t
    * - <=
      - 小于或等于
      - ARRAY[1,2,3] <= ARRAY[1,2,3]	
      - t
    * - >=
      - 大于或等于
      - ARRAY[1,4,3] >= ARRAY[1,4,3]	
      - t
    * - @>
      - 包含
      - ARRAY[1,4,3] @> ARRAY[3,1]	
      - t
    * - <@
      - 被包含于
      - ARRAY[2,7] <@ ARRAY[1,7,4,2,6]	
      - t
    * - &&
      - 重叠(有共同元素)
      - ARRAY[1,4,3] && ARRAY[2,1]	
      - t
    * - ||
      - 数组与数组连接
      - ARRAY[1,2,3] || ARRAY[4,5,6]	
      - {1,2,3,4,5,6}
    * - ||
      - 数组与数组连接
      - ARRAY[1,2,3] || ARRAY[[4,5,6],[7,8,9]]	
      - {{1,2,3},{4,5,6},{7,8,9}}
    * - ||
      - 元素与数组的连接
      - 3 || ARRAY[4,5,6]	
      - {3,4,5,6}
    * - ||
      - 数组与元素的连接
      - ARRAY[4,5,6] || 7	
      - {4,5,6,7}

数组比较是使用默认的 B-Tree 比较函数对所有元素逐一进行比较的。多维数组的元素按照行顺序进行访问(最后的下标变化最快)。如果两个数组的内容相同但维数不等， 那么决定排序顺序的首要因素将是维数。

参阅 `数组 <./arrays.html>`_
获取有关数组操作符行为的更多细节。

下表显示了数组类型可用的函数，参阅 `数组 <./arrays.html>`_ 
获取更多的这些函数使用的例子。

**表.数组函数**


.. list-table::
    :widths: auto
    :header-rows: 1

    * - 函数
      - 返回类型
      - 描述
      - 例子
      - 结果
    * - array_append(anyarray, anyelement)	
      - anyarray	
      - 向数组末尾添加元素	
      - array_append(ARRAY[1,2], 3)	
      - {1,2,3}
    * - array_cat(anyarray, anyarray)	
      - anyarray	
      - 连接两个数组
      - array_cat(ARRAY[1,2,3], ARRAY[4,5])	
      - {1,2,3,4,5}
    * - array_dims(anyarray)	
      - text	
      - 返回数组维数的文本表示	
      - array_dims(ARRAY[[1,2,3], [4,5,6]])	
      - [1:2][1:3]
    * - array_lower(anyarray, int)	
      - int	
      - 返回数组维数的下界
      - array_lower('[0:2]={1,2,3}'::int[], 1)	
      - 0
    * - array_prepend(anyelement, anyarray)	
      - anyarray	
      - 向数组开头添加元素
      - array_prepend(1, ARRAY[2,3])	
      - {1,2,3}
    * - array_to_string(anyarray, text)	
      - text	
      - 使用分隔符连接数组元素
      - array_to_string(ARRAY[1, 2, 3], '~^~')	
      - 1~^~2~^~3
    * - string_to_array(text, text)	
      - text[]	
      - 使用指定的分隔符和null字把字符串分裂成数组元素
      - string_to_array('xx~^~yy~^~zz', '~^~')	
      - {xx,yy,zz}