boost::redis::request::subscribe :: Boost.Redis

# boost::redis::request::subscribe

Appends a SUBSCRIBE command to the end of the request.

## Synopsis

Declared in `<boost/redis/request.hpp>`

    void
    subscribe(std::initializer_list<std::string_view> channels);

## Description

If `channels` contains `{"ch1", "ch2"}`, the resulting command is `SUBSCRIBE ch1 ch2`.

Subscriptions created 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