---
name: "AnyEvent::XMPP::IM::Account"
section: "3pm"
platform: "linux"
package: "perl-anyevent-xmpp"
version: "0.55-7"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/AnyEvent::XMPP::IM::Account"
---

# AnyEvent::XMPP::IM::Account(3pm)

Instant messaging account

## NAME

AnyEvent::XMPP::IM::Account - Instant messaging account

## SYNOPSIS

```
   my $cl = AnyEvent::XMPP::IM::Client->new;
   ...
   my $acc = $cl->get_account ($jid);
```

## DESCRIPTION

This module represents a class for IM accounts. It is used by AnyEvent::XMPP::Client.

You can get an instance of this class only by calling the `"get_account"` method on a AnyEvent::XMPP::Client object.

## METHODS

- **connection ()**

  Returns the AnyEvent::XMPP::IM::Connection object if this account already has one (undef otherwise).

- **is\_connected ()**

  Returns true if this accunt is connected.

- **jid ()**

  Returns either the full JID if the account is connected or returns the bare jid if not.

- **bare\_jid ()**

  Returns always the bare JID of this account after stringprep has been applied, so you can compare the JIDs returned from this function.

- **nickname ()**

  Your nickname for this account.

- **nickname\_for\_jid ($jid)**

  This method transforms the `$jid` to a nickname. It looks the `$jid` up in the roster and looks for a nickname. If no nickname could be found in the roster it returns the node part for the `$jid`.

- **send\_tracked\_message ($msg)**

  This method sends the AnyEvent::XMPP::IM::Message object in `$msg`. The `"to"` attribute of the message is adjusted by the conversation tracking mechanism.

## EVENTS

For these events callbacks can be registered (with the Object::Event interface):

- tracked\_message\_destination =\> $bare\_jid, $full\_jid

  This event is emitted whenever the message tracking mechanism changes (or sets) it's destination resource for the `$bare_jid` to `$full_jid`.

- removed

  Whenever the account is removed from the AnyEvent::XMPP::Client (eg. when disconnected) this event is emitted before it is destroyed.

## AUTHOR

Robin Redeker, `"<elmex at ta-sa.org>"`, JID: `"<elmex at jabber.org>"`

## COPYRIGHT & LICENSE

Copyright 2007, 2008 Robin Redeker, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.