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
|
// Copyright 2012 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef DBUS_OBJECT_PATH_H_
#define DBUS_OBJECT_PATH_H_
#include <iosfwd>
#include <string>
#include <string_view>
#include "dbus/dbus_export.h"
namespace dbus {
// ObjectPath is a type used to distinguish D-Bus object paths from simple
// strings, especially since normal practice is that these should be only
// initialized from static constants or obtained from remote objects and no
// assumptions about their value made.
class CHROME_DBUS_EXPORT ObjectPath {
public:
// Permit initialization without a value for passing to
// dbus::MessageReader::PopObjectPath to fill in and from std::string
// objects.
//
// The compiler synthesised copy constructor and assignment operator are
// sufficient for our needs, as is implicit initialization of a
// std::string_view from a string constant.
ObjectPath() = default;
explicit ObjectPath(std::string_view value) : value_(value) {}
// Retrieves value as a std::string.
const std::string& value() const { return value_; }
// Returns true if the value is a valid object path.
bool IsValid() const;
// Permit sufficient comparison to allow an ObjectPath to be used as a
// key in a std::map.
bool operator<(const ObjectPath&) const;
// Permit testing for equality, required for mocks to work and useful for
// observers.
bool operator==(const ObjectPath&) const;
bool operator!=(const ObjectPath&) const;
private:
std::string value_;
};
// This is required by gtest to print a readable output on test failures.
CHROME_DBUS_EXPORT void PrintTo(const ObjectPath& path, std::ostream* out);
} // namespace dbus
#endif // DBUS_OBJECT_PATH_H_
|
