/usr/include/caf/attachable.hpp is in libcaf-dev 0.13.2-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /******************************************************************************
* ____ _ _____ *
* / ___| / \ | ___| C++ *
* | | / _ \ | |_ Actor *
* | |___ / ___ \| _| Framework *
* \____/_/ \_|_| *
* *
* Copyright (C) 2011 - 2015 *
* Dominik Charousset <dominik.charousset (at) haw-hamburg.de> *
* *
* Distributed under the terms and conditions of the BSD 3-Clause License or *
* (at your option) under the terms and conditions of the Boost Software *
* License 1.0. See accompanying files LICENSE and LICENSE_ALTERNATIVE. *
* *
* If you did not receive a copy of the license files, see *
* http://opensource.org/licenses/BSD-3-Clause and *
* http://www.boost.org/LICENSE_1_0.txt. *
******************************************************************************/
#ifndef CAF_ATTACHABLE_HPP
#define CAF_ATTACHABLE_HPP
#include <memory>
#include <cstdint>
#include <typeinfo>
#include <exception>
#include "caf/optional.hpp"
namespace caf {
class abstract_actor;
/**
* Callback utility class.
*/
class attachable {
public:
attachable() = default;
attachable(const attachable&) = delete;
attachable& operator=(const attachable&) = delete;
/**
* Represents a pointer to a value with its subtype as type ID number.
*/
struct token {
/**
* Identifies a non-matchable subtype.
*/
static constexpr size_t anonymous = 0;
/**
* Identifies `abstract_group::subscription`.
*/
static constexpr size_t subscription = 1;
/**
* Identifies `default_attachable::observe_token`.
*/
static constexpr size_t observer = 2;
template <class T>
token(const T& tk) : subtype(T::token_type), ptr(&tk) {
// nop
}
/**
* Denotes the type of ptr.
*/
size_t subtype;
/**
* Any value, used to identify attachable instances.
*/
const void* ptr;
token(size_t subtype, const void* ptr);
};
virtual ~attachable();
/**
* Executed if the actor did not handle an exception and must
* not return `none` if this attachable did handle `eptr`.
* Note that the first handler to handle `eptr` "wins" and no other
* handler will be invoked.
* @returns The exit reason the actor should use.
*/
virtual optional<uint32_t> handle_exception(const std::exception_ptr& eptr);
/**
* Executed if the actor finished execution with given `reason`.
* The default implementation does nothing.
*/
virtual void actor_exited(abstract_actor* self, uint32_t reason);
/**
* Returns `true` if `what` selects this instance, otherwise `false`.
*/
virtual bool matches(const token& what);
/**
* Returns `true` if `what` selects this instance, otherwise `false`.
*/
template <class T>
bool matches(const T& what) {
return matches(token{T::token_type, &what});
}
std::unique_ptr<attachable> next;
};
/**
* @relates attachable
*/
using attachable_ptr = std::unique_ptr<attachable>;
} // namespace caf
#endif // CAF_ATTACHABLE_HPP
|