docs::a...:String(3)

🌸 NAME 🌸

Okay so this is APR::String — the Perl API for manipulating APR UUIDs 💅 (yes bestie, that's what the page says, we're not questioning it, we're just reporting it ✨). It's under "User Contributed Perl Documentation," which is giving very "made by the community, for the community" energy fr fr 🫶.

---

✨ Synopsis ✨

Like, here's the whole vibe in one look:

  use APR::String ();

  # 42_000 => " 41K",
  my $size_str = APR::String::format_size($size);

See that comment? 42_000 turns into " 41K" — iconic behaviour, no cap 👑

---

🦋 Description 🦋

"APR::String" provides strings manipulation API. That's it, that's the whole description, short and sweet and honestly kind of a serve 🎀.

---

💖 API 💖

"APR::String" provides the following functions and/or methods — yes, the singular "functions" era, we love a tiny API 🌈:

⭐ format_size

  my $size_str = APR::String::format_size($size);

• arg1: $size ( integer ) — you hand it a number, that's the whole task, you're doing amazing sweetie 🍓
• ret: $size_str — returns a formatted size string representation of a number. The size given in the string will be in units of bytes, kilobytes, or megabytes, depending on the size. The length of that string is always 4 chars long. Always. Four. Characters. No exceptions, the aesthetic is locked in 💅

For example:

  0               => "  0 ",
  42              => " 42 ",
  42_000          => " 41K",
  42_000_000      => " 40M",

Look at those padded spaces — it's giving aligned columns, it's giving main character formatting energy ✨

• since: 2.0.00 — vintage, but in a cool way 👑

---

👀 See Also 👀

mod_perl 2.0 documentation. Go read it, bestie, it's right there 📚

---

🎀 Copyright 🎀

mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0. Respect the license, it's literally the law 🙈

---

💜 Authors 💜

The mod_perl development team and numerous contributors. Shoutout to the whole group chat of people who made this happen 🫶🔥

---

That's the whole page, bestie — short, sweet, and every single detail is still here 💀✨

Signing off from perl v5.42.3, dated 2023-10-21, on the docs::a...:String(3) page — catch you in the next manpage 💖