Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

`*args` y `**kwargs`: recoger y reenviar argumentos

En una definición, `*args` recoge los argumentos posicionales sobrantes y `**kwargs` los argumentos por nombre sobrantes. En una llamada, los mismos asteriscos desempaquetan valores.

Versión: Python 3.12

Sintaxis

def wrapper(*args, **kwargs):
    return target(*args, **kwargs)

def dispatch(handler, /, *args, label="items"):
    return handler(*args, label=label)

En una definición de función de Python 3.12, *args recoge en una tupla los argumentos posicionales que no se asignaron a otros parámetros, en el orden en que se pasaron. **kwargs recoge los argumentos por nombre restantes en un nuevo dict. Si no hay nada que recoger, reciben () y {}, respectivamente. Los nombres args y kwargs son convencionales: los asteriscos determinan el comportamiento.

Un parámetro ordinario declarado después de *args, como label, solo se puede pasar por nombre. Un * solo marca el inicio de esos parámetros, pero no recoge nada. Los parámetros anteriores a /, como handler en el ejemplo, son exclusivamente posicionales. Si aparece **kwargs, debe ser el último parámetro.

En una llamada como target(*args, **kwargs), la operación se invierte: * desempaqueta un iterable en argumentos posicionales separados y ** desempaqueta un mapeo con claves de tipo cadena en argumentos por nombre. Escribir explícitamente dos veces el mismo nombre de argumento en una llamada provoca un SyntaxError al compilar. Si el desempaquetado con ** introduce un nombre de argumento duplicado, o si un argumento posicional y uno por nombre proporcionan cada uno un valor para el mismo parámetro, la llamada provoca un TypeError en tiempo de ejecución.

La función envoltorio wrapper recoge y reenvía ambas clases de argumentos. La función de despacho dispatch solo recoge los argumentos posicionales sobrantes, recibe label por separado y llama a handler. Si un argumento por nombre no se admite en dispatch, la llamada reenviada provoca TypeError, aunque wrapper lo acepte.

Ejemplos

def render(*values, label):
    return f"{label}: {values}"


def dispatch(handler, /, *args, label="items"):
    return handler(*args, label=label)


def wrapper(*args, **kwargs):
    return dispatch(render, *args, **kwargs)


print(wrapper(3, 5, label="points"))
print(wrapper())

Resultado

points: (3, 5)
items: ()

En la primera llamada, `dispatch` asigna `label="points"` a `label` y recoge `3` y `5` en `args`. En la segunda, `wrapper` no tiene nada que recoger, así que `dispatch` usa su valor predeterminado `"items"`.

Lecciones relacionadas

  • Python · Lección 44 · Avanzado · Versión: 5

Fuentes