Net::XMPP::JID (3)

Leading comments

Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)

Standard preamble:
========================================================================

(The comments found at the beginning of the groff file "man3/Net::XMPP::JID.3pm".)

NAME

Net::XMPP::JID - XMPP JID Module

SYNOPSIS

Net::XMPP::JID is a companion to the Net::XMPP module. It provides the user a simple interface to set and retrieve all parts of a Jabber (userid on a server).

DESCRIPTION

To initialize the you must pass it the string that represents the jid from the packet. Inside the modules this is done automatically and the object is returned instead of a string. For example, in the callback function for the object foo:

    use Net::XMPP;

    sub foo {
      my $foo = Net::XMPP::Foo->new(@_);
      my $from = $foo->GetFrom();
      my $JID = Net::XMPP::JID->new($from);
      .
      .
      .
    }

You now have access to all of the retrieval functions available.

To create a new

to send to the server:

    use Net::XMPP;

    $JID = Net::XMPP::JID->new();

Now you can call the creation functions below to populate the tag before sending it.

Retrieval functions

    $userid   = $JID->GetUserID();
    $server   = $JID->GetServer();
    $resource = $JID->GetResource();

    $JID      = $JID->GetJID();
    $fullJID  = $JID->GetJID("full");
    $baseJID  = $JID->GetJID("base");

Creation functions

    $JID->SetJID(userid=>"bob",
                 server=>"jabber.org",
                 resource=>"Work");

    $JID->SetJID('blue@moon.org/Home');

    $JID->SetUserID("foo");
    $JID->SetServer("bar.net");
    $JID->SetResource("Foo Bar");

METHODS

Retrieval functions

GetUserID

  GetUserID()

returns a string with the userid of the

JID.

If the string is an address (bob%jabber.org) then the function will return it as an address (bob@jabber.org).

GetServer

  GetServer()

returns a string with the server of the

JID.

GerResource

  GetResource()

returns a string with the resource of the

JID.

GetJID

  GetJID()      
  GetJID("full")
  GetJID("base")
returns a string that represents the JID stored
within.  If the "full" string is specified, then
you get the full JID, including Resource, which
should be used to send to the server.  If the "base",
string is specified, then you will just get
user@server, or the base JID.

Creation functions

SetJID

  SetJID(userid=>string,  
         server=>string,  
         resource=>string)
  SetJID(string)

set multiple fields in the jid at one time. This is a cumulative and over writing action. If you set the ``userid'' attribute twice, the second setting is what is used. If you set the server, and then set the resource then both will be in the jid. If all you pass is a string, then that string is used as the

JID.

For valid settings read the specific Set functions below.

SetUserID

  SetUserID(string)

sets the userid. Must be a valid userid or the server will complain if you try to use this

JID

to talk to the server. If the string is an address then it will be converted to the % form suitable for using as a User

ID.

SerServer

  SetServer(string)

sets the server. Must be a valid host on the network or the server will not be able to talk to it.

SetResource

  SetResource(string)

sets the resource of the userid to talk to.

AUTHOR

Originally authored by Ryan Eatmon.

Previously maintained by Eric Hacker.

Currently maintained by Darian Anthony Patrick.

COPYRIGHT

This module is free software, you can redistribute it and/or modify it under the