|<B>is_retrievedB>||Returns true if this roster was fetched from the server or false if this roster hasnt been retrieved yet.|
|<B>new_contact ($jid, B>$name<B>, B>$groups<B>, B>$cb<B>)B>||
This method sends a roster item creation request to
the server. $jid is the JID of the contact.
$name is the nickname of the contact, which can be
undef. $groups should be a array reference containing
the groups this contact should be in.
The callback in $cb will be called when the creation is finished. The first argument will be the Net::XMPP2::IM::Contact object if no error occured. The second argument will be an Net::XMPP2::Error::IQ object if the request resulted in an error.
Please note that the contact you are given in that callback might not yet be on the roster (is_on_roster still returns a false value), if the server did send the roster push after the iq result of the roster set, so dont rely on the fact that the contact is on the roster.
|<B>delete_contact ($jid, B>$cb<B>)B>||This method will send a request to the server to delete this contact from the roster. It will result in cancelling all subscriptions.|
Returns the contact on the roster with the JID $jid.
(If $jid is not bare the resource part will be stripped
The return value is an instance of Net::XMPP2::IM::Contact.
Returns the contacts that are on this roster as
NOTE: This method only returns the contacts that have a roster item. If you havent retrieved the roster yet the presence information is still stored but you have to get the contacts without a roster item with the get_contacts_off_roster method. See below.
Returns the contacts that are not on the roster
but for which we have received presence.
Return value is a list of Net::XMPP2::IM::Contact objects.
See also documentation of get_contacts method of Net::XMPP2::IM::Roster above.
|<B>debug_dumpB>||This prints the roster and all its contacts and their presences.|
Robin Redeker, <elmex at ta-sa.org>, JID: <elmex at jabber.org>
Net::XMPP2::IM::Connection, Net::XMPP2::IM::Contact, Net::XMPP2::IM::Presence
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::ROSTER (3)||2007-12-10|