Saltearse al contenido

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.

La clausura no captura valores: captura variables, y las mantiene vivas mientras la función exista.

def fabricar_contador():
cuenta = 0
def incrementar():
nonlocal cuenta
cuenta += 1
return cuenta
return incrementar
c = fabricar_contador()
c() # 1
c() # 2

Cuando 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 # 2

Sin nonlocal, cuenta += 1 crearía una variable local nueva y lanzaría UnboundLocalError: el intérprete decide que es local porque se asigna dentro.

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.

Leer una variable según su ámbito
Á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.

  • 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 total explícitamente es más claro que capturarlo, salvo que sea el punto de la función.

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() # 2

incrementar 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.

  • 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.
  • 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.