|<B>send_update ($cb, B>%upd<B>)B>||
This method updates a contact. If the request is finished
it will call $cb. If it resulted in an error the first argument
of that callback will be a Net::XMPP2::Error::IQ object.
The %upd hash should have one of the following keys and defines what parts of the contact to update:
|<B>send_subscribe ()B>||This method sends this contact a subscription request.|
|<B>send_subscribed ()B>||This method accepts a contacts subscription request.|
|<B>send_unsubscribe ()B>||This method sends this contact a unsubscription request.|
|<B>send_unsubscribed ()B>||This method sends this contact a unsubscription request which unsubscribes ones own presence from him (he wont get any further presence from us).|
|<B>update ($item)B>||This method wants a Net::XMPP2::Node in $item which should be a roster item received from the server. The method will update the contact accordingly and return it self.|
|<B>update_presence ($presence)B>||This method updates the presence of contacts on the roster. $presence must be a Net::XMPP2::Node object and should be a presence packet.|
|<B>get_presence ($jid)B>||This method returns a presence of this contact if it is available. The return value is an instance of Net::XMPP2::IM::Presence or undef if no such presence exists.|
|<B>get_presencesB>||Returns all presences of this contact in form of Net::XMPP2::IM::Presence objects.|
|<B>get_priority_presenceB>||Returns the presence with the highest priority.|
|<B>groupsB>||Returns the list of groups (strings) this contact is in.|
|<B>jidB>||Returns the bare JID of this contact.|
|<B>nameB>||Returns the (nick)name of this contact.|
|<B>is_on_roster ()B>||Returns 1 if this is a contact that is officially on the roster and not just a contact weve received presence information for.|
Returns the subscription state of this contact, which
can be one of:
If the contact isnt on the roster anymore this method returns:
|<B>askB>||Returns subscribe if we asked this contact for subscription.|
|<B>subscription_pendingB>||Returns true if this contact has a pending subscription. That means: the contact has to aknowledge the subscription.|
|<B>nicknameB>||Returns the nickname of this contact.|
This method returns a Net::XMPP2::IM::Message
object with the to field set to this contacts JID.
%args are further arguments for the message constructor.
Robin Redeker, <elmex at ta-sa.org>, JID: <elmex at jabber.org>
Copyright 2007 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.20.3||NET::XMPP2::IM::CONTACT (3)||2007-10-16|