WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

asyncio.shield

Schirmt den Task gegen über die Hülle weitergegebenen Abbruch ab.

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

Syntax

await asyncio.shield(aw)

Schirmt den Task gegen über die Hülle weitergegebenen Abbruch ab.

Der Aufrufer erhält dennoch CancelledError und der ursprüngliche Task läuft weiter. Direkter Abbruch des Tasks erreicht auch die Hülle. Eine starke Taskreferenz behalten.

Im Beispiel wird outer abgebrochen, doch die Freigabe liefert True ohne Abbruch von task.

import asyncio
async def main():
    e = asyncio.Event()
    t = asyncio.create_task(e.wait())
    s = asyncio.shield(t)
    s.cancel()
    try:
        await s
    except asyncio.CancelledError:
        assert not t.cancelled()
    e.set()
    assert await t is True
asyncio.run(main())

Beispiele

import asyncio

async def main():
    gate = asyncio.Event()
    task = asyncio.create_task(gate.wait())
    outer = asyncio.shield(task)
    outer.cancel()
    gate.set()
    print(outer.cancelled(), await task, task.cancelled())

asyncio.run(main())

Ergebnis

True True False

Im Beispiel wird outer abgebrochen, doch die Freigabe liefert True ohne Abbruch von task.

Quellen