boost::redis::request::unsubscribe

Appends an UNSUBSCRIBE command to the end of the request.

Synopsis

Declared in <boost/redis/request.hpp>

template<class Range>
void
unsubscribe(
    Range&& channels,
    decltype(std::cbegin(channels))* = nullptr);

Description

If channels contains ["ch1", "ch2"], the resulting command is UNSUBSCRIBE ch1 ch2.

Subscriptions removed using this function are tracked to enable PubSub state restoration. After successfully executing the request, the connection will store any newly subscribed channels and patterns. Every time a reconnection happens, a suitable SUBSCRIBE/`PSUBSCRIBE` command is issued automatically, to restore the subscriptions that were active before the reconnection.

PubSub store restoration only happens when using subscribe, unsubscribe, psubscribe or punsubscribe. Subscription commands added by push or push_range are not tracked.

Created with MrDocs