Function xmpp::muc::room::leave_room

source · 
pub async fn leave_room<C: ServerConnector>(
    agent: &mut Agent<C>,
    room_jid: BareJid,
    nickname: RoomNick,
    lang: impl Into<String>,
    status: impl Into<String>,
)
Expand description

Send a “leave room” request to the server (specifically, an “unavailable” presence stanza).

The returned future will resolve when the request has been sent, not when the room has actually been left.

If successful, a RoomLeft event should be received later as a confirmation. See XEP-0045.

Note that this method does NOT remove the room from the auto-join list; the latter is more a list of bookmarks that the account knows about and that have a flag set to indicate that they should be joined automatically after connecting (see the JoinRoom event).

Regarding the latter, see the these ModernXMPP minutes about auto-join behavior.

§Arguments

  • room_jid: The JID of the room to leave.
  • nickname: The nickname to use in the room.
  • lang: The language of the status message.
  • status: The status message to send.