AnyEvent::XMPP::IM::AcUsertContributed Perl DocuAnyEvent::XMPP::IM::Account(3)NAMEAnyEvent::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.
perl v5.14.1 2009-08-14 AnyEvent::XMPP::IM::Account(3)