class_docstr: The ZMQ socket object
  
  To create a Socket, first create a Context::
  
      ctx = zmq.Context.instance()
  
  then call ``ctx.socket(socket_type)``::
  
      s = ctx.socket(zmq.ROUTER)
class_docstr_tok: ["The","ZMQ","socket","object","To","create","a","Socket",",","first","create","a","Context",":",":","ctx","=","zmq.Context.instance","(",")","then","call","``","ctx.socket","(","socket_type",")","``",":",":","s","=","ctx.socket","(","zmq.ROUTER",")"]
docstr: Receive a unicode string, as sent by send_string.
  
  Parameters
  ----------
  flags : int
      Any valid flags for :func:`Socket.recv`.
  encoding : str [default: 'utf-8']
      The encoding to be used
  
  Returns
  -------
  s : unicode string (unicode on py2, str on py3)
      The Python unicode string that arrives as encoded bytes.
  
  Raises
  ------
  ZMQError
      for any of the reasons :func:`~Socket.recv` might fail
docstr_tok: ["Receive","a","unicode","string",",","as","sent","by","send_string",".","Parameters","--","--","--","--","--","flags",":","int","Any","valid","flags","for",":","func",":","`","Socket.recv","`",".","encoding",":","str","[","default",":","'utf-8","'","]","The","encoding","to","be","used","Returns","--","--","--","-","s",":","unicode","string","(","unicode","on","py2",",","str","on","py3",")","The","Python","unicode","string","that","arrives","as","encoded","bytes",".","Raises","--","--","--","ZMQError","for","any","of","the","reasons",":","func",":","`","~Socket.recv","`","might","fail"]
code: def recv_string(self, flags=0, encoding="utf-8"):
      """Receive a unicode string, as sent by send_string.
  
      Parameters
      ----------
      flags : int
          Any valid flags for :func:`Socket.recv`.
      encoding : str [default: 'utf-8']
          The encoding to be used
  
      Returns
      -------
      s : unicode string (unicode on py2, str on py3)
          The Python unicode string that arrives as encoded bytes.
  
      Raises
      ------
      ZMQError
          for any of the reasons :func:`~Socket.recv` might fail
      """
      msg = self.recv(flags=flags)
      return self._deserialize(msg, lambda buf: buf.decode(encoding))
  
imports: import errno
  import random
  import sys
  import warnings
  import zmq
  from zmq.backend import Socket
  from .poll import Poller
  from .None import constants
  from .attrsettr import AttributeSetter
  from zmq.error import ZMQError, ZMQBindError
  from zmq.utils import jsonapi
  from zmq.utils.strtypes import bytes, unicode, basestring
  from .constants import SNDMORE, ENOTSUP, POLLIN, int64_sockopt_names, int_sockopt_names, bytes_sockopt_names, fd_sockopt_names
label_desc: Use image node_id 26 for calling the Socket obj's underlying member method code with example usage: obj.recv_string(flags, encoding) and returns: self