Python List Append - Como adicionar um elemento a um array, explicado com exemplos

Bem-vinda

Oi! Se você deseja aprender como usar o append()método, este artigo é para você. Este é um método de lista poderoso que você definitivamente usará em seus projetos Python.

Neste artigo, você aprenderá:

  • Por que e quando você deve usar append().
  • Como chamar.
  • Seu efeito e valor de retorno.
  • Como pode ser equivalente a um insert()corte de string com os argumentos apropriados.

Você encontrará exemplos do uso de append()aplicado a strings, inteiros, flutuantes, booleanos, listas, tuplas e dicionários.

Vamos começar! ✨

? Objetivo

Com este método, você pode adicionar um único elemento ao final de uma lista .

Aqui você pode ver o efeito de append()graficamente:

? Dica: Para adicionar uma sequência de elementos individuais, você precisa usar o extend()método.

? Sintaxe e parâmetros

Esta é a sintaxe básica que você precisa usar para chamar este método:

? Dica: 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 particular.

Como você pode ver, o append()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
  • Tupla
  • Dicionário
  • Uma instância de uma classe personalizada

Basicamente, qualquer valor que você possa criar em Python pode ser anexado a uma lista.

? Dica: 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 o append()método, passando o elemento que queremos anexar (a string "B") como argumento.

? Efeito e valor de retorno

Este método sofre mutações (alterações) 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.

Em 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 após 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 se o valor de retorno de append()é Noneatribuindo 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, a sintaxe e o 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 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]

Acrescente 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

This works exactly the same for tuples, the entire tuple is appended as a single element.

>>> 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)] 

? Tip: If you need to add the elements of a list or tuple as individual elements of the original list, you need to use the extend() method instead of append(). To learn more about this, you can read my article: Python List Append VS Python List Extend – The Difference Explained with Array Method Examples

Append a dictionary

Similarly, if you try to append a dictionary, the entire dictionary will be appended as a single element of the list.

>>> data = [{"a": 1, "b": 2}] >>> data.append({"c": 3, "d": 4}) >>> data [{'a': 1, 'b': 2}, {'c': 3, 'd': 4}]

? Equivalence of Append and Insert

An interesting tip is that the insert() method can be equivalent to append() if we pass the correct arguments.

The insert() method is used to insert an element at a particular index (position) in the list.

This is the syntax used to call the insert() method:

To make it equivalent to append():

  • The value of index has to be the length of the list (len()) because we want the element to be the last element of the list.

Here's an example that shows that the result of using insert with these arguments is equivalent to 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']

But as you have seen, append() is much more concise and practical, so it's usually recommended to use it in this case.

? Equivalence of Append and List Slicing

There is also an interesting equivalence between the append() method and list slicing.

This syntax is essentially assigning the list that contains the element [] as the last portion (end) of the list. Here you can see that the result is equivalent to 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, normalmente 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 considerado útil. Agora você pode trabalhar com append()seus projetos Python. Confira meus cursos online. Siga me no twitter. ⭐️