summaryrefslogtreecommitdiff
path: root/include/osl/conditn.hxx
blob: 5eb9ba431da7c7efb305b9b7b7d1c78ff4fc3361 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
 * This file is part of the LibreOffice project.
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * This file incorporates work covered by the following license notice:
 *
 *   Licensed to the Apache Software Foundation (ASF) under one or more
 *   contributor license agreements. See the NOTICE file distributed
 *   with this work for additional information regarding copyright
 *   ownership. The ASF licenses this file to you under the Apache
 *   License, Version 2.0 (the "License"); you may not use this file
 *   except in compliance with the License. You may obtain a copy of
 *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
 */

/*
 * This file is part of LibreOffice published API.
 */

#ifndef INCLUDED_OSL_CONDITN_HXX
#define INCLUDED_OSL_CONDITN_HXX

#include "sal/config.h"

#include <cstddef>

#include "osl/time.h"
#include "osl/conditn.h"

#if defined(MACOSX) && defined(__ASSERT_MACROS_DEFINE_VERSIONS_WITHOUT_UNDERSCORES)
#   if __ASSERT_MACROS_DEFINE_VERSIONS_WITHOUT_UNDERSCORES == 1
#       undef check
#   endif
#endif

namespace osl
{
    /** Condition variable

       A condition variable is essentially an object that is initially
       cleared which a thread waits on until it is "set". It allows a
       thread to synchronize execution by allowing other threads to wait
       for the condition to change before that thread then continues
       execution.

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

       @attention Warning: the Condition abstraction is inadequate for
            any situation where there may be multiple threads setting,
            waiting, and resetting the same condition. It can only be
            used to synchronise interactions between two threads
            cf. lost wakeups in http://www.cs.wustl.edu/~schmidt/win32-cv-1.html
    */
    class Condition
    {
    public:
        enum Result
        {
            result_ok      = osl_cond_result_ok,        /*!< Successful completion.                         */
            result_error   = osl_cond_result_error,     /*!< Error occurred. @see osl_getLastSocketError() */
            result_timeout = osl_cond_result_timeout    /*!< Blocking operation timed out.                 */
        };

        /** Create a condition.

            @deprecated use C++11's std::condition_variable instead
                for a more robust and helpful condition.
        */
        Condition()
        {
            condition = osl_createCondition();
        }

        /** Release the OS-structures and free condition data-structure.

            @deprecated use C++11's std::condition_variable instead
                for a more robust and helpful condition.
        */
        ~Condition()
        {
            osl_destroyCondition(condition);
        }

        /** Release all waiting threads, check returns true.

            @deprecated use C++11's std::condition_variable instead
                for a more robust and helpful condition.
        */
        void set()
        {
            osl_setCondition(condition);
        }

        /** Reset condition to false: wait() will block, check() returns
            false.

            @deprecated use C++11's std::condition_variable instead
                        for a more robust and helpful condition.
        */
        void reset() {
            osl_resetCondition(condition);
        }

        /** Blocks the calling thread until condition is set.

            @param [in] pTimeout Timeout to wait before ending the condition.
                Defaults to NULL

            @retval result_ok       finished successfully
            @retval result_error    error occurred
            @retval result_timeout  timed out

            @deprecated use C++11's std::condition_variable instead
                for a more robust and helpful condition.
        */
        Result wait(const TimeValue *pTimeout = NULL)
        {
            return static_cast<Result>(osl_waitCondition(condition, pTimeout));
        }

#if defined LIBO_INTERNAL_ONLY
        Result wait(TimeValue const & timeout) { return wait(&timeout); }
#endif

        /** Checks if the condition is set without blocking.

            @retval true   condition is set
            @retval false  condition is not set

            @deprecated use C++11's std::condition_variable instead
                for a more robust and helpful condition.
        */
        bool check()
        {
            return osl_checkCondition(condition);
        }


    private:
        oslCondition condition;     /*< condition variable */

        /** Copy constructor

            The underlying oslCondition has no reference count.

            Since the underlying oslCondition is not a reference counted
            object, copy constructed Condition may work on an already
            destructed oslCondition object.

            @deprecated use C++11's std::condition_variable instead
                for a more robust and helpful condition.
        */
        Condition(const Condition& condition) SAL_DELETED_FUNCTION;

        /** This assignment operator is deleted for the same reason as
            the copy constructor.

            @deprecated use C++11's std::condition_variable instead
                for a more robust and helpful condition.
        */
        Condition& operator= (const Condition&) SAL_DELETED_FUNCTION;
    };
}

#endif // INCLUDED_OSL_CONDITN_HXX

/* vim:set shiftwidth=4 softtabstop=4 expandtab: */