Net::X...essage(3pm)

💌 NAME 💌

Net::XMPP::Message — XMPP Message Module. okay bestie, welcome to the Net::XMPP::Message(3pm) page — the header literally squishes it to Net::X...essage(3pm), and honestly? relatable 😭. brought to you by User Contributed Perl Documentation, we love a community moment 💖

---

✨ SYNOPSIS ✨

Net::XMPP::Message is a companion to the Net::XMPP module. it gives you a simple interface to set and retrieve all parts of an XMPP Message. periodt.

---

🦋 DESCRIPTION 🦋

A Net::XMPP::Message object is passed to the callback function for the message. also, the first argument to the callback functions is the session ID from XML::Stream. there are some cases where you might want this information, like if you created a Client that connects to two servers at once, or for writing a mini server. iykyk.

use Net::XMPP;

sub message {
  my ($sid,$Mess) = @_;
  .
  .
  .
}

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

To create a new message to send to the server:

use Net::XMPP;

$Mess = Net::XMPP::Message->new();

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

---

💅 METHODS 💅

🔎 Retrieval functions 🔎

• GetTo() / GetTo("jid") — returns the value in the to='' attribute for the <message/>. if you specify "jid" as an argument then a Net::XMPP::JID object is returned and you can easily parse the parts of the JID. bestie, that's the JID cheat code.

$to    = $Mess->GetTo();
$toJID = $Mess->GetTo("jid");

• GetFrom() / GetFrom("jid") — returns the value in the from='' attribute for the <message/>. if you specify "jid" as an argument then a Net::XMPP::JID object is returned and you can easily parse the parts of the JID.

$from    = $Mess->GetFrom();
$fromJID = $Mess->GetFrom("jid");

• GetType() — returns the type='' attribute of the <message/>. each message is one of four types — the page says four, then lists five, and we're obsessed with the confidence:
  • normal — regular message (default if type is blank)
  • chat — one on one chat
  • groupchat — multi-person chat
  • headline — headline
  • error — error message

$type = $Mess->GetType();

• GetSubject() — returns the data in the <subject/> tag.

$subject = $Mess->GetSubject();

• GetBody() — returns the data in the <body/> tag.

$body = $Mess->GetBody();

• GetThread() — returns the data in the <thread/> tag.

$thread = $Mess->GetThread();

• GetError() — returns a string with the data of the <error/> tag.

$error = $Mess->GetError();

• GetErrorCode() — returns a string with the code='' attribute of the <error/> tag.

$errCode = $Mess->GetErrorCode();

• GetTimeStamp() — returns a string that represents the time this message object was created (and probably received) for sending to the client. if there is a jabber:x:delay tag then that time is used to show when the message was sent. timestamps but make it lore.

$date = $Mess->GetTimeStamp();

🛠️ Creation functions 🛠️

• SetMessage(to=>string|JID, from=>string|JID, type=>string, subject=>string, body=>string, thread=>string, errorcode=>string, error=>string) — set multiple fields in the <message/> at one time. this is a cumulative and over writing action. if you set the "to" attribute twice, the second setting is what is used. if you set the subject, and then set the body, then both will be in the <message/> tag. for valid settings read the specific Set functions below. okay multitasker ✨

$Mess->SetMessage(TO=>"bob\@jabber.org",
                  Subject=>"Lunch",
                  BoDy=>"Let's do lunch!");
$Mess->SetMessage(to=>"bob\@jabber.org",
                  from=>"jabber.org",
                  errorcode=>404,
                  error=>"Not found");

• SetTo(string) / SetTo(JID) — sets the to='' attribute. you can either pass a string or a JID object. they must be valid JIDs or the server will return an error message. (ie. bob@jabber.org/Work).

$Mess->SetTo("test\@jabber.org");

• SetFrom(string) / SetFrom(JID) — sets the from='' attribute. you can either pass a string or a JID object. they must be valid JIDs or the server will return an error message. (ie. jabber:bob@jabber.org/Work). this field is not required if you are writing a Client since the server will put the JID of your connection in there to prevent spamming. server said no spam, periodt.

$Mess->SetFrom("me\@jabber.org");

• SetType(string) — sets the type attribute. valid settings are:
  • normal — regular message (default if blank)
  • chat — one one one chat style message (yes bestie, that's what it says 😭)
  • groupchat — multi-person chatroom message
  • headline — news headline, stock ticker, etc...
  • error — error message

$Mess->SetType("groupchat");

• SetSubject(string) — sets the subject of the <message/>.

$Mess->SetSubject("This is a test");

• SetBody(string) — sets the body of the <message/>.

$Mess->SetBody("To be or not to be...");

• SetThread(string) — sets the thread of the <message/>. you should copy this out of the message being replied to so that the thread is maintained. keep the thread alive, bestie.

$Mess->SetThread("AE912B3");

• SetErrorCode(string) — sets the error code of the <message/>.

$Mess->SetErrorCode(403);

• SetError(string) — sets the error string of the <message/>.

$Mess->SetError("Permission Denied");

• Reply(hash) — creates a new Message object and populates the to/from, and the subject by putting "re: " in front. if you specify a hash the same as with SetMessage then those values will override the Reply values. reply guy with main character energy.

$Reply = $Mess->Reply();
$Reply = $Mess->Reply(type=>"chat");

🧹 Removal functions 🧹

• RemoveTo() — removes the to attribute from the <message/>.

$Mess->RemoveTo();

• RemoveFrom() — removes the from attribute from the <message/>.

$Mess->RemoveFrom();

• RemoveType() — removes the type attribute from the <message/>.

$Mess->RemoveType();

• RemoveSubject() — removes the <subject/> element from the <message/>.

$Mess->RemoveSubject();

• RemoveBody() — removes the <body/> element from the <message/>.

$Mess->RemoveBody();

• RemoveThread() — removes the <thread/> element from the <message/>.

$Mess->RemoveThread();

• RemoveError() — removes the <error/> element from the <message/>.

$Mess->RemoveError();

• RemoveErrorCode() — removes the code attribute from the <error/> element in the <message/>.

$Mess->RemoveErrorCode();

🧪 Test functions 🧪

• DefinedTo() — returns 1 if the to attribute is defined in the <message/>, 0 otherwise. vibe check: defined or not.

$test = $Mess->DefinedTo();

• DefinedFrom() — returns 1 if the from attribute is defined in the <message/>, 0 otherwise.

$test = $Mess->DefinedFrom();

• DefinedType() — returns 1 if the type attribute is defined in the <message/>, 0 otherwise.

$test = $Mess->DefinedType();

• DefinedSubject() — returns 1 if <subject/> is defined in the <message/>, 0 otherwise.

$test = $Mess->DefinedSubject();

• DefinedBody() — returns 1 if <body/> is defined in the <message/>, 0 otherwise.

$test = $Mess->DefinedBody();

• DefinedThread() — returns 1 if <thread/> is defined in the <message/>, 0 otherwise.

$test = $Mess->DefinedThread();

• DefinedErrorCode() — returns 1 if <error/> is defined in the <message/>, 0 otherwise.

$test = $Mess->DefinedErrorCode();

• DefinedError() — returns 1 if the code attribute is defined in the <error/>, 0 otherwise.

$test = $Mess->DefinedError();

---

🌸 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 LGPL 2.1.

---

anyway bestie, that's the whole page 💖 this little icon signs off from the Net::X...essage(3pm) footer with perl v5.42.0, dated 2016-01-12 🫶✨