165 lines
6.2 KiB
C++
165 lines
6.2 KiB
C++
// Copyright (c) Microsoft Open Technologies, Inc. All rights reserved. See License.txt in the project root for license information.
|
|
|
|
#pragma once
|
|
|
|
/*! \file rx-publish.hpp
|
|
|
|
\brief Turn a cold observable hot and allow connections to the source to be independent of subscriptions.
|
|
Turn a cold observable hot, send the most recent value to any new subscriber, and allow connections to the source to be independent of subscriptions.
|
|
|
|
\tparam T the type of the emitted item (optional).
|
|
|
|
\param first an initial item to be emitted by the resulting observable at connection time before emitting the items from the source observable; not emitted to observers that subscribe after the time of connection (optional).
|
|
\param cs the subscription to control lifetime (optional).
|
|
|
|
\return rxcpp::connectable_observable that upon connection causes the source observable to emit items to its observers.
|
|
|
|
\sample
|
|
\snippet publish.cpp publish subject sample
|
|
\snippet output.txt publish subject sample
|
|
|
|
\sample
|
|
\snippet publish.cpp publish behavior sample
|
|
\snippet output.txt publish behavior sample
|
|
|
|
\sample
|
|
\snippet publish.cpp publish diamond samethread sample
|
|
\snippet output.txt publish diamond samethread sample
|
|
|
|
\sample
|
|
\snippet publish.cpp publish diamond bgthread sample
|
|
\snippet output.txt publish diamond bgthread sample
|
|
|
|
\sample
|
|
\snippet ref_count.cpp ref_count other diamond sample
|
|
\snippet output.txt ref_count other diamond sample
|
|
*/
|
|
|
|
#if !defined(RXCPP_OPERATORS_RX_PUBLISH_HPP)
|
|
#define RXCPP_OPERATORS_RX_PUBLISH_HPP
|
|
|
|
#include "../rx-includes.hpp"
|
|
#include "./rx-multicast.hpp"
|
|
|
|
namespace rxcpp {
|
|
|
|
namespace operators {
|
|
|
|
namespace detail {
|
|
|
|
template<class... AN>
|
|
struct publish_invalid_arguments {};
|
|
|
|
template<class... AN>
|
|
struct publish_invalid : public rxo::operator_base<publish_invalid_arguments<AN...>> {
|
|
using type = observable<publish_invalid_arguments<AN...>, publish_invalid<AN...>>;
|
|
};
|
|
template<class... AN>
|
|
using publish_invalid_t = typename publish_invalid<AN...>::type;
|
|
|
|
}
|
|
|
|
/*! @copydoc rx-publish.hpp
|
|
*/
|
|
template<class... AN>
|
|
auto publish(AN&&... an)
|
|
-> operator_factory<publish_tag, AN...> {
|
|
return operator_factory<publish_tag, AN...>(std::make_tuple(std::forward<AN>(an)...));
|
|
}
|
|
|
|
/*! \brief Turn a cold observable hot and allow connections to the source to be independent of subscriptions.
|
|
|
|
\tparam Coordination the type of the scheduler.
|
|
|
|
\param cn a scheduler all values are queued and delivered on.
|
|
\param cs the subscription to control lifetime (optional).
|
|
|
|
\return rxcpp::connectable_observable that upon connection causes the source observable to emit items to its observers, on the specified scheduler.
|
|
|
|
\sample
|
|
\snippet publish.cpp publish_synchronized sample
|
|
\snippet output.txt publish_synchronized sample
|
|
*/
|
|
template<class... AN>
|
|
auto publish_synchronized(AN&&... an)
|
|
-> operator_factory<publish_synchronized_tag, AN...> {
|
|
return operator_factory<publish_synchronized_tag, AN...>(std::make_tuple(std::forward<AN>(an)...));
|
|
}
|
|
|
|
}
|
|
|
|
template<>
|
|
struct member_overload<publish_tag>
|
|
{
|
|
template<class Observable,
|
|
class Enabled = rxu::enable_if_all_true_type_t<
|
|
is_observable<Observable>>,
|
|
class SourceValue = rxu::value_type_t<Observable>,
|
|
class Subject = rxsub::subject<SourceValue>,
|
|
class Multicast = rxo::detail::multicast<SourceValue, rxu::decay_t<Observable>, Subject>,
|
|
class Result = connectable_observable<SourceValue, Multicast>
|
|
>
|
|
static Result member(Observable&& o) {
|
|
return Result(Multicast(std::forward<Observable>(o), Subject(composite_subscription())));
|
|
}
|
|
|
|
template<class Observable,
|
|
class Enabled = rxu::enable_if_all_true_type_t<
|
|
is_observable<Observable>>,
|
|
class SourceValue = rxu::value_type_t<Observable>,
|
|
class Subject = rxsub::subject<SourceValue>,
|
|
class Multicast = rxo::detail::multicast<SourceValue, rxu::decay_t<Observable>, Subject>,
|
|
class Result = connectable_observable<SourceValue, Multicast>
|
|
>
|
|
static Result member(Observable&& o, composite_subscription cs) {
|
|
return Result(Multicast(std::forward<Observable>(o), Subject(cs)));
|
|
}
|
|
|
|
template<class Observable, class T,
|
|
class Enabled = rxu::enable_if_all_true_type_t<
|
|
is_observable<Observable>>,
|
|
class SourceValue = rxu::value_type_t<Observable>,
|
|
class Subject = rxsub::behavior<SourceValue>,
|
|
class Multicast = rxo::detail::multicast<SourceValue, rxu::decay_t<Observable>, Subject>,
|
|
class Result = connectable_observable<SourceValue, Multicast>
|
|
>
|
|
static Result member(Observable&& o, T first, composite_subscription cs = composite_subscription()) {
|
|
return Result(Multicast(std::forward<Observable>(o), Subject(first, cs)));
|
|
}
|
|
|
|
template<class... AN>
|
|
static operators::detail::publish_invalid_t<AN...> member(AN...) {
|
|
std::terminate();
|
|
return {};
|
|
static_assert(sizeof...(AN) == 10000, "publish takes (optional CompositeSubscription) or (T, optional CompositeSubscription)");
|
|
}
|
|
};
|
|
|
|
template<>
|
|
struct member_overload<publish_synchronized_tag>
|
|
{
|
|
template<class Observable, class Coordination,
|
|
class Enabled = rxu::enable_if_all_true_type_t<
|
|
is_observable<Observable>,
|
|
is_coordination<Coordination>>,
|
|
class SourceValue = rxu::value_type_t<Observable>,
|
|
class Subject = rxsub::synchronize<SourceValue, rxu::decay_t<Coordination>>,
|
|
class Multicast = rxo::detail::multicast<SourceValue, rxu::decay_t<Observable>, Subject>,
|
|
class Result = connectable_observable<SourceValue, Multicast>
|
|
>
|
|
static Result member(Observable&& o, Coordination&& cn, composite_subscription cs = composite_subscription()) {
|
|
return Result(Multicast(std::forward<Observable>(o), Subject(std::forward<Coordination>(cn), cs)));
|
|
}
|
|
|
|
template<class... AN>
|
|
static operators::detail::publish_invalid_t<AN...> member(AN...) {
|
|
std::terminate();
|
|
return {};
|
|
static_assert(sizeof...(AN) == 10000, "publish_synchronized takes (Coordination, optional CompositeSubscription)");
|
|
}
|
|
};
|
|
|
|
}
|
|
|
|
#endif
|