Excel:...::Loop(3pm)

💖 Excel::Template::Container::Loop — bestie edition 💖

okay so you found the manpage for Excel::Template::Container::Loop(3pm) and honestly? slay. this is the Perl module that gives your Excel templates the power of looping, and i'm about to walk you through it like we're texting at 2am. no cap, it's short and it's iconic.

---

✨ NAME ✨

Excel::Template::Container::Loop — literally just Excel::Template::Container::Loop. the name is the name, periodt. 💅

🎯 PURPOSE 🎯

to provide looping. that's it. that's the whole job. it loops. 🌀

🏷️ NODE NAME 🏷️

LOOP

that's what you call it in your template, bestie. remember it. 💖

👑 INHERITANCE 👑

Excel::Template::Container

so it's a container, and it inherited all that container energy. main character lineage fr fr. 🌈

🌸 ATTRIBUTES 🌸

• NAME — this is the name of the loop, and it's lowkey the most important part. it's used to identify, within the parameter set, what variables to expose to the children nodes each iteration. so like… the name is the key that unlocks which array of hashes your kids get to see. no name, no vibes. 🎀

🧚 CHILDREN 🧚

None. zero. nada. it's giving "i work alone" 💀

✨ EFFECTS ✨

None. it's not out here changing your whole life, it just loops. 🙈

🦋 DEPENDENCIES 🦋

None. it's self-sufficient. independent queen behavior. 👑

💅 USAGE 💅

  <loop name="LOOPY">
    ... Children here ...
  </loop>

so in the example above, the children nodes would have access to the LOOPY array of hashes as parameters. every iteration through that array exposes a different hash of parameters to the children. so each trip around the loop, your kids get new data. it's like handing out different snacks each time you walk past. 🍓

these loops work just like HTML::Template's loops. (and the author literally promises — "I promise I'll give more info here!" — so like, we're all waiting on that, bestie 😭)

there is one difference — and it's a cute one. the author prefers using Perl-like scoping, so accessing variables outside the LOOP scope from within is perfectly acceptable. you can also hide outside variables with inner values, if you desire, just like Perl. so it's giving very much "what happens in the loop stays in the loop, unless you want it not to." 🫶

---

💜 AUTHOR 💜

Rob Kinyon (rob.kinyon@gmail.com)

🔥 SEE ALSO 🔥

…nothing listed. the page just ends. iconic, honestly. go forth and loop. 🌟

---

this page came from the Perl docs for perl v5.34.0, dated 2022-06-13, under the manual name Excel:...::Loop(3pm) — mwah, thanks for reading, bestie, you ate 💖✨🎀