Language

The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.15

API

SDK

Tips ‘n’ Tricks

Miscellaneous


Methods of Class Semaphore


Semaphore
Semaphore(
sal_uInt32 initialCount );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO YES NO

Summary
Creates a semaphore.
Parameters
InitialCount
denotes the starting value the semaphore. If you set it to
zero, the first acquire() blocks. Otherwise InitialCount acquire()s  are
immedeatly  successfull.
Return
0 if the semaphore could not be created, otherwise a handle to the sem.

~Semaphore
~Semaphore();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO YES NO

Summary
Release the OS-structures and free semaphore data-structure
Return
fbbb

acquire
sal_Bool acquire();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO YES NO

Summary
acquire()decreases the count. It will block if it tries to decrease below zero.
Return
False if the system-call failed.

tryToAcquire
sal_Bool tryToAcquire();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO YES NO

Description
tryToAcquire()tries to decreases the count. It will return with False if it would decrease the count below zero. (When acquire() would block.) If it could successfully decrease the count, it will return True.

release
sal_Bool release();

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO YES NO

Summary
release()increases the count.
Return
False if the system-call failed.

Semaphore
Semaphore(
const Semaphore & );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
The underlying oslSemaphore has no reference count.
Description
Since the underlying oslSemaphore is not a reference counted object, copy constructed Semaphore may work on an already destructed oslSemaphore object.

Semaphore
Semaphore(
oslSemaphore Semaphore );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
The underlying oslSemaphore has no reference count.
Description
When destructed, the Semaphore object destroys the undelying oslSemaphore, which might cause severe problems in case it's a temporary object.

operator=
Semaphore & operator=(
const Semaphore & );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
This assignment operator is private for the same reason as the copy constructor.

operator=
Semaphore & operator=(
oslSemaphore );

virtual abstract const volatile template static inline C-linkage
NO NO NO NO NO NO NO NO

Summary
This assignment operator is private for the same reason as the constructor taking a oslSemaphore argument.

Top of Page

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, OpenOffice.org and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.