¡Bienvenido(a)! Si deseas aprender a usar el método append() en Python, este artículo es para ti. append() es un método que necesitarás para trabajar con listas en tus proyectos de Python.

En este artículo aprenderás:

  • Por qué y cuándo debes usar el método append() en Python.
  • Cómo llamar al método append() en Python.
  • Su efecto en la lista.
  • Cómo el método append() puede ser equivalente al método insert() y al rebanado de listas.

Verás ejemplos del uso del método append() para agregar cadenas de caracteres, números de coma flotante, valores booleanos, listas, tuplas, y diccionarios a una lista.

¡Comencemos!  ✨

🔹 Propósito de append()

Con este método, puedes agregar un elemento al final de la lista.

Aquí puedes ver el efecto de append() gráficamente con un ejemplo:

image-59

💡 Dato: Para agregar varios elementos puedes usar el método extend().

🔸 Sintaxis y Parámetros

Ésta es la sintaxis básica que debes usar para llamar a éste método:

image-26

💡 Datos:

  • El punto es muy importante porque append() es un método. Cuando llamamos a un método, escribimos el nombre de la lista seguida de un punto para indicar que queremos modificar esa lista en particular.
  • El primer elemento de la sintaxis (la lista) usualmente es una variable.

Como puedes ver, para llamar al método append() también debemos especificar un argumento, el elemento que deseamos agregar a la lista. Este elemento puede ser de cualquier tipo de dato:

  • Un entero (int).
  • Una cadena de caracteres (str).
  • Un número de coma flotante (float).
  • Valores Booleanos (bool).
  • Una lista (list).
  • Una tupla (tuple).
  • Un diccionario (dict).
  • Una instancia de una clase definida en el programa.

Básicamente, cualquier valor que podemos crear y usar en Python puede ser agregado a una lista con el método append().

Ejemplo

Este es un ejemplo de cómo puedes llamar al método append():

>>> notas_musicales = ["Do", "Re", "Mi", "Fa", "Sol", "La"]

>>> notas_musicales.append("Si")
  • Primero, se define la lista y se asigna a una variable.
  • Luego, usando esta variable llamamos al método append(), pasando el elemento que queremos agregar como argumento. En este caso, el elemento es la cadena de caracteres "Si".

🔹 Efecto y Valor Retornado

Cuando llamamos a append(), estamos mutando (cambiando) la lista original en memoria porque este método no retorna una copia nueva de la lista (como podríamos pensar inicialmente) sino que retorna el valor None.

En el ejemplo anterior:

>>> notas_musicales = ["Do", "Re", "Mi", "Fa", "Sol", "La"]

>>> notas_musicales.append("Si")

Si verificamos el valor de la lista luego de llamar al método append(), puedes ver que la lista original fue modificada ya que ahora el último elemento es 'Si':

>>> notas_musicales
['Do', 'Re', 'Mi', 'Fa', 'Sol', 'La', 'Si']

💡 Dato: Podemos confirmar que el valor retornado por append() es None si asignamos este valor a una variable y luego mostramos su valor con print():

>>> notas_musicales = ['Do', 'Re', 'Mi', 'Fa', 'Sol', 'La']

>>> valor_retornado = notas_musicales.append("Si")

>>> print(valor_retornado)
None

🔸 Ejemplos

Ahora que ya sabes el propósito, la sintaxis, y el efecto del método append(), veamos algunos ejemplos de cómo puedes usarlo con distintos tipos de datos.

Agregar una Cadena de Caracteres

>>> los_mejores_jugadores = ["gino234", "nor233", "lal453"]

>>> los_mejores_jugadores.append("auop342")

# La cadena de caracteres fue agregada al final de la lista
>>> los_mejores_jugadores
['gino234', 'nor233', 'lal453', 'auop342']

Agregar un Entero

>>> mi_lista = [435, 324, 275, 567, 123]

>>> mi_lista.append(456)

>>> mi_lista
[435, 324, 275, 567, 123, 456]

Agregar un Número de Coma Flotante

>>> mi_lista = [435.34, 324.35, 275.45, 567.34, 123.23]

>>> mi_lista.append(456.23)

>>> mi_lista
[435.34, 324.35, 275.45, 567.34, 123.23, 456.23]

Agregar un Valor Booleano

>>> mi_lista = [True, True, False, True]

>>> mi_lista.append(False)

>>> mi_lista
[True, True, False, True, False]

Agregar una Lista

El método append() nos permite agregar un solo elemento al final de la lista, así que si pasas una lista como argumento, toda la lista será agregada como un elemento de la lista original. Será agregada como una lista anidada dentro de la lista original:

>>> mi_lista = [[4.5, 4.8, 5.7], [2.5, 2.6, 2.7]]

>>> mi_lista.append([6.7, 2.3])

# Se agrega la lista completa
>>> mi_lista
[[4.5, 4.8, 5.7], [2.5, 2.6, 2.7], [6.7, 2.3]]

Agregar una Tupla

Este método funciona exactamente igual para las tuplas. Toda la tupla es agregada a la lista original como un solo elemento.

>>> mi_lista = [[4.5, 4.8, 5.7], [2.5, 2.6, 2.7]]

>>> mi_lista.append((6.7, 2.3))

# Se agrega la tupla completa
>>> mi_lista
[[4.5, 4.8, 5.7], [2.5, 2.6, 2.7], (6.7, 2.3)] 

💡 Dato: Si necesitas añadir los elementos individuales de una lista o tupla a la lista original, debes usar el método extend() en lugar de append().  

Agregar un Diccionario

De igual forma, puedes agregar un diccionario como un elemento de la lista original usando el método append().

>>> mi_lista = [{"a": 1, "b": 2}]

>>> mi_lista.append({"c": 3, "d": 4})

>>> mi_lista
[{'a': 1, 'b': 2}, {'c': 3, 'd': 4}]

🔹 Equivalencia Entre append() e insert()

Un dato interesante es que el efecto del método insert() puede ser equivalente al efecto del método append() si pasamos argumentos específicos.

El método insert() es utilizado para insertar un elemento en un índice (una posición) particular de la lista.

Esta es la sintaxis que debes utilizar para llamar al método insert():

image-27

Para que insert() sea equivalente a append():

  • El valor del índice debe ser el tamaño de la lista (len(<lista>)) porque queremos agregar el nuevo elemento al final de la lista.

Aquí tenemos un ejemplo que demuestra que el efecto de llamar al método insert() con estos argumentos es equivalente a llamar a append():

>>> notas_musicales = ["Do", "Re", "Mi", "Fa", "Sol", "La"]

>>> notas_musicales.insert(len(notas_musicales), "Si")

>>> notas_musicales
['Do', 'Re', 'Mi', 'Fa', 'Sol', 'La', 'Si']

Pero como seguramente habrás notado, llamar al método append() es mucho más conciso que esta alternativa, por lo que es recomendable usar el método append() para agregar un elemento al final de la lista.

🔸 Equivalencia de append() y Rebanado de Listas

También existe una equivalencia interesante entre el método append() y el rebanado de listas:

image-28

Esta sintaxis básicamente asigna la lista que contiene al elemento [<elemento>] como la porción final de la lista original.

Aquí puedes ver que el resultado es equivalente a append():

>>> notas_musicales = ["Do", "Re", "Mi", "Fa", "Sol", "La"]

>>> notas_musicales[len(notas_musicales):] = ["Si"]

>>> notas_musicales
['Do', 'Re', 'Mi', 'Fa', 'Sol', 'La', 'Si']

🔹 En Resumen

  • Podemos llamar al método append() para agregar un elemento de cualquier tipo al final de una lista.
  • Aunque existen otras alternativas que generan el mismo efecto en la lista, en la práctica normalmente usamos el método append() porque es un método muy útil en Python y su sintaxis es concisa.

Espero que te haya gusta mi artículo y que te haya sido de utilidad. Ahora puedes agregar elementos a tus listas en Python con el método append().