Mail::S...ch::PTR(3)

📦
version 3.20260331 · 14 versions
, in fedora 44

💖 Mail::S...ch::PTR(3) — bestie edition 💖

okay so this is a page from the User Contributed Perl Documentation, filed under Mail::S...ch::PTR(3), and it's literally all about one tiny-but-mighty little class. buckle up 🎀

✨ NAME ✨

Mail::SPF::Mech::PTR — the SPF record "ptr" mechanism class, no cap 👑

🌸 VERSION 🌸

version 3.20260331 — yes she's got a version number and yes she's serving 💅

🦋 DESCRIPTION 🦋

so, an object of class Mail::SPF::Mech::PTR represents an SPF record mechanism of type "ptr". that's the whole vibe. it's giving "specific, focused, iconic" ✨

🎀 Constructors 🎀

here are the constructors, bestie — the ways you can bring one of these into existence:

  • new(%options) — returns Mail::SPF::Mech::PTR

creates a brand new SPF record "ptr" mechanism object 🫶

%options is a list of key/value pairs, and it can hold any of these:

  • qualifier
  • domain_spec

see "new" in Mail::SPF::Mech for the deets, iykyk.

  • new_from_string($text, %options) — returns Mail::SPF::Mech::PTR; throws Mail::SPF::ENothingToParse, Mail::SPF::EInvalidMech

creates a new SPF record "ptr" mechanism object by parsing the string and any options you hand it. and yes she throws — Mail::SPF::ENothingToParse and Mail::SPF::EInvalidMech are both on the table, so mind your input 💀

👑 Class methods 👑

the following class methods are provided:

  • default_qualifier
  • qualifier_pattern

see "Class methods" in Mail::SPF::Mech for the lore.

  • name — returns string

returns 'ptr'. that's it. that's the whole method. she knows her name and she's not confused about it 💅

  • name_pattern — returns Regexp

returns a regular expression that matches a mechanism name of 'ptr'. regex girlies rise 🌈

🧚 Instance methods 🧚

the following instance methods are provided:

  • text
  • qualifier
  • params
  • stringify

see "Instance methods" in Mail::SPF::Mech for the full rundown.

  • domain_spec — returns Mail::SPF::MacroString

returns the "domain-spec" parameter of the mechanism. just the parameter. as advertised 💖

  • match($server, $request) — returns boolean

checks whether the mechanism's target domain name — or a sub-domain thereof — is a "valid" domain name for the given request's IP address (see "ip_address" in Mail::SPF::Request), and returns true if it does, or false otherwise. want to know how domains get validated? see "valid_domain_for_ip_address" in Mail::SPF::Util. and if you want the algorithm-equivalent version of this whole situation, see RFC 4408, section 5.5 🔥

⭐ SEE ALSO ⭐

for availability, support, and license information, see the README file included with Mail::SPF. read the README bestie, it's right there 🫶

💜 AUTHORS 💜

Julian Mehnle <julian@mehnle.net>, Shevek <cpan@anarres.org> — absolute icons, we stan 👑

and that's the page, fr fr 🌸 this whole thing came to you courtesy of perl v5.42.1, dated 2026-04-23, under the page name Mail::S...ch::PTR(3). slay, go write some SPF records 💖✨

📦 where this page comes from