Oolite 1.91.0.7644-241112-7f5034b
Loading...
Searching...
No Matches
OOAsyncQueue.h
Go to the documentation of this file.
1/*
2
3OOAsyncQueue.h
4By Jens Ayton
5
6OOAsyncQueue is used to pass messages (in the form of arbitrary objects)
7between threads. It is many-to-many capable, i.e. it is safe to send messages
8from any number of threads and to read messages from any number of threads.
9
10
11Copyright (C) 2007-2013 Jens Ayton
12
13Permission is hereby granted, free of charge, to any person obtaining a copy
14of this software and associated documentation files (the "Software"), to deal
15in the Software without restriction, including without limitation the rights
16to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
17copies of the Software, and to permit persons to whom the Software is
18furnished to do so, subject to the following conditions:
19
20The above copyright notice and this permission notice shall be included in all
21copies or substantial portions of the Software.
22
23THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
24IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
25FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
26AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
27LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
28OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
29SOFTWARE.
30
31*/
32
33#import <Foundation/Foundation.h>
34
35
36@interface OOAsyncQueue: NSObject
37{
38@private
39 NSConditionLock *_lock;
43 unsigned _elemCount,
45}
46
47- (BOOL)enqueue:(id)object; // Returns NO on failure, or if object is nil.
48
49- (id)dequeue; // Blocks until the queue is non-empty.
50- (id)tryDequeue; // Returns nil if empty.
51
52// Due to the asynchronous nature of the queue, these values are immediately out of date.
53- (BOOL)empty;
54- (unsigned)count;
55
56- (void)emptyQueue; // Releases all elements.
57
58@end
unsigned count
unsigned _poolCount
unsigned _elemCount
struct OOAsyncQueueElement * _pool
struct OOAsyncQueueElement * _head
struct OOAsyncQueueElement * _tail
NSConditionLock * _lock