MooseX...:Number(3pm)

💖 MooseX::AttributeHelpers::Trait::Number 💖

okay bestie, gather round, we're doing a User Contributed Perl Documentation moment. this one's from the MooseX...:Number(3pm) page and it's literally the cutest little numeric attribute you ever met. no cap.

---

✨ NAME ✨

MooseX::AttributeHelpers::Trait::Number — it's giving... a simple numeric attribute 🧮✨

---

🌸 VERSION 🌸

version 0.25 — yeah she's been around, she's vintage, she's iconic 👑

---

🎀 SYNOPSIS 🎀

okay so here's the whole vibe, copy-paste this into your lil heart:

package Real;
use Moose;
use MooseX::AttributeHelpers;

has 'integer' => (
    metaclass => 'Number',
    is        => 'ro',
    isa       => 'Int',
    default   => sub { 5 },
    provides  => {
        set => 'set',
        add => 'add',
        sub => 'sub',
        mul => 'mul',
        div => 'div',
        mod => 'mod',
        abs => 'abs',
    }
);

my $real = Real->new();
$real->add(5); # same as $real->integer($real->integer + 5);
$real->sub(2); # same as $real->integer($real->integer - 2);

like... look at her go. the metaclass => 'Number', the provides hash handing out all those math methods like friendship bracelets 🫶. main character behavior fr fr.

---

💅 DESCRIPTION 💅

So basically this trait gives you a simple numeric attribute, and she supports most of the basic math operations. that's it, that's the whole pitch. lowkey perfect, highkey useful. 🦋

---

🌈 METHODS 🌈

the whole squad, no notes:

• meta
• helper_type
• method_constructors

---

⭐ PROVIDED METHODS ⭐

🚨 important bestie alert 🚨 all of these methods do in place modification of the value stored in the attribute. like, they're changing the actual value, not handing you back a copy. so don't be surprised, okay? 😭

• set ($value) — an alternate way to set the value. the side door to the same house 🚪
• add ($value) — adds the current value of the attribute to $value. math but make it cute ➕
• sub ($value) — subtracts the current value of the attribute to $value. (yes, "to". we're keeping the original wording, don't come for me 🙈) ➖
• mul ($value) — multiplies the current value of the attribute to $value. times tables but slay ✖️
• div ($value) — divides the current value of the attribute to $value. split it like a friend group in a group project ➗
• mod ($value) — modulus the current value of the attribute to $value. the remainder, the leftovers, the crumbs 🍓
• abs — sets the current value of the attribute to its absolute value. glow up but for negatives ✨

---

🫶 SUPPORT 🫶

got bugs? not the vibe, but okay, here's where to go:

• Bugs may be submitted through the RT bug tracker: <https://rt.cpan.org/Public/Dist/Display.html?Name=MooseX-AttributeHelpers> — or email bug-MooseX-AttributeHelpers@rt.cpan.org 💌
• There is also a mailing list available for users of this distribution, at <http://lists.perl.org/list/moose.html> 📬
• There is also an irc channel available for users of this distribution, at #moose on irc.perl.org — <irc://irc.perl.org/#moose> 💬

come hang, we don't bite, iykyk 💜

---

👑 AUTHOR 👑

• Stevan Little <stevan@iinteractive.com>
• Robert Boone

legends, honestly. periodt. 💅

---

💖 COPYRIGHT AND LICENSE 💖

This software is copyright (c) 2007 by Stevan Little and Infinity Interactive, Inc.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. 🎀

---

and that's the whole page bestie, you ate it 🌈✨

this lil cutie was served to you by perl v5.34.0, dated 2022-06-15, straight from the MooseX...:Number(3pm) manual — mwah, go write some numbers, love u 💖🦋🎀