KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

asyncio.shield

Beschermt de taak tegen annulering via de omhulling.

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

Syntax

await asyncio.shield(aw)

Beschermt de taak tegen annulering via de omhulling.

De aanroeper krijgt nog steeds CancelledError en de oorspronkelijke taak gaat door. Direct annuleren van de taak bereikt ook de omhulling. Bewaar een sterke taakverwijzing.

In het voorbeeld wordt outer geannuleerd maar levert het signaal True op zonder task te annuleren.

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())

Voorbeelden

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())

Resultaat

True True False

In het voorbeeld wordt outer geannuleerd maar levert het signaal True op zonder task te annuleren.

Bronnen