element_at

SinceVersion 1.2.0

element_at

description

Syntax

1. T element_at(ARRAY<T> arr, BIGINT position)
2. T arr[position]

返回数组中位置为 position 的元素。如果该位置上元素不存在,返回NULL。position 从1开始,并且支持负数。

notice

仅支持向量化引擎中使用

example

position 为正数使用范例:

1. mysql> set enable_vectorized_engine=true;

3. mysql> SELECT id,c_array,element_at(c_array, 5) FROM `array_test`;
4. +------+-----------------+--------------------------+
5. | id   | c_array         | element_at(`c_array`, 5) |
6. +------+-----------------+--------------------------+
7. |    1 | [1, 2, 3, 4, 5] |                        5 |
8. |    2 | [6, 7, 8]       |                     NULL |
9. |    3 | []              |                     NULL |
10. |    4 | NULL            |                     NULL |
11. +------+-----------------+--------------------------+

position 为负数使用范例:

1. mysql> set enable_vectorized_engine=true;

3. mysql> SELECT id,c_array,c_array[-2] FROM `array_test`;
4. +------+-----------------+----------------------------------+
5. | id   | c_array         | %element_extract%(`c_array`, -2) |
6. +------+-----------------+----------------------------------+
7. |    1 | [1, 2, 3, 4, 5] |                                4 |
8. |    2 | [6, 7, 8]       |                                7 |
9. |    3 | []              |                             NULL |
10. |    4 | NULL            |                             NULL |
11. +------+-----------------+----------------------------------+

keywords

ELEMENT_AT, SUBSCRIPT