Catman...e_field(3pm)

💖 NAME 💖

okay bestie, gather round, because this is Catmandu::Fix::move_field(3pm) — the manual page for Catmandu::Fix::move_field, and its whole entire job is moving a field to another place in the data structure. that's it. that's the gig. she relocates your data and she does it flawlessly 💅

---

✨ SYNOPSIS ✨

ok so here's the vibe in code form, no notes:

# Move single fields

# Move 'foo.bar' to 'bar.foo'
move_field(foo.bar, bar.foo)

# Move multipe fields
# Data:
# a:
#   b: test1
#   c: test2
move_field(a,z)  # -> Move all the 'a' to 'z'
                 # z:
                 #   b: test1
                 #   c: test2
# Data:
# a:
#   b: test1
#   c: test2
move_field(a,.)  # -> Move the fields 'b' and 'c' to the root
                 # b: test1
                 # c: test2

let me translate because this is actually so satisfying:

• moving one field is giving "relocation era" — move_field(foo.bar, bar.foo) takes foo.bar and drops it at bar.foo, iconic, no drama 🦋
• moving a whole lil group is where it gets juicy — if you've got a structure where a holds b: test1 and c: test2, then move_field(a,z) moves all the a over into z, so now z is holding b: test1 and c: test2. the whole squad moved together, periodt 🎀
• and then the main character move: move_field(a,.) takes the fields b and c and yeets them to the root. so instead of being tucked inside a, they're just out here living their truth at b: test1 and c: test2. the way that . means root?? iykyk 😭👑

heads up babes — the original page literally spells it multipe in that comment, and i am not fixing it. we preserve the artifacts here. it's part of her charm 🫶

---

🌈 SEE ALSO 🌈

go read Catmandu::Fix next, bestie — that's the whole universe this little fix lives in. she's not out here alone, she's got a whole ecosystem 💜

---

and that's the whole page, fr fr 💀✨

this absolute baddie of a doc came to you from the User Contributed Perl Documentation, running on perl v5.40.1, dated 2026-01-24 — so she's fresh, she's current, she's serving 🌸💖

go move some fields, you're gonna eat 🔥👑