Mail::S...::Exists(3)

📦
version 3.20260331 · 14 versions
, in fedora 44

💖 NAME 💖

ok so bestie, gather round — Mail::SPF::Mech::Exists is the SPF record "exists" mechanism class, and she's literally the whole vibe. 🦋

(this page lives in section 3 of the manual, Mail::S...::Exists(3), part of the User Contributed Perl Documentation — iykyk ✨)

🌸 VERSION 🌸

version 3.20260331 — fresh, current, slaying. 💅

✨ DESCRIPTION ✨

An object of class Mail::SPF::Mech::Exists represents an SPF record mechanism of type "exists". That's it, that's the girl. 👑

🎀 Constructors 🎀

Here's the constructors, bestie — these are the lil factory functions that make you a whole new object:

  • new(%options): returns Mail::SPF::Mech::Exists — creates a brand new SPF record "exists" mechanism object. iconic behavior.

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

  • qualifier
  • domain_spec

→ head over to "new" in Mail::SPF::Mech for the deets on both of those. 🫶

  • new_from_string($text, %options): returns Mail::SPF::Mech::Exists; throws Mail::SPF::ENothingToParse, Mail::SPF::EInvalidMech — creates a new SPF record "exists" mechanism object by parsing the string and any options given. she reads the string, she builds the object, she's multitasking fr fr. 😭
heads up: this one can absolutely throw Mail::SPF::ENothingToParse or Mail::SPF::EInvalidMech at you if the string isn't giving what it's supposed to give. no cap. 💀

🌈 Class methods 🌈

The following class methods are provided:

  • default_qualifier
  • qualifier_pattern

→ see "Class methods" in Mail::SPF::Mech. go, go, go. 🧚

  • name: returns string — returns 'exists'. short, sweet, correct.
  • name_pattern: returns Regexp — returns a regular expression that matches a mechanism name of 'exists'. she knows how to spot her own name in the wild. 🎀

💜 Instance methods 💜

The following instance methods are provided:

  • text
  • qualifier
  • params
  • stringify

→ see "Instance methods" in Mail::SPF::Mech for all of those, bestie.

  • domain_spec: returns Mail::SPF::MacroString — returns the "domain-spec" parameter of the mechanism. that's the param, that's the type, periodt.
  • match($server, $request): returns boolean — checks whether a DNS "A" record exists for the mechanism's target domain name, and returns true if one does, or false otherwise. 🔥 see RFC 4408, section 5.7, for the details — yes, actual details, go read them, I'm not gatekeeping.

👑 SEE ALSO 👑

and for availability, support, and license information, check the README file included with Mail::SPF. 🌸 it's all in there, promise.

💖 AUTHORS 💖

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

ok that's the whole page bestie, ily, go write some SPF records 💅✨

bye bestie! this was brought to you by perl v5.42.1, dated 2026-04-23 — mwah, take care of her, she's iconic. 🎀🦋
📦 where this page comes from