Clausuras y nonlocal
Una clausura es una función que se lleva consigo el entorno donde nació. Cuando una función interna usa una variable de la externa, Python no copia el valor: guarda una celda compartida, y la función externa puede terminar sin que la celda desaparezca. De ahí salen los contadores sin clase, los decoradores y el error de las lambda en un bucle.
En una línea
Sección titulada «En una línea»La clausura no captura valores: captura variables, y las mantiene vivas mientras la función exista.
El mecanismo
Sección titulada «El mecanismo»def fabricar_contador(): cuenta = 0
def incrementar(): nonlocal cuenta cuenta += 1 return cuenta
return incrementar
c = fabricar_contador()c() # 1c() # 2Cuando fabricar_contador retorna, su marco de pila desaparece, pero cuenta no: se convirtió en una celda que incrementar referencia. Se puede ver:
c.__closure__ # (<cell at 0x...: int object at 0x...>,)c.__closure__[0].cell_contents # 2Sin nonlocal, cuenta += 1 crearía una variable local nueva y lanzaría UnboundLocalError: el intérprete decide que es local porque se asigna dentro.
nonlocal, global y el silencio
Sección titulada «nonlocal, global y el silencio»| Declaración | Dónde busca | Qué modifica |
|---|---|---|
| Sin declaración | LEGB (lectura) | Sólo local |
nonlocal x |
El ámbito externo más cercano | Esa celda |
global x |
El módulo | La global |
La regla que hay que memorizar: asignar dentro de una función crea una local, salvo que declares lo contrario. Leer una global funciona sin declarar; escribirla requiere global. Es la razón de que UnboundLocalError aparezca en funciones que parecían correctas.
Lo que cuesta
Sección titulada «Lo que cuesta»| Ámbito | Por lectura | Frente a local |
|---|---|---|
| Local | 23.1 ns | 1.00× |
| Cierre | 25.2 ns | 1.09× |
| Global | 27.4 ns | 1.19× |
| Builtin | 37.6 ns | 1.63× |
python mediciones/03-01-04-funciones.py
Nueve por ciento por leer una celda en lugar de una local. En un bucle de un millón son dos milisegundos: suficiente para notarlo en un perfil, insuficiente para rediseñar. Lo que sí importa es el coste de memoria: una clausura retiene todo lo que su celda referencia, aunque la función externa haya terminado.
Clausura o clase: el mismo estado, dos formas
Sección titulada «Clausura o clase: el mismo estado, dos formas»Un contador se puede escribir de las dos maneras:
def contador_cierre(): n = 0 def inc(): nonlocal n n += 1 return n return inc
class Contador: def __init__(self): self.n = 0 def __call__(self): self.n += 1 return self.n| Clausura | Clase | |
|---|---|---|
| Estado inspeccionable | No (hay que mirar __closure__) |
Sí (c.n) |
| Añadir un segundo método | Difícil | Trivial |
| Serializar | No | Sí, con pickle |
| Coste | Una función | Un objeto con __dict__ |
La regla: una sola operación y estado privado, clausura; dos o más operaciones o estado que se inspecciona, clase. Convertir una clausura en clase después es fácil; al contrario, también, pero nadie lo hace.
La trampa
Sección titulada «La trampa»Cuándo no aplica
Sección titulada «Cuándo no aplica»- Si necesitas estado inspeccionable. Una celda no se puede leer sin
__closure__; una instancia con atributos sí. Para estado con nombre, clase. - Si necesitas varias instancias independientes y serializables. Las clausuras no se pueden serializar con
pickle. - Si el código se lee mejor con un parámetro. Pasar
totalexplícitamente es más claro que capturarlo, salvo que sea el punto de la función.
Ejercicio
Sección titulada «Ejercicio»Escribe una función contador() que devuelva dos funciones: incrementar() y valor(), compartiendo el mismo estado. Después explica por qué no hace falta nonlocal en la segunda.
Solución
def contador(): cuenta = 0
def incrementar(): nonlocal cuenta cuenta += 1
def valor(): return cuenta
return incrementar, valor
inc, val = contador()inc(); inc()val() # 2incrementar necesita nonlocal porque asigna a cuenta; sin la declaración, cuenta += 1 crearía una local. valor sólo lee, y leer una variable del ámbito externo no requiere declaración: el intérprete la busca en la celda sin más.
Las dos funciones comparten la misma celda, así que el estado es único. Eso es lo que las hace un contador y no dos funciones independientes.
Comprobación con datos de ejemplo:
print("tras dos incrementos:", val())inc()print("tras tres:", val())otro_inc, otro_val = contador()print("contador independiente:", otro_val())assert val() == 3, "las dos funciones comparten la celda"Referencias
Sección titulada «Referencias»- Ramalho, L. Fluent Python, 2ª ed. Capítulo 9: decoradores y clausuras.
- CPython 3.13:
Objects/cellobject.c. - Mediciones:
mediciones/03-01-04-funciones.py.
Capítulos relacionados
Sección titulada «Capítulos relacionados»- 01 · Funciones como objetos: la base que hace posible devolver una función.
- 03 · Decoradores: la aplicación directa de las clausuras.
- 10 · Composición y pipelines: cuándo una clausura es mejor que un objeto.