JE::Ob...::Array(3pm)

👑 JE::Ob...::Array(3pm) — bestie, it's the JavaScript Array era

okay so real talk, this page lives in the User Contributed Perl Documentation collection, and it's your girl JE::Ob...::Array(3pm) — yes the title got cut off in the header, it's giving mysterious 💅, but the actual module is JE::Object::Array. come sit with me.

---

✨ NAME ✨

JE::Object — it's the JavaScript Array object class, no cap 🍓

---

🦋 SYNOPSIS 🦋

use JE;
use JE::Object::Array;

$j = new JE;

$js_array = new JE::Object::Array $j, 1, 2, 3;

$perl_arrayref = $js_array->value; # returns [1, 2, 3]

$js_array->[1]; # same as $js_array->value->[1]

"$js_array"; # returns "1,2,3"

like. look at her. iconic behavior from start to finish 😭✨

---

💖 DESCRIPTION 💖

This module implements JavaScript Array objects. that's the whole vibe. arrays, but JavaScript-flavored, living rent free in your Perl process 🫶

The @{} (array ref) operator is overloaded and returns a tied array that you can use to modify the array object itself. the way that it's tied?? obsessed. but heads up bestie:

The limitations and caveats mentioned in "JE::Object/"USING AN OBJECT AS A HASH"" apply here, too. fr fr, go read that section, it's not optional 💀

---

🌸 METHODS 🌸

See JE::Types for descriptions of most of the methods — she's the big sister doc, she covers the basics. Only what is specific to JE::Object::Array is explained here. periodt.

• $a = JE::Object::Array->new($global_obj, \@elements)
• $a = JE::Object::Array->new($global_obj, $length)
• $a = JE::Object::Array->new($global_obj, @elements)

This creates a new Array object. and the way it decides how depends on what you hand her:

• If the second argument is an unblessed array ref, the elements of that array become the elements of the new array object. literally just slide the array ref in and she copies the vibes 🌈
• If there are two arguments and the second is a JE::Number, a new array is created with that number as the length. so like, an empty array that knows how long it's supposed to be. main character energy 👑
• Otherwise, all arguments starting from the second one become elements of the new array object. so new JE::Object::Array $j, 1, 2, 3 just... becomes [1, 2, 3]. ate. 💅

• $a->value

This returns a reference to an array. but — and this is the important part, don't skip it 😭 — this is a copy of the Array object's internal array. if you want an array through which you can actually modify the object, use @$a. ngl that distinction is the whole game. don't come crying to me when your edits don't stick because you were poking at a copy 🙈

---

🎀 SEE ALSO 🎀

• JE
• JE::Types
• JE::Object

the whole friend group. go say hi 🫶

---

lowkey a warning but make it cute: that @{} tied-array thing comes with the exact same limitations and caveats as the hash section over in JE::Object. no surprises, just read it before you get weird with it 💜

---

and that's the page, bestie!! 💖 this was perl v5.36.0, dated 2023-08-25, and it's the JE::Ob...::Array(3pm) page — slay, bye, go build an array 🦋✨👑