Skip to content

Mutex ​

Mutex<T> protege acesso exclusivo a um valor compartilhado entre tarefas geradas concorrentemente.

AssinaturaMutex<T>(value: T): Mutex<T>

mutex.lock(): Promise<MutexGuard<T>> aguarda a trava e resolve com um guard. mutex.tryLock(): MutexGuard<T>? nunca aguarda: resolve imediatamente com o guard adquirido, ou None se a trava estiver presa em outro lugar.

guard.value lê e escreve o valor protegido diretamente, no lugar, incluindo atribuição composta (guard.value += 1). A trava é liberada automaticamente quando o guard sai de escopo, então não existe uma chamada explícita de destravamento. Um MutexGuard<T> (ou MutexGuard<T>? de tryLock) não pode continuar vivo através de um await, já que segurar uma trava através de um ponto de suspensão é uma fonte comum de deadlock e starvation (E3034).

O payload de Mutex<T> é restrito ao mesmo subconjunto que channel<T> aceita: string, scalars Copy e arrays de elementos Copy (E3037 caso contrário).

tyrus
import { Mutex, spawn } from "tyrus:task";

async function main(): Promise<void> {
    const counter = Mutex<u32>(0);
    const handle = spawn(async (): Promise<void> => {
        // `guard.value` reads and writes the protected value in place; the
        // lock releases automatically once `guard` goes out of scope.
        const guard = await counter.lock();
        guard.value += 1;
    });
    await handle.join();
}