WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

asyncio.Semaphore

Begrenzt gleichzeitige Nutzer einer Ressource durch einen Zähler für Berechtigungen.

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

Syntax

asyncio.Semaphore(value=1)

Begrenzt gleichzeitige Nutzer einer Ressource durch einen Zähler für Berechtigungen.

locked() zeigt, dass acquire nicht sofort gelingen kann. BoundedSemaphore löst bei release über die Anfangskapazität hinaus ValueError aus. acquire nimmt eine oder wartet bei null, release gibt eine zurück. Ein negativer Anfangswert löst ValueError aus. Beim normalen Semaphore kann ein überzähliges release die Anfangskapazität erhöhen.

Mit zwei Berechtigungen ergeben die verschachtelten Blöcke False, True, False.

import asyncio
async def main():
    s = asyncio.Semaphore(1)
    assert await s.acquire() and s.locked()
    s.release()
    s.release()
    assert await s.acquire() and not s.locked()
    assert await s.acquire() and s.locked()
    try:
        asyncio.Semaphore(-1)
    except ValueError:
        pass
    else:
        raise AssertionError
asyncio.run(main())
import asyncio
async def main():
    b = asyncio.BoundedSemaphore(1)
    assert not b.locked()
    await b.acquire()
    assert b.locked()
    b.release()
    try:
        b.release()
    except ValueError:
        pass
    else:
        raise AssertionError
asyncio.run(main())

Beispiele

import asyncio

async def main():
    sem = asyncio.Semaphore(2)
    async with sem:
        print(sem.locked())
        async with sem:
            print(sem.locked())
        print(sem.locked())

asyncio.run(main())

Ergebnis

False
True
False

Mit zwei Berechtigungen ergeben die verschachtelten Blöcke False, True, False.

Quellen