Semaphore
Счётчик разрешений для пробуждения workers.
Новый Semaphore имеет ноль разрешений. Post(n) добавляет n; Wait() и успешный TryWait() расходуют одно. Поэтому TryWait() — не пассивная проверка готовности.
Данные очереди храните отдельно. Перед Dispose согласованно завершите workers: stop-флаг, Post для выхода из ожидания, затем join. Ожидание на главном потоке может остановить игру. Потокобезопасные API. Проверены подсчёт, оба Post и пробуждение на Windows; FIFO, стресс и builds без потоков не подтверждены.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
SemaphoreКонструктор
public Semaphore();Создаёт счётчик с нулём разрешений. Wait блокируется без разрешения; Post добавляет, а Wait/TryWait расходуют по одному. Это не очередь данных и не рекурсивный mutex с владельцем. Храните данные отдельно под согласованной защитой; завершите всех ожидающих workers до Dispose.
Методы4
Post2 перегрузки
public void Post();Добавляет положительное число разрешений; без аргумента — одно. Если никто не ждёт, разрешения сохраняются для будущего Wait/TryWait. Не гарантирует FIFO или немедленное выполнение конкретного потока. count<=0 даёт native-диагностику; метод не возвращает Error. Для остановки worker после изменения stop-флага разбудите его, затем join; один Post не завершает произвольную работу.
public void Post(int count = 1);Добавляет положительное число разрешений; без аргумента — одно. Если никто не ждёт, разрешения сохраняются для будущего Wait/TryWait. Не гарантирует FIFO или немедленное выполнение конкретного потока. count<=0 даёт native-диагностику; метод не возвращает Error. Для остановки worker после изменения stop-флага разбудите его, затем join; один Post не завершает произвольную работу.
| Имя | Тип | По умолчанию |
|---|---|---|
count | int | 1 |
countПоложительное число добавляемых разрешений, по умолчанию 1; не ID worker.
TryWaitbool
public bool TryWait();Неблокирующе расходует одно разрешение, если оно есть. True означает, что счётчик уменьшился; False — сейчас разрешений нет. Это не просто чтение готовности без побочного эффекта. Успешный TryWait не требует второго Wait или возврата разрешения, если ваш протокол этого не предусматривает.
boolTrue с расходованием одного разрешения либо false без изменения.
Waitvoid
public void Wait();Блокирует вызывающий поток до доступного разрешения и расходует одно. Может ждать бесконечно: нет timeout/отмены в этом API. Не используйте на главном потоке без гарантированного источника Post; исключите зависимости от уже заблокированного потока. Перед освобождением Semaphore разбудите и завершите всех workers.