Component bslmt_semaphoreimpl_counted [Package bslmt]

Provide an implementation of bslmt::Semaphore with count. More...

Outline

• Purpose
• Classes
• Description
  • Usage

Purpose:

Provide an implementation of bslmt::Semaphore with count.

Classes:

bslmt::SemaphoreImpl<CountedSemaphore>

semaphore specialization with count

See also:

Component bslmt_semaphore

Description:

This component provides an implementation of bslmt::Semaphore, bslmt::SemaphoreImpl<CountedSemaphore>, via the template specialization:

  bslmt::SemaphoreImpl<Platform::CountedSemaphore>

This template class should not be used (directly) by client code. Clients should instead use bslmt::Semaphore.

This implementation of bslmt::Semaphore is intended for platforms where a separate count must be maintained. bslmt::Semaphore supports large values, but the native semaphores provided on some platforms are restricted to a relatively small range of values (e.g., [ 0 .. 32000 ] on AIX) and on some other platforms do not provide a count at all (Darwin). To support uniform usage across platforms, this component maintains the count of the semaphore in a separate atomic integer. post is only invoked on the underlying semaphore when it is known there are threads blocked on it.

Usage:

This component is an implementation detail of bslmt and is not intended for direct client use. It is subject to change without notice. As such, a usage example is not provided.