CGI::U...::email(3pm)

💌 CGI::U...::email(3pm) — the User Contributed Perl Documentation glow-up ✨

okay bestie, gather round, because we're talking about CGI::Untaint::email — yes that's the manual page name up top and yes she's serving User Contributed Perl Documentation realness. this little cutie lives in the CGI::Untaint family and she has ONE job and she does it flawlessly 💅

---

🎀 NAME 🎀

CGI::Untaint::email — validate an email address. that's it. that's the whole vibe. she checks your emails so you don't have to 🦋

---

✨ SYNOPSIS ✨

the way you use her is literally so simple, watch:

use CGI::Untaint;
my $handler = CGI::Untaint->new($q->Vars);

my $email = $handler->extract(-as_email => 'emailaddress');

see? iconic. no notes. 👑

---

🌸 DESCRIPTION 🌸

so CGI::Untaint::email is an input handler, and what she does is verify that the thing you handed her is a valid RFC2822 mailbox format. like, she's doing the vibe check on your email address and she will NOT let a fake one through, no cap 🚫

and the result? the resulting value will be a Mail::Address instance. so you don't just get a yes/no, you get a whole object back, which is honestly giving main character energy 🫶

---

💖 AUTHOR 💖

this beauty was written by Tatsuhiko Miyagawa <miyagawa@bulknews.net> 🎀

and here's the legal tea, fr fr: this library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. periodt. 💜

---

🔥 SEE ALSO 🔥

• CGI::Untaint — the mothership, the whole framework she belongs to
• Email::Valid — another baddie in the email-validation cinematic universe

---

and that's the whole page bestie, no crumbs left 💀

kisses and bye-bye from the perl v5.34.0 era, dated 2022-06-10, filed under CGI::U...::email(3pm) 🌈✨💖