WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

asyncio.create_task

Plant eine Koroutine in der laufenden Schleife und liefert einen Task.

Version: Python 3.14; repository image, production runtime not attested

Syntax

asyncio.create_task(coro, *, name=None, context=None, eager_start=None, **kwargs)

Plant eine Koroutine in der laufenden Schleife und liefert einen Task.

In 3.14 gehen zusätzliche **kwargs an loop.create_task. Ohne eager_start legt die Taskfabrik der Schleife den Startmodus fest. Standardmäßig wird der Aufruferkontext kopiert. Eine starke Referenz behalten und mit await Ergebnis oder Ausnahme abholen. In 3.14 erlaubt eager_start=True die sofortige Ausführung bis zur ersten Unterbrechung. Ohne laufende Schleife entsteht RuntimeError.

Das Beispiel liefert 8 und done() ist True.

import asyncio
async def main():
    steps = []
    async def tick():
        steps.append("start")
        await asyncio.sleep(0)
        return 8
    t = asyncio.create_task(tick(), name="tick", eager_start=True)
    assert steps == ["start"] and t.get_name() == "tick"
    assert await t == 8 and t.done()
asyncio.run(main())
import asyncio
async def main():
    loop = asyncio.get_running_loop()
    received = []
    def factory(loop, coro, **opts):
        received.append(opts.pop("marker", None))
        return asyncio.Task(coro, loop=loop, **opts)
    loop.set_task_factory(factory)
    try:
        assert await asyncio.create_task(asyncio.sleep(0, result=3), marker=7) == 3
    finally:
        loop.set_task_factory(None)
    assert received == [7]
asyncio.run(main())

Beispiele

import asyncio

async def main():
    task = asyncio.create_task(asyncio.sleep(0, result=8))
    print(await task)
    print(task.done())

asyncio.run(main())

Ergebnis

8
True

Das Beispiel liefert 8 und done() ist True.

Quellen