Este tópico descreve a sintaxe, os parâmetros, os valores de retorno e exemplos de funções de array.
arr_concat
Concatena os elementos de um array em uma única string, com um separador opcional.
Sintaxe: arr_concat(tbl, sep) → String
|
Parâmetro |
Obrigatório |
Padrão |
Descrição |
|
|
Sim |
— |
Array cujos elementos você deseja concatenar. |
|
|
Não |
|
Separador inserido entre os elementos. |
Exemplo
d = ['t1','t2','t3']
say(arr_concat(d, '&'))
-- Output: t1&t2&t3
arr_insert
Insere um elemento em um array na posição especificada.
Sintaxe: arr_insert(list, value, [pos]) → Boolean
|
Parâmetro |
Obrigatório |
Padrão |
Descrição |
|
|
Sim |
— |
Array no qual o elemento será inserido. |
|
|
Sim |
— |
Elemento a inserir. Aceita qualquer tipo de dado. |
|
|
Não |
Fim do array |
Índice base 1 para inserção do elemento. Deve ser um inteiro diferente de zero. Os elementos após o ponto de inserção deslocam-se para o final. |
Retorna true.
Exemplo
tbl_1 = []
arr_insert(tbl_1, '1')
arr_insert(tbl_1, '3')
arr_insert(tbl_1, '5')
arr_insert(tbl_1, '2')
arr_insert(tbl_1, '6', 1)
str = arr_concat(tbl_1, '')
say(concat('arr_insert:', str))
-- Output: arr_insert:61352
arr_remove
Remove um elemento de um array na posição especificada e o retorna.
Sintaxe: arr_remove(list, [pos]) → Any
|
Parâmetro |
Obrigatório |
Padrão |
Descrição |
|
|
Sim |
— |
Array do qual remover o elemento. |
|
|
Não |
Último elemento |
Índice do elemento a remover. |
Retorna o elemento removido.
Exemplo
tbl_1 = []
arr_insert(tbl_1, '1')
arr_insert(tbl_1, '3')
arr_insert(tbl_1, '5')
arr_insert(tbl_1, '2')
say(concat('arr_remove:', arr_remove(tbl_1, 2)))
-- Output: arr_remove:3
arr_sort
Ordena os elementos de um array diretamente na estrutura original.
Sintaxe: arr_sort(list, [comp]) → Boolean
|
Parâmetro |
Obrigatório |
Padrão |
Descrição |
|
|
Sim |
— |
Array a ordenar. |
|
|
Não |
ANSII ascendente |
Função comparadora que determina a ordem dos elementos. |
Comportamento do comparador
|
**Valor de retorno de |
Ordem de classificação |
|
|
A ordenação ocorre por código ANSII em ordem ascendente. Elementos com valores ANSII iguais podem mudar de posição. |
|
|
|
|
|
|
Nota: A funçãocomprecebe dois elementos delistcomo argumentos. Para ordenar em ordem decrescente, retornetruequandoa > b.
Retorna true.
Exemplo
tbl_1 = []
arr_insert(tbl_1, '1')
arr_insert(tbl_1, '3')
arr_insert(tbl_1, '5')
arr_insert(tbl_1, '2')
say(concat('remove:', arr_remove(tbl_1, 2)))
str = arr_concat(tbl_1, '')
say(concat('insert:', str))
arr_sort(tbl_1)
str = arr_concat(tbl_1, '')
say(concat('sort:', str))
def my_comp(a, b){
a = tonumber(a)
b = tonumber(b)
if gt(a, b) {
return true
}
return false
}
arr_sort(tbl_1, my_comp)
str = arr_concat(tbl_1, '')
say(concat('sort_comp:', str))
-- Output:
-- remove:3
-- insert:152
-- sort:125
-- sort_comp:521
arr_len
Retorna o número de elementos em um array.
Sintaxe: arr_len(arr) → Number
|
Parâmetro |
Obrigatório |
Descrição |
|
|
Sim |
Array a contar. |
Exemplo
d = []
set(d, 1, 'v1')
say(arr_len(d))
-- Output: 1