Mis apuntes · Aprende Python desde PHP

Se guardan solos en este navegador mientras escribes. Puedes usar Markdown. Al descargarlos, la primera línea es tu enlace personal al curso.

Lección 8 de 47 · El array de PHP en Python ✦ WebMCP implementado

tuple: inmutable, desempaquetado y namedtuple

8 min de lectura 3 retos

Una tupla es una lista que no se puede cambiar. PHP no tiene nada igual: su array siempre se puede modificar. En esta lección ves para qué sirve algo que no cambia, cómo desempaquetarlo en variables y cómo ponerle nombres a sus campos con namedtuple.

¿De dónde vienen los nombres?

tuple = del final de quíntuple, séxtuple… (del latín -plus: «veces»)
En matemáticas, una n-tupla es un grupo ordenado de n valores (doble, triple, cuádruple…). Python se quedó con el final de la palabra.
desempaquetar (unpacking) = inglés unpack (sacar de la caja)
Repartir los valores de una tupla (o lista) en varias variables de un golpe: titulo, prioridad = tarea. Es el [$a, $b] = $par de PHP.
namedtuple = inglés named tuple (tupla con nombre)
Una tupla cuyos huecos tienen nombre, para leer tarea.titulo en vez de tarea[1]. Vive en el módulo collections.
_ = un guion bajo: nombre de variable por convención
Se usa para «este valor no me importa»: _, prioridad = tarea. No es una palabra reservada, es una costumbre.
En 4 ideas
1/4

Una tuple es una lista inmutable: ("Comprar pan", 2). Una vez creada no puedes añadir, quitar ni cambiar nada. En PHP los arrays siempre se pueden cambiar (lo más parecido es un objeto readonly).

1 · Qué es una tupla y para qué sirve algo que no cambia

Una tupla se escribe con paréntesis y comas: ("Comprar pan", 2). Se lee igual que una lista (índices, len, rebanadas, in, for), pero nada de modificarla: no tiene append, ni pop, ni sort, y si intentas tupla[0] = 5 Python se queja.

Pythonmain.py
tarea = ("Comprar pan", 2)

# En PHP: echo $tarea[0] . PHP_EOL;
print(tarea[0])
print(len(tarea))
print("Comprar pan" in tarea)

# Una tupla no se puede cambiar. try/except es el try/catch de PHP (módulo 07).
try:
    tarea[1] = 3
except TypeError as error:
    print("Error:", error)

# Para «cambiarla» se crea otra.
tarea = (tarea[0], 3)
print(tarea)

# Los paréntesis no hacen falta: la coma es lo que crea la tupla.
coordenada = 40.4, -3.7
print(coordenada, type(coordenada))

Piensa en la fecha de nacimiento en tu DNI: una vez impresa, no se corrige con un bolígrafo. Una lista es una libreta; una tupla, un carné.

¿Para qué sirve entonces? Tres casos de uso reales:

  1. Valores que van juntos y no deben cambiar: ("Comprar pan", 2) es «título y prioridad» de una tarea; (40.4, -3.7), una coordenada; (2026, 11, 19), una fecha.
  2. Devolver varios valores de una función: return minimo, maximo devuelve una tupla. En PHP devolverías un array y lo abrirías con [$min, $max] = ....
  3. Claves de un diccionario: una lista no puede ser clave (porque podría cambiar y perderse), una tupla sí. Lo verás en la lección de diccionarios.
PHP 8.5index.php
<?php
declare(strict_types=1);

function minimoYMaximo(array $numeros): array
{
    return [min($numeros), max($numeros)];
}

[$minimo, $maximo] = minimoYMaximo([3, 1, 2]);

echo "$minimo - $maximo" . PHP_EOL;
Pythonmain.py
def minimo_y_maximo(numeros):
    return min(numeros), max(numeros)


minimo, maximo = minimo_y_maximo([3, 1, 2])

print(f"{minimo} - {maximo}")

¿Por qué? · En PHP no existe

¿Por qué existe un tipo que no se puede cambiar? En PHP no existe

Cuando le pasas una lista a una función, esa función puede cambiarla y tú te enteras tarde. Con una tupla tienes la garantía de que nadie la va a tocar, ni tú mismo dentro de tres semanas. Es la misma idea que readonly en una propiedad de PHP 8.5, pero en un tipo pequeño y rápido.

Además, como no cambia, Python puede usarla como clave de un diccionario y es un poco más ligera y rápida que una lista.

2 · Desempaquetar: repartir una tupla en variables

Desempaquetar es abrir la caja y poner cada cosa en su variable. Funciona con tuplas y con listas y no hace falta escribir paréntesis.

Pythonmain.py
tarea = ("Comprar pan", 2, False)

# En PHP: [$titulo, $prioridad, $hecha] = $tarea;
titulo, prioridad, hecha = tarea
print(titulo, prioridad, hecha)

# Con _ se ignora lo que no interesa.
_, prioridad, _ = tarea
print(prioridad)

# Con * se recoge «el resto» en una lista.
primera, *resto = ["Pan", "Banco", "Python", "Regar"]
print(primera)
print(resto)

primera, *medio, ultima = ["Pan", "Banco", "Python", "Regar"]
print(medio, ultima)

# Intercambiar dos variables sin variable temporal.
a = "pendiente"
b = "hecha"

# En PHP: [$a, $b] = [$b, $a];
a, b = b, a
print(a, b)

# Se puede desempaquetar dentro de un for.
tareas = [("Pan", 2), ("Banco", 1)]
for titulo, prioridad in tareas:
    print(f"[P{prioridad}] {titulo}")
PHP 8.5index.php
<?php
declare(strict_types=1);

$tareas = [["Pan", 2], ["Banco", 1]];

foreach ($tareas as [$titulo, $prioridad]) {
    echo "[P$prioridad] $titulo" . PHP_EOL;
}

[$primera, , $ultima] = ["Pan", "Banco", "Python"];
echo "$primera / $ultima" . PHP_EOL;
Pythonmain.py
tareas = [("Pan", 2), ("Banco", 1)]

for titulo, prioridad in tareas:
    print(f"[P{prioridad}] {titulo}")

primera, _, ultima = ["Pan", "Banco", "Python"]
print(f"{primera} / {ultima}")

Si el número de variables no coincide con el de valores, Python lanza un error (ValueError). PHP rellenaría las que sobran con null y un Warning. Es un seguro: te avisa de que la tupla no tenía la forma que creías.

3 · La trampa de la tupla de un elemento

Los paréntesis también sirven para agrupar operaciones: (2 + 3) * 4. Por eso (5) es solo el número 5 con paréntesis. Lo que hace tupla es la coma:

Pythonmain.py
numero = (5)
tupla = (5,)
vacia = ()

print(type(numero))
print(type(tupla))
print(type(vacia))

# Esto también es una tupla de un elemento, sin paréntesis.
sola = "Comprar pan",
print(sola, len(sola))

¿Por qué? · En PHP no existe

¿Por qué hace falta la coma en la tupla de un elemento?

Porque Python necesita distinguir (5) («el número 5 entre paréntesis», como en una suma) de «una tupla con un 5». Si no hubiera coma, (2 + 3) * 4 sería ambiguo. La coma es lo que crea la tupla; los paréntesis solo ayudan a leer.

En PHP un array de un elemento es [5] y no hay confusión posible, porque los corchetes solo significan array. Aquí los paréntesis significan dos cosas.

4 · namedtuple: una tupla con nombres

tarea[1] no dice qué es el 1. ¿Prioridad? ¿Título? Con namedtuple le pones nombre a cada hueco y sigue siendo una tupla (inmutable, ligera, desempaquetable).

Pythonmain.py
from collections import namedtuple

Tarea = namedtuple("Tarea", ["id", "titulo", "hecha"])

tarea = Tarea(1, "Comprar pan", False)

# En PHP: echo $tarea->titulo . PHP_EOL;
print(tarea.titulo)

# También se puede por posición, como una tupla normal.
print(tarea[1])
print(tarea)

# Es inmutable: para «cambiarla» se crea una copia con _replace.
terminada = tarea._replace(hecha=True)
print(terminada)
print(tarea.hecha)

# Se desempaqueta igual que cualquier tupla.
id_tarea, titulo, hecha = terminada
print(id_tarea, titulo, hecha)

# Y se convierte en diccionario con _asdict.
print(terminada._asdict())
PHP 8.5index.php
<?php
declare(strict_types=1);

final readonly class Tarea
{
    public function __construct(
        public int $id,
        public string $titulo,
        public bool $hecha = false,
    ) {
    }

    public function terminada(): self
    {
        return new self($this->id, $this->titulo, true);
    }
}

$tarea = new Tarea(1, "Comprar pan");
echo $tarea->terminada()->titulo . PHP_EOL;
Pythonmain.py
from collections import namedtuple

Tarea = namedtuple("Tarea", ["id", "titulo", "hecha"], defaults=[False])

tarea = Tarea(1, "Comprar pan")
print(tarea._replace(hecha=True).titulo)

Una namedtuple es, de hecho, lo más parecido a una clase PHP final readonly que escribirías en una línea. Su versión con sintaxis de clase es typing.NamedTuple, y en el módulo 05 verás @dataclass, que es la opción para casi todo (con campos que sí se pueden cambiar).

Quiero…UsarEjemplo
Un grupo fijo de valores sin nombretuple(40.4, -3.7)
Un grupo fijo con nombre para cada camponamedtupleTarea(1, "Pan", False)
Muchos valores iguales que crecenlist["Pan", "Banco"]
Un registro que cambia@dataclass (módulo 05)tarea.hecha = True

Hora de practicar

Retos · 0/3 resueltos

Reto 1 de 3

Abre la caja

La tupla tarea tiene el título y la prioridad. Desempaquétala en las variables titulo y prioridad e imprime exactamente [P2] Comprar pan. Es el [$titulo, $prioridad] = $tarea; de PHP.

Al pulsar Comprobar, unos tests ocultos prueban tu código en tu navegador, con Python 3.14.

Pythonmain.py · editable

Resumen

Lo que te llevas de esta lección

  1. Una tuple es una lista inmutable: ("Pan", 2). PHP no tiene arrays inmutables (lo más cercano es readonly).
  2. Agrupa valores que van juntos y es la forma natural de devolver varios valores (return a, b).
  3. Desempaquetar: a, b = tupla (en PHP, [$a, $b] = $t), *resto para lo que sobra y a, b = b, a para intercambiar.
  4. La tupla de un elemento lleva coma: (5,). (5) es solo el número 5.
  5. namedtuple da nombre a cada hueco (tarea.titulo) y se «modifica» con _replace, como un objeto readonly.

Para recordarlo: «Fija, Junta, Reparte»

FFija
no se puede cambiar: ("Pan", 2)
JJunta
valores distintos que van juntos
RReparte
titulo, prioridad = tarea

La tupla es Fija, Junta cosas distintas y se Reparte en variables. Y para recordar la trampa: «la coma hace la tupla, no el paréntesis».