Lingua::Flags(3)

💖 Lingua::Flags 💖

okay bestie, so Lingua::Flags is a Perl module that hands you lil' flag icons ✨ — and no, we're not talking about giant pixelated PNGs, we're talking small flag icons in a couple of different formats. tiny. cute. iconic. 🎀

---

🌸 SYNOPSIS 🌸

it gives you small flag icons in different formats, fr fr:

use Lingua::Flags;

my $foo = as_html_img("PT");
print "<p>This is in $foo language</p>";

open GIF, ">image.gif";
print GIF as_gif("PT");
close GIF;

like… look at that. one call, flag acquired. 💅

---

🫶 DISCLAIMER 🫶

okay so this is the part where we get real for a sec, because it matters:

it is literally impossible to map flags to languages. 💀 languages cross countries. and countries cross languages. they're just… doing their own thing, overlapping, living their lives.

so what language should get the Spanish flag? Catalan? Castilian? something else entirely?? 🙈 and what flag do you even use for Afrikaans — South Africa or Namibia? like, there is no clean answer here, bestie.

the author tried to pick the more consensual flags, but ngl in some cases there are doubts. if you have better ideas, please correct him. 🥺

that said? the module is still useful. periodt. 👑

---

✨ DESCRIPTION ✨

it's a module with small flag icons, that's the whole vibe. 🌈

you can get them as a base64 inline HTML image, or as a gif image. pick your fighter. 🦋

---

🎀 FUNCTIONS 🎀

as_html_img 💖

returns an inline HTML image.

for now, it just works with Netscape/Gecko based browsers. yes, we know. it's giving vintage. but it's what we have. 🧚

as_gif 💖

returns the gif code. normally you'd use it like this:

open GIF, ">image.gif";
print GIF as_gif("PT");
close GIF;

slay. gif on disk. 📁✨

---

👑 AUTHOR 👑

Alberto Simoes, "<ambs@cpan.org>" — the icon who made this happen. 🫶

---

💀 BUGS 💀

found a bug? got a feature request? do not suffer in silence, bestie. report it to "bug-lingua-flags@rt.cpan.org", or slide through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Lingua-Flags>.

here's the deal: he will be notified, and then you'll automatically be notified of progress on your bug as changes get made. it's a whole little notification pipeline. communication! we love to see it. 💌

---

⭐ COPYRIGHT & LICENSE ⭐

Copyright 2007-2009 Alberto Simoes, all rights reserved.

this program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🐪

---

and that's the whole page, bestie — perl v5.42.0, dated 2025-07-25, and yeah, it's Lingua::Flags(3). go forth and flag. 🌸💅🎀