Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

functools.partial

Devolve um objeto que se pode chamar com argumentos predefinidos sem executar func.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

functools.partial(func, /, *args, **keywords)

Devolve um objeto que se pode chamar com argumentos predefinidos sem executar func.

Em CPython 3.14.9, partial(dict, key=Placeholder) e partial(print, Placeholder) lançam TypeError logo na construção. Placeholder tem de ser posicional e não pode ficar no fim dos argumentos guardados. Os novos argumentos posicionais são acrescentados, mas em 3.14 preenchem primeiro os lugares Placeholder. Um lugar por preencher gera TypeError. Os novos argumentos nomeados substituem os guardados.

Aqui a cadeia 10 dá 16 na base 16 e depois 2 na base 2.

from functools import partial, Placeholder as hole
p = partial(str.replace, hole, "a", "x")
assert p("aba") == "xbx"
try:
    p()
except TypeError:
    pass
else:
    raise AssertionError
for make in (lambda: partial(dict, key=hole), lambda: partial(print, hole)):
    try: make()
    except TypeError: pass
    else: raise AssertionError

Exemplos

import functools
parse = functools.partial(int, base=16)
print(parse("10"), parse("10", base=2))

Resultado

16 2

Aqui a cadeia 10 dá 16 na base 16 e depois 2 na base 2.

Fontes