Synopsis:
   $userhost()

Technical:
   This function returns the address of the sending client of any message
   received by the client.  It only works in hooks, and only when the event
   hooked originated from another client on the irc network.  It takes no
   arguments.

Practical:
   This function is mostly useful for named hooks that do not dump the
   sender's address into its standard argument list.

Returns:
   address of message sender, or nothing if it does not apply

Examples:
   To show someone's address when they leave a channel:
      on ^leave "*" {
         echo *** $0 \($userhost()\) left channel $1
      }

See Also:
   lastserver(6)

Other Notes:
   This command has nothing to do with the USERHOST command, which queries
   the server for a nickname's address.  The $userhost() function does not
   query the server.