PSUBSCRIBE
Syntax
PSUBSCRIBE pattern [pattern ...]
- Available since:
- 2.0.0
- Time complexity:
- O(N) where N is the number of patterns to subscribe to.
- ACL categories:
-
@pubsub
,@slow
,
Subscribes the client to the given patterns.
Supported glob-style patterns:
h?llo
subscribes tohello
,hallo
andhxllo
h*llo
subscribes tohllo
andheeeello
h[ae]llo
subscribes tohello
andhallo,
but nothillo
Use \
to escape special characters if you want to match them verbatim.
Once the client enters the subscribed state it is not supposed to issue any other commands, except for additional SUBSCRIBE
, SSUBSCRIBE
, PSUBSCRIBE
, UNSUBSCRIBE
, SUNSUBSCRIBE
, PUNSUBSCRIBE
, PING
, RESET
and QUIT
commands.
However, if RESP3 is used (see HELLO
) it is possible for a client to issue any commands while in subscribed state.
For more information, see Pub/sub.
Behavior change history
>= 6.2.0
:RESET
can be called to exit subscribed state.
RESP2/RESP3 Reply
When successful, this command doesn't return anything. Instead, for each pattern, one message with the first element being the stringpsubscribe
is pushed as a confirmation that the command succeeded.