Métodos das listas
Listas são coleções ordenadas, sequências mutáveis, e como quase tudo em Python, são objetos e por isso vem acompanhadas de uma série de funções que podem ser acionadas com a sintaxe do ponto (dot syntax).
Na programação orientada a objetos vemos que funções atreladas a objetos de uma classe são conhecidas como métodos.
Antes de chegar aqui
Provavelmente você já leu neste material que é possível acrescentar itens à uma lista escrevendo lista.append(item)
, mas existem outras possibilidades!
Mais métodos
.extend(iterável)
- Prolonga a lista, adicionando no fim todos os elementos da coleção ou iterável passado como argumento.
.insert(i, x)
- Insere um item x
em uma dada posição i
. O primeiro argumento é o índice do elemento antes do qual será feita a inserção, assim a.insert(0, x)
insere um elemento na frente da lista e a.insert(len(a), x)
e equivale a a.append(x)
.
.remove(x)
- Remove o primeiro item encontrado na lista cujo valor é igual a x. Se não existir valor igual, uma exceção ValueError
é levantada.
.pop(i)
- Remove um item na posição i
da lista e o devolve. Se nenhum índice é especificado, .pop()
remove e devolve o último item da lista.
.index(*x*[, *inicio*[, *parada*]])
- Devolve o índice base-zero do primeiro item cujo valor é igual a x, levantando ValueError
se este valor não existe. Os argumentos opcionais inicio e parada são interpretados como nas notações de fatiamento e são usados para limitar a busca para uma subsequência específica da lista. O índice retornado é calculado relativo ao começo da sequência inteira e não referente ao argumento parada. (Nota: Os colchetes na demonstração do método indicam que os parâmetros são opcionais, e não que é necessário escrever estes colchetes ao chamar o método. Você verá este tipo de notação frequentemente na documentação do Python.)
.count(a)
- Devolve o número de vezes em que a
aparece na lista.
.sort([key=None][, reverse=False])
- Ordena os itens na lista (os argumentos podem ser usados para personalizar a ordenação, veja a função sorted()
para maiores explicações).
.reverse()
- Inverte a ordem dos elementos na lista.
.copy()
- Devolve uma cópia rasa da lista. Equivalente a a[:]
.
Você pode ler mais na Documentação do Python sobre as listas e outras estruturas de dados em 5.1. Mais sobre listas (na documentação do Python).
No Python mais moderno, a partir do Python 3.3, temos o método
.clear()
, que remove todos os itens de uma lista, equivale adel a[:]
.