Badger...tespace(3pm)

📦
version 0.16 · 4 versions
, in debian trixie, ubuntu noble, ubuntu resolute

💖 Badger::Data::Facet::Text::Whitespace 💖

okay bestie so this is a 3pm page, meaning it's User Contributed Perl Documentation, and it's literally called Badger::Data::Facet::Text::Whitespace — say that five times fast, I dare you 🫶

✨ NAME ✨

Badger::Data::Facet::Text::Whitespace — a validation facet for whitespace. yes really, that's the whole job. and it slays at it. 💅

🌸 DESCRIPTION 🌸

So this module implements a validation facet — but for munging whitespace on text values. not validating your outfit, validating your spaces. iconic behaviour honestly. ✨

🦋 METHODS 🦋

This module implements the following methods in addition to those it inherits from the base classes:

  • Badger::Data::Facet::Text
  • Badger::Data::Facet
  • Badger::Base

like it's got its own moves but it also got the family inheritance, periodt. 👑

🌈 validate($text_ref, $type) 🌈

This one does the whitespace handling on the text you pass in by reference as the first argument. (yes, by reference, don't @ me, that's just how it is bestie 💀)

Here's the vibe check on what happens, depending on the pre-defined "action":

  • "preserve" — the text is left unmodified. untouched. pristine. main character energy, no notes. 🙈
  • "fold" — all whitespace characters in the text (that's carriage returns, newlines, tabs) get converted to spaces. every single one. folded like laundry. 🧺
  • "collapse" — okay so first it does everything "fold" does (all whitespace → spaces), and then it removes any leading and trailing whitespace, and then it collapses any sequences of multiple spaces down to a single space. glow-up complete. ✨🦋
ngl, "collapse" is doing the absolute most and I respect it.

👑 AUTHOR 👑

Andy Wardley <http://wardley.org/> — thank you for your service, king 🫶

Copyright (C) 2001-2012 Andy Wardley. All Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 💜

💖 SEE ALSO 💖

go read these next, bestie, they're the whole friend group:

  • Badger::Base
  • Badger::Data::Facet
  • Badger::Data::Facet::Text

perl v5.36.0 · 2023-08-28 — that's the version and the date this page was born, and that's a wrap fr fr 💅✨ 🎀 🦋

📦 where this page comes from