| Home | Libraries | People | FAQ | More

## Class interprocess_semaphore

boost::interprocess::interprocess_semaphore

## Synopsis

    // In header: <boost/interprocess/sync/interprocess_semaphore.hpp>

    class interprocess_semaphore {
    public:
      // construct/copy/destruct
      interprocess_semaphore(unsigned int);
      ~interprocess_semaphore();

      // public member functions
      void post();
      void wait();
      bool try_wait();
      bool timed_wait(const boost::posix_time::ptime &);
    };

## Description

Wraps a interprocess_semaphore that can be placed in shared memory and can be shared between processes. Allows timed lock tries

### `interprocess_semaphore` public construct/copy/destruct

1.     interprocess_semaphore(unsigned int initialCount);

   Creates a `interprocess_semaphore` with the given initial count. `interprocess_exception` if there is an error.

2.     ~interprocess_semaphore();

   Destroys the `interprocess_semaphore`. Does not throw

### `interprocess_semaphore` public member functions

1.     void post();

   Increments the `interprocess_semaphore` count. If there are processes/threads blocked waiting for the `interprocess_semaphore`, then one of these processes will return successfully from its wait function. If there is an error an `interprocess_exception` exception is thrown.

2.     void wait();

   Decrements the `interprocess_semaphore`. If the `interprocess_semaphore` value is not greater than zero, then the calling process/thread blocks until it can decrement the counter. If there is an error an `interprocess_exception` exception is thrown.

3.     bool try_wait();

   Decrements the `interprocess_semaphore` if the `interprocess_semaphore`'s value is greater than zero and returns true. If the value is not greater than zero returns false. If there is an error an `interprocess_exception` exception is thrown.

4.     bool timed_wait(const boost::posix_time::ptime & abs_time);

   Decrements the `interprocess_semaphore` if the `interprocess_semaphore`'s value is greater than zero and returns true. Otherwise, waits for the `interprocess_semaphore` to the posted or the timeout expires. If the timeout expires, the function returns false. If the `interprocess_semaphore` is posted the function returns true. If there is an error throws sem_exception