9.18.?數組函數和操作符

表?9.48顯示了可以用于數組類型的操作符。

表?9.48.?數組操作符

操作符描述例子結果

=	等于	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 在元素數據類型上的比較函數對數組內容按元素逐一進行。 多維數組的元素按照行序進行訪問（最后的下標變化最快）。如果兩個數組的內容相同但維數不等，那么維度信息中的第一個不同將決定排序順序（這是對PostgreSQL?8.2 之前版本的修改： 老版本認為內容相同的兩個數組相等，即使它們的維數或下標范圍并不相同）。

參閱第?8.15?節獲取有關數組操作符行為的更多細節。有關哪些操作符支持被索引的操作，請參閱第?11.2?節。

表?9.49展示了可以用于數組類型的函數。 參閱第?8.15?節獲取更多信息以及使用這些函數的例子。

表?9.49.?數組函數

函數返回類型描述例子結果

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_ndims(anyarray)	int	返回數組的維度數	array_ndims(ARRAY[[1,2,3], [4,5,6]])	2
array_dims(anyarray)	text	返回數組的維度的文本表示	array_dims(ARRAY[[1,2,3], [4,5,6]])	[1:2][1:3]
array_fill(anyelement,?int[], [,?int[]])	anyarray	返回一個用提供的值和維度初始化好的數組，可以選擇下界不為 1	array_fill(7, ARRAY[3], ARRAY[2])	[2:4]={7,7,7}
array_length(anyarray,?int)	int	返回被請求的數組維度的長度	array_length(array[1,2,3], 1)	3
array_lower(anyarray,?int)	int	返回被請求的數組維度的下界	array_lower('[0:2]={1,2,3}'::int[], 1)	0
array_position(anyarray,?anyelement?[,?int])	int	返回數組中第二個參數第一次出現的下標。 起始于第三個參數或第一個元素指示的元素位置（數組必須是一維的)	array_position(ARRAY['sun','mon','tue','wed','thu','fri','sat'], 'mon')	2
array_positions(anyarray,?anyelement)	int[]	返回作為第一個參數的數組中第二個參數出現的數組下標（數組必須是一維的)	array_positions(ARRAY['A','A','B','A'], 'A')	{1,2,4}
array_prepend(anyelement,?anyarray)	anyarray	向一個數組的首部追加一個元素	array_prepend(1, ARRAY[2,3])	{1,2,3}
array_remove(anyarray,?anyelement)	anyarray	從數組中移除所有等于給定值的所有元素（數組必須是一維的）	array_remove(ARRAY[1,2,3,2], 2)	{1,3}
array_replace(anyarray,?anyelement,?anyelement)	anyarray	將每一個等于給定值的數組元素替換成一個新值	array_replace(ARRAY[1,2,5,4], 5, 3)	{1,2,3,4}
array_to_string(anyarray,?text?[,?text])	text	使用提供的定界符和可選的空串連接數組元素	array_to_string(ARRAY[1, 2, 3, NULL, 5], ',', '*')	1,2,3,*,5
array_upper(anyarray,?int)	int	返回被請求的數組維度的上界	array_upper(ARRAY[1,8,3,7], 1)	4
cardinality(anyarray)	int	返回數組中元素的總數，如果數組為空則返回 0	cardinality(ARRAY[[1,2],[3,4]])	4
string_to_array(text,?text[,?text])	text[]	使用提供的定界符和可選的空串將字符串劃分成數組元素	string_to_array('xx~^~yy~^~zz', '~^~', 'yy')	{xx,NULL,zz}
unnest(anyarray)	setof anyelement	將一個數組擴展成一組行	unnest(ARRAY[1,2])	1 2(2 rows)
unnest(anyarray,?anyarray[, ...])	setof anyelement, anyelement [, ...]	把多維數組（可能是不同類型）擴展成一個行的集合。 這只允許用在 FROM 子句中，見第?7.2.1.4?節	unnest(ARRAY[1,2],ARRAY['foo','bar','baz'])	1 foo 2 bar NULL baz(3 rows)

在array_position和array_positions中， 每個數組元素與使用IS NOT DISTINCT FROM語法的搜索值進行比較。

在array_position中，如果沒有找到該值，則返回NULL。

在array_positions中，如果數組是NULL，則返回NULL； 如果數組中沒有找到該值，相反返回空數組。

在string_to_array中，如果定界符參數為 NULL，輸入字符串中的每一個字符將變成結果數組中的一個獨立元素。如果定界符是一個空串，則整個輸入字符串被作為一個單一元素的數組返回。否則輸入字符串會被在每一個出現定界符字符串的位置分裂。

在string_to_array中，如果空值串參數被忽略或者為 NULL，輸入中的子串不會被替換成 NULL。在array_to_string中，如果空值串參數被忽略或者為 NULL，該數組中的任何空值元素會被簡單地跳過并且不會在輸出串中被表示。

注意

string_to_array的行為中有兩點與PostgreSQL?9.1之前的版本不同。首先，當輸入串的長度為零時，它將返回一個空（無元素）數組而不是 NULL。其次，如果定界符串為 NULL，該函數會將輸入劃分成獨立字符，而不是像以前那樣返回 NULL。

也可參見第?9.20?節了解用于數組的聚集函數array_agg。

本文轉自PostgreSQL中文社區，原文鏈接：9.18.?數組函數和操作符

總結

以上是生活随笔為你收集整理的PostgreSQL 10.1 手册_部分 II. SQL 语言_第 9 章 函数和操作符_9.18. 数组函数和操作符...的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。