База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

asyncio.shield

Предпазва задачата от отмяна, предадена чрез обвивката.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

await asyncio.shield(aw)

Предпазва задачата от отмяна, предадена чрез обвивката.

Извикващият все пак получава CancelledError, а първоначалната задача продължава. Пряката отмяна на задачата засяга и обвивката. Запазете силна препратка към задачата.

В примера outer е отменен, но сигналът дава True без отмяна на 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())

Примери

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

Резултат

True True False

В примера outer е отменен, но сигналът дава True без отмяна на task.

Източници