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
|
// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef BASE_APPLE_DISPATCH_SOURCE_H_
#define BASE_APPLE_DISPATCH_SOURCE_H_
#include <dispatch/dispatch.h>
#include <memory>
#include "base/base_export.h"
namespace base::apple {
// This class encapsulates a dispatch source of type dispatch_source_type_t.
// When this object is destroyed, the source will be cancelled and it will wait
// for the source to stop executing work. The source can run on either a
// user-supplied queue, or it can create its own for the source.
class BASE_EXPORT DispatchSource {
public:
// Creates a new dispatch source for the |port| and schedules it on a new
// queue that will be created with |name|. When a Mach message is received,
// the |event_handler| will be called.
DispatchSource(const char* name, mach_port_t port, void (^event_handler)());
// Creates a new dispatch source with the same semantics as above, but rather
// than creating a new queue, it schedules the source on |queue|.
DispatchSource(dispatch_queue_t queue,
mach_port_t port,
void (^event_handler)());
// Create a dispatch source for a file descriptor.
// `type` should either be DISPATCH_SOURCE_TYPE_READ or
// DISPATCH_SOURCE_TYPE_WRITE.
DispatchSource(dispatch_queue_t queue,
int fd,
dispatch_source_type_t type,
void (^event_handler)());
DispatchSource(const DispatchSource&) = delete;
DispatchSource& operator=(const DispatchSource&) = delete;
// Cancels the source and waits for it to become fully cancelled before
// releasing the source.
~DispatchSource();
// Resumes the source. This must be called before any Mach messages will
// be received.
void Resume();
void Suspend();
dispatch_queue_t Queue() const;
private:
bool suspended_ = true;
struct Storage;
std::unique_ptr<Storage> storage_;
};
} // namespace base::apple
#endif // BASE_APPLE_DISPATCH_SOURCE_H_
|
