💡 Gorjeta: Para adicionar uma sequência de elementos individuais, você precisaria usar o extend()
método.
Sintaxe e parâmetros
Esta é a sintaxe básica que você precisa usar para chamar este método:
💡 Gorjeta: O ponto é muito importante, pois append()
é um método Quando chamamos um método, usamos um ponto após a lista para indicar que queremos “modificar” ou “afetar” essa lista específica.
Como você pode ver, o append()
O método leva apenas um argumento, o elemento que você deseja anexar. Este elemento pode ser de qualquer tipo de dados:
- Inteiro
- Corda
- Flutuador
- boleano
- Outra lista
- Tuple
- Dicionário
- Uma instância de uma classe personalizada
Basicamente, qualquer valor que você possa criar no Python pode ser anexado a uma lista.
💡 Gorjeta: O primeiro elemento da sintaxe (a lista) é geralmente uma variável que faz referência a uma lista.
Exemplo
Este é um exemplo de uma chamada para append()
:
>>> musical_notes = ["C", "D", "E", "F", "G", "A"]>>> musical_notes.append("B")
- Primeiro, a lista é definida e atribuída a uma variável.
- Então, usando essa variável, chamamos de
append()
, passando o elemento que queremos acrescentar (a string"B"
) como argumento.
Efeito e valor de retorno
Este método muda (muda) a lista original na memória. Ele não retorna uma nova cópia da lista, como poderíamos pensar intuitivamente, ele retorna None
. Portanto, apenas chamando esse método, você está modificando a lista original.
No nosso exemplo anterior:
>>> musical_notes = ["C", "D", "E", "F", "G", "A"]>>> musical_notes.append("B")
Você pode ver (abaixo) que a lista original foi modificada depois de anexar o elemento. O último elemento é agora "B"
e a lista original agora é a versão modificada.
>>> musical_notes['C', 'D', 'E', 'F', 'G', 'A', 'B']
Você pode confirmar que o valor de retorno de append()
é None
atribuindo esse valor a uma variável e imprimindo-o:
>>> musical_notes = ["C", "D", "E", "F", "G", "A"]>>> a = musical_notes.append("B")>>> print(a)None
Exemplos
Agora que você conhece o propósito, sintaxe e efeito do append()
método, vamos ver alguns exemplos de seu uso com vários tipos de dados.
Anexar uma String
>>> top_players = ["gino234", "nor233", "lal453"]>>> top_players.append("auop342")# The string was appended>>> top_players['gino234', 'nor233', 'lal453', 'auop342']
Anexar um número inteiro
>>> data = [435, 324, 275, 567, 123]>>> data.append(456)>>> data[435, 324, 275, 567, 123, 456]
Anexar um flutuador
>>> data = [435.34, 324.35, 275.45, 567.34, 123.23]>>> data.append(456.23)>>> data[435.34, 324.35, 275.45, 567.34, 123.23, 456.23]
Anexar um valor booleano
>>> values = [True, True, False, True]>>> values.append(False)>>> values[True, True, False, True, False]
Anexar uma lista
Este método anexa um único elemento ao final da lista; portanto, se você passar uma lista como argumento, a lista inteira será anexada como um único elemento (será uma lista aninhada na lista original).
>>> data = [[4.5, 4.8, 5.7], [2.5, 2.6, 2.7]]>>> data.append([6.7, 2.3])>>> data[[4.5, 4.8, 5.7], [2.5, 2.6, 2.7], [6.7, 2.3]]
Anexar uma tupla
Isso funciona exatamente da mesma maneira para as tuplas, toda a tupla é anexada como um único elemento.
>>> data = [[4.5, 4.8, 5.7], [2.5, 2.6, 2.7]]>>> data.append((6.7, 2.3))>>> data[[4.5, 4.8, 5.7], [2.5, 2.6, 2.7], (6.7, 2.3)]
💡 Gorjeta: Se você precisar adicionar os elementos de uma lista ou tupla como elementos individuais da lista original, precisará usar o extend()
método em vez de append()
. Para saber mais sobre isso, você pode ler meu artigo: Lista Python Anexar VS Lista Python Estender – A Diferença Explicada com Exemplos de Métodos Array
Anexar um dicionário
Da mesma forma, se você tentar anexar um dicionário, o dicionário inteiro será anexado como um único elemento da lista.
>>> data = [{"a": 1, "b": 2}]>>> data.append({"c": 3, "d": 4})>>> data[{'a': 1, 'b': 2}, {'c': 3, 'd': 4}]
Equivalência de Anexar e Inserir
Uma dica interessante é que o insert()
método pode ser equivalente a append()
se passarmos os argumentos corretos.
o insert()
O método é usado para inserir um elemento em um índice (posição) específico na lista.
Essa é a sintaxe usada para chamar o insert()
método:
Para torná-lo equivalente a append()
:
- O valor do índice deve ser o tamanho da lista (
len(
) porque queremos que o elemento seja o último elemento da lista.- )
Aqui está um exemplo que mostra que o resultado do uso de insert com esses argumentos é equivalente a append()
:
>>> musical_notes = ["C", "D", "E", "F", "G", "A"]>>> musical_notes.insert(len(musical_notes), "B")>>> musical_notes['C', 'D', 'E', 'F', 'G', 'A', 'B']
Mas … como você viu neste artigo, append()
é muito mais conciso e prático, por isso geralmente é recomendável usá-lo nesse caso.
Equivalência de Fatiar Anexar e Listar
Existe também uma equivalência interessante entre os append()
método e lista de fatiamento.
Essa sintaxe está essencialmente atribuindo a lista que contém o elemento [
como a última parte (final) da lista. Aqui você pode ver que o resultado é equivalente a append()
:
>>> musical_notes = ["C", "D", "E", "F", "G", "A"]>>> musical_notes[len(musical_notes):] = ["B"]>>> musical_notes['C', 'D', 'E', 'F', 'G', 'A', 'B']
Essas são alternativas interessantes, mas, para fins práticos, geralmente usamos append()
porque é uma ferramenta inestimável que o Python oferece. É preciso, conciso e fácil de usar.
Eu realmente espero que você tenha gostado do meu artigo e tenha sido útil. Agora você pode trabalhar com append()
nos seus projetos Python. Confira meus cursos on-line. Siga-me no Twitter. 👍