💡 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. 👍