Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Python

Čtení názvu úlohy pomocí `asyncio.Task.get_name()`

`get_name()` vrací aktuální název úlohy asyncio jako řetězec. V hlášení jej použij jako popisek a skutečné zrušení úlohy ověř zvlášť pomocí `cancelled()`.

Verze: Python 3.12

Syntaxe

task.get_name()  # returns str

task.get_name() je synchronní instanční metoda asyncio.Task, dostupná od Pythonu 3.8. Nepřijímá argumenty a vrací aktuální název jako str. Nepoužívá se s await: název lze přečíst před dokončením úlohy i po něm.

Název nastav při vytváření pomocí asyncio.create_task(coro, name=...) nebo ho změň metodou task.set_name(value), která hodnotu převede na řetězec. Pokud název výslovně nezadáš, standardní implementace Task jej vygeneruje při vytvoření úlohy. Používej jej jako diagnostický popisek, ne jako jedinečný identifikátor ani ukazatel stavu.

task.cancel() požádá o zrušení, ale nezaručuje je: korutina může výjimku asyncio.CancelledError zachytit a potlačit. Pro hlášení výsledku počkej na dokončení pomocí await task, ošetři očekávanou výjimku asyncio.CancelledError a zkontroluj task.cancelled(). Korutina by běžně měla uvolnit prostředky v finally a nechat zrušení šířit dál.

Příklady

import asyncio


async def worker(started):
    started.set()
    await asyncio.Event().wait()


async def main():
    started = asyncio.Event()
    task = asyncio.create_task(worker(started), name="report-worker")
    await started.wait()
    task.cancel()

    try:
        await task
    except asyncio.CancelledError:
        print(f"{task.get_name()}: cancelled={task.cancelled()}")


if __name__ == "__main__":
    asyncio.run(main())

Výsledek

report-worker: cancelled=True

Událost `started` umožňuje volajícímu počkat na spuštění korutiny bez pevné prodlevy. Druhá událost se nikdy nenastaví, takže úloha čeká až do zrušení. Hlášení spojuje výslovně zadaný název se stavem potvrzeným po `await task`.

Související lekce

  • Python · Lekce 30 · Pokročilá · Verze: 5

Zdroje