Files
yabridge/src/common/bitsery/ext/message-reference.h
T
Robbert van der Helm 0b9a16cf40 Change the naming scheme for class field members
I'm not a fan of Hungarian notation, but C++ kind of needs it with its
implicit `this`. And of all the common options for this, I find
suffixing members with an underscore the least offensive one.
2022-01-01 21:07:17 +01:00

95 lines
3.1 KiB
C++

// yabridge: a Wine VST bridge
// Copyright (C) 2020-2022 Robbert van der Helm
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
#pragma once
#include <optional>
#include <bitsery/details/serialization_common.h>
#include <bitsery/traits/core/traits.h>
#include "../../serialization/common.h"
namespace bitsery {
namespace ext {
/**
* An adapter for serializing zero-copy references to objects using
* `MessageHandler<T>`. The idea is that when serializing, we just read data
* from the object pointed at by the reference. Then when deserializing, we'll
* write the data to some backing `std::option<T>` (so we don't have to
* initialize an unused object on the serializing side), and we'll then change
* our reference to point to the value contained within that option.
*
* This lets us serialize 'references' to objects that can be backed by actual
* persistent objects. That way we can avoid allocations during the processing
* loop.
*/
template <typename T>
class MessageReference {
public:
/**
* @param backing_object The object we'll deserialize into, so we can point
* the `MessageReference<T>` to this object. On the serializing side this
* won't be touched.
*/
MessageReference(std::optional<T>& backing_object)
: backing_object_(backing_object){};
template <typename Ser, typename Fnc>
void serialize(Ser& ser,
const ::MessageReference<T>& object_ref,
Fnc&&) const {
ser.object(object_ref.get());
}
template <typename Des, typename Fnc>
void deserialize(Des& des, ::MessageReference<T>& object_ref, Fnc&&) const {
if (!backing_object_) {
backing_object_.emplace();
}
// Since we cannot directly deserialize into a reference, we'll
// deserialize into this (persistent) backing object and then point the
// reference to this object.
des.object(*backing_object_);
object_ref = *backing_object_;
}
private:
/**
* This contains the actual `T` we'll deserialize into so we can point the
* reference to that object after deserializing.
*/
std::optional<T>& backing_object_;
};
} // namespace ext
namespace traits {
template <typename T>
struct ExtensionTraits<ext::MessageReference<T>, ::MessageReference<T>> {
using TValue = void;
static constexpr bool SupportValueOverload = false;
static constexpr bool SupportObjectOverload = true;
static constexpr bool SupportLambdaOverload = false;
};
} // namespace traits
} // namespace bitsery