LibreOffice: osl/conditn.h File Reference

LibreOffice LibreOffice 26.2 SDK C/C++ API Reference

Loading...
Searching...
No Matches
conditn.h File Reference
`#include "sal/config.h"`
`#include "osl/time.h"`
`#include "sal/saldllapi.h"`

Go to the source code of this file.

## Typedefs
typedef void * | oslCondition

## Enumerations
enum | oslConditionResult { osl_cond_result_ok , osl_cond_result_error , osl_cond_result_timeout , osl_cond_result_FORCE_EQUAL_SIZE = SAL_MAX_ENUM }

## Functions
SAL_DLLPUBLIC oslCondition | osl_createCondition (void)
| Creates a condition.
SAL_DLLPUBLIC void | osl_destroyCondition (oslCondition Condition)
| Free the memory used by the condition.
SAL_DLLPUBLIC sal_Bool | osl_setCondition (oslCondition Condition)
| Sets condition to True => wait() will not block, check() returns True.
SAL_DLLPUBLIC sal_Bool | osl_resetCondition (oslCondition Condition)
| Sets condition to False => wait() will block, check() returns False.
SAL_DLLPUBLIC oslConditionResult | osl_waitCondition (oslCondition Condition, const TimeValue *pTimeout)
| Blocks if condition is not set.
SAL_DLLPUBLIC sal_Bool | osl_checkCondition (oslCondition Condition)
| Queries the state of the condition without blocking.

## Typedef Documentation

## ◆ oslCondition

typedef void* oslCondition

## Enumeration Type Documentation

## ◆ oslConditionResult

enum oslConditionResult

Enumerator
osl_cond_result_ok |
osl_cond_result_error |
osl_cond_result_timeout |
osl_cond_result_FORCE_EQUAL_SIZE |

## Function Documentation

## ◆ osl_checkCondition()

SAL_DLLPUBLIC sal_Bool osl_checkCondition | ( | oslCondition | Condition | ) |

Queries the state of the condition without blocking.

Parameters

  Condition | handle to a created condition.

Return values

  True | condition is set
  False | condition is not set

## ◆ osl_createCondition()

SAL_DLLPUBLIC oslCondition osl_createCondition | ( | void |  | ) |

Creates a condition.

Deprecated
  use C++11's std::condition_variable instead for a more robust and helpful condition.

The condition is in the reset-state.

Return values

  osl_cond_result_error | Condition could not be created.

## ◆ osl_destroyCondition()

SAL_DLLPUBLIC void osl_destroyCondition | ( | oslCondition | Condition | ) |

Free the memory used by the condition.

Parameters

  Condition | the condition handle.

## ◆ osl_resetCondition()

SAL_DLLPUBLIC sal_Bool osl_resetCondition | ( | oslCondition | Condition | ) |

Sets condition to False => wait() will block, check() returns False.

Parameters

  Condition | handle to a created condition.

Return values

  False | if system-call failed.

## ◆ osl_setCondition()

SAL_DLLPUBLIC sal_Bool osl_setCondition | ( | oslCondition | Condition | ) |

Sets condition to True => wait() will not block, check() returns True.

Attention
  all threads waiting on this condition are unblocked!

Parameters

  Condition | handle to a created condition.

Return values

  False | if system-call failed.

## ◆ osl_waitCondition()

SAL_DLLPUBLIC oslConditionResult osl_waitCondition | ( | oslCondition | Condition,
|  | const TimeValue * | pTimeout )

Blocks if condition is not set.

Parameters

  Condition | handle to a created condition.
  pTimeout | Timeout value or NULL for infinite waiting

Return values

  False | Condition has been destroyed prematurely or system call has failed.