|
|
|
|
|
|
|
|
|
|
|
Resumo das funções de arrays
|
↑Topo • Fim↓
|
|
|
|
Obs: em linguagem de computação, o termo inglês "array"
pode ser entendido como uma "coleção".
Entretanto, aqui não traduzimos por ser bastante difundido o uso da
palavra original.
join (junta os elementos) |
length (retorna o número de
elementos) | pop (remove o último elemento)
|
push (adiciona elementos no final) |
reverse (inverte a ordem) | shift (remove o primeiro elemento)
|
slice (extrai uma parte) |
sort (ordena elementos) |
splice (adiciona e remove elementos)
|
toString (junta elementos em uma
string) |
unshift (adiciona elementos no
início)
|
|
|
|
|
|
|
Pode ser definido como um conjunto ordenado de
valores, numéricos ou não, que são referenciados por um mesmo
nome.
Em geral, criado por uma das formas:
new Array(tamanho) ou
new Array(valor0, valor1, valor2, ...)
Exemplo:
nivel = new Array("baixo","medio","alto");
nivel = new Array[3];
Para este último, os valores devem ser dados individualmente:
nivel[0] = "baixo";
nivel[1] = "medio";
nivel[2] = "alto";
Exemplo com valores numéricos: nivel = new
Array(10, 20, 30);
Também pode ser criado a partir da forma literal:
nivel = ["baixo", "médio",
"alto"];
|
|
|
|
|
|
|
Junta seqüencialmente os elementos de uma array
usando o caractere (ou caracteres) dados por sep. Se ele não
é indicado, usa a vírgula como default.
Exemplos:
nivel = new Array("baixo","medio","alto");
str_1 = nivel.join(); //resulta "baixo,médio,alto"
em str_1
str_2 = nivel.join(", "); //resulta
"baixo, médio, alto" em str_2
str_3 = nivel.join("/"); //resulta
"baixo/médio/alto" em str_3
|
|
|
|
|
|
|
Indica o número de elementos em uma array. Pode ser
usado para diminuir o comprimento de um objeto já definido. Não
pode aumentar.
Exemplo:
nivel = new Array("baixo","medio","alto","muito
alto");
nivel.length = 3; //reduz o tamanho de 4 para 3
|
|
|
|
|
|
|
Remove e retorna o último elemento de uma array,
reduzindo o seu tamanho.
Exemplo:
nivel = new Array("baixo","medio","alto","muito
alto");
eliminado = nivel.pop; //a variável eliminado contém
"muito alto"
|
|
|
push(valor1,
valor2, ...)
|
↑Topo • Fim↓
|
|
|
|
Adiciona um ou mais elementos (valor1, valor2, etc)
ao final de uma array, retornando o seu novo tamanho.
Exemplo (a variável novo será 4 e os dois elementos
serão adicionados):
nivel = new Array("baixo","medio");
novo = nivel.push("alto","muito alto");
|
|
|
|
|
|
|
Inverte a ordem dos elementos. O primeiro se torna o
último e o último se torna o primeiro.
Exemplo (nivel[0], nivel[1] e nivel[2] serão respectivamente
"alto", "médio" e "baixo"):
nivel = new Array("baixo","medio","alto");
nivel.reverse();
|
|
|
|
|
|
|
Remove o primeiro elemento e retorna esse elemento,
reduzindo o tamanho da array.
Exemplo (a variável removido terá "muito
baixo" e a nivel não terá esse elemento):
nivel = new Array("muito baixo","baixo","medio","alto");
removido = nivel.shift();
|
|
|
|
|
|
|
Extrai uma parte de uma array e retorna uma nova com
essa parte. O parâmetro ini é o índice base zero a partir do qual
começa a extração. Os elementos são extraídos até, mas não
incluindo, o índice base zero dado por fim. Se este não é
indicado, a operação se dá até o final da seqüência.
A função não altera o objeto original. Os valores são copiados
para a nova array.
Exemplo (escreve: "baixo,médio,alto"):
nivel = new Array("muito baixo","baixo","medio","alto","muito
alto");
document.write(nivel.slice(1,4);
|
|
|
|
|
|
|
Ordena os elementos de uma array segundo o critério
da função de comparação func_comp. Se esta não é dada,
a ordenação se dá como se fosse um dicionário. No caso de
strings de texto, em geral essa operação é desejada. No caso de
números, pode não ser, uma vez que, por exemplo, 12 fica antes de
4.
A função de comparação deve ser uma do tipo comparar(a,b)
tal que:
- se retornar valor < 0, b fica em índice menor que a.
- se retornar valor = 0, a e b não mudam de índice.
- se retornar valor > 0, b fica em índice maior que a.
Para comparar números, a função pode ser simplesmente:
function comparar(a, b){
return a - b;
}
Exemplo:
function comparar(a, b){
return a - b;
}
num = new Array("11", "10", "7",
"8", "9");
document.write(num.sort()); //escreve 10,11,7,8,9
document.write("<br>");
document.write(num.sort(comparar)); |
|
|
splice(iniNdx, quant, [elm1][, ..., elmN])
|
↑Topo • Fim↓
|
|
|
|
Muda o conteúdo de uma array, adicionando novos
elementos e removendo outros.
iniNdx é o índice base zero a partir do qual a operação
começa.
quant é um inteiro indicando o número de elementos a
remover. Se é zero, nenhum elemento é removido, mas deve ser
indicado pelo menos um novo elemento.
elm1 ... elemN são os novos elementos a adicionar. Se não
indicados, a função apenas remove elementos.
Se o número de elementos a adicionar é diferente do número de
elementos a remover, o tamanho da arrray é alterado. A função
retorna uma array com os elementos removidos.
Exemplos:
num = new Array("10", "20",
"30", "40");
document.write(num); //escreve 10,20,30,40
document.write("<br>");
de_fora = num.splice(2,0,"25");
document.write(num);
document.write("<br>");
de_fora = num.splice(2,1,"28");
document.write(num);
document.write("<br>"); //avança uma linha
document.write(de_fora);
|
|
|
|
|
|
|
Retorna uma string com os elementos dispostos
seqüencialmente e separados por vírgula.
Exemplo:
num = new Array("10", "20",
"30", "40");
str = num.toString(); //str contém "10,20,30,40"
|
|
|
unshift(elm1,..., elmN)
|
↑Topo • Fim↓
|
|
|
|
Adiciona um ou mais elementos no início da array e
retorna seu novo tamanho. Os parâmetros (elm1, ..., elmN)
são os novos elementos.
Exemplo:
nivel = new Array("baixo","medio","alto","muito
alto");
nivel.unshift("muito baixo");
document.write(nivel); //escreve "muito baixo,baixo,medio,alto,muito
alto"
|
|
|
|
|
|
|
|
|
|