GO::Utils(3pm)

💖 GO::Utils(3pm) 💖

okay bestie, welcome to GO::Utils — the lil grab-bag of utility functions for GO modules ✨ it ships as part of the User Contributed Perl Documentation, and honestly? it's giving "toolbox that just works." no cap.

---

🌸 NAME 🌸

GO::Utils — utilities for GO modules 🧰💅

---

✨ DESCRIPTION ✨

it's a collection of helper subs, that's the vibe. let's go through them one by one, bestie 🫶

🎀 rearrange()

• Usage — n/a
• Function — rearranges named parameters into the order you requested 🔀
• Returns — @params, an array of parameters in the requested order
• Argument — $order: a reference to an array that describes the desired order of the named parameters. And @param: an array of parameters — either as a plain list (in which case the function simply returns the list, no drama), or as an associative array (in which case the function sorts the values according to @{$order} and hands you back that new array 💖)
• Exceptions — carps if a non-recognised parameter gets sent in 😭

🦋 get_param()

• Usage — get_param('name',(-att1=>'ben',-name=>'the_name'))
• Function — fetches a named parameter 🔍
• Returns — the value of the requested parameter
• Argument — $name: the name of the the parameter desired. And @param: an array of parameters, as an associative array
• Exceptions — carps if a non-recognised parameter gets sent in 😭

this one is based on rearrange(), which originally came from CGI.pm by Lincoln Stein and BioPerl by Richard Resnick 👑 see rearrange() for the details, iykyk.

🌈 remove_duplicates

removes duplicate items from an array, bestie — decluttering but for data 🧹✨

• usage — remove_duplicates(\@arr)

heads up: it affects the array passed in, and returns the modified array. so it's not a copy situation, it's an in-place glow-up 💅

💜 merge_hashes

joins two hashes together 🫂

• usage — merge_hashes(\%h1, \%h2);

%h1 will now contain the key/val pairs of %h2 as well. and if there are key conflicts? %h2 values take precedence. periodt 👑

🍓 get_method_ref

returns a pointer to a particular object's method 🎯 like:

my $length_f = get_method_ref($seq, 'length');
$len = &$length_f();

main character energy fr fr.

⭐ pset2hash

• Usage — my $h = pset2hash([{name=>"id", value=>"56"}, {name=>"name", value=>"jim"}]);
• Returns — hashref
• Args — arrayref of name/value keyed hashrefs

🌸 spell_greek

takes a word as a parameter and spells out any greek symbols encoded within it 🏛️✨ (eg s/&agr;/alpha/g) — literal sorcery, we love to see it.

🔥 check_obj_graph

• Usage — (nothing listed, bestie)
• Returns — true if a cycle is detected 🔄
• Args — any object

lowkey important: this is your cycle detector. if it comes back true, you've got a loop situation on your hands 💀

---

and that's the whole page!! 💖🧚 no cap, you're now fully caught up.

perl v5.36.0 · 2023-12-18 · mwah, go slay 💅👑🫶