blob: 52ca592f25c35e524ae5715dc33f75f360d60aba (
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
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef BASE_TEST_TEST_PENDING_TASK_H_
#define BASE_TEST_TEST_PENDING_TASK_H_
#include <string>
#include "base/callback.h"
#include "base/location.h"
#include "base/time/time.h"
#include "base/trace_event/trace_event_argument.h"
namespace base {
// TestPendingTask is a helper class for test TaskRunner
// implementations. See test_simple_task_runner.h for example usage.
struct TestPendingTask {
enum TestNestability { NESTABLE, NON_NESTABLE };
TestPendingTask();
TestPendingTask(TestPendingTask&& other);
TestPendingTask(const tracked_objects::Location& location,
OnceClosure task,
TimeTicks post_time,
TimeDelta delay,
TestNestability nestability);
~TestPendingTask();
TestPendingTask& operator=(TestPendingTask&& other);
// Returns post_time + delay.
TimeTicks GetTimeToRun() const;
// Returns true if this task is nestable and |other| isn't, or if
// this task's time to run is strictly earlier than |other|'s time
// to run.
//
// Note that two tasks may both have the same nestability and delay.
// In that case, the caller must use some other criterion (probably
// the position in some queue) to break the tie. Conveniently, the
// following STL functions already do so:
//
// - std::min_element
// - std::stable_sort
//
// but the following STL functions don't:
//
// - std::max_element
// - std::sort.
bool ShouldRunBefore(const TestPendingTask& other) const;
tracked_objects::Location location;
OnceClosure task;
TimeTicks post_time;
TimeDelta delay;
TestNestability nestability;
// Functions for using test pending task with tracing, useful in unit
// testing.
void AsValueInto(base::trace_event::TracedValue* state) const;
std::unique_ptr<base::trace_event::ConvertableToTraceFormat> AsValue() const;
std::string ToString() const;
private:
DISALLOW_COPY_AND_ASSIGN(TestPendingTask);
};
// gtest helpers which allow pretty printing of the tasks, very useful in unit
// testing.
std::ostream& operator<<(std::ostream& os, const TestPendingTask& task);
void PrintTo(const TestPendingTask& task, std::ostream* os);
} // namespace base
#endif // BASE_TEST_TEST_PENDING_TASK_H_
|
