Biber:...::Names(3pm)

💖 NAME 💖

Biber::Entry::Names — okay bestie, these are literally Biber::Entry::Names objects. That's the whole vibe. It's a lil container class that holds a whole squad of name objects and lets you poke at them. 👑

---

✨ THE METHODS ✨

Every method, no skips, no cap. 🫶

🌸 new

Initialize a Biber::Entry::Names object. Brand new baby object, fresh out the box. ✨

🌸 notnull

Test for an empty object. Is it giving nothing? This tells you. 💀

🌸 names

Return a ref to an array of all the Biber::Entry::Name objects hanging out in the object. The whole roster. 📋

🌸 add_name

Add a Biber::Entry::Name object to the Biber::Entry::Names object. New friend joins the group chat. 🎀

🌸 replace_name

Replace a Biber::Entry::Name at a position (1-based, so the first one is 1, not 0 — yes really) with one you provide. Out with the old, in with the new. 💅

🌸 splice

Splice a Biber::Entry::Names object into a Biber::Entry::Names object at a position (1-based again, bestie, keep up 💖). Object-ception, lowkey iconic.

🌸 set_morenames

Sets a flag to say that we had a "and others" in the data. You know, the mysterious unnamed extras. 👀

🌸 get_morenames

Gets the morenames flag. Did we have an "and others" or not? Asking for a friend.

🌸 count

Returns the number of Biber::Entry::Name objects in the object. Headcount time. 🔢

🌸 is_nth_name

Returns a boolean to say if there is an nth name. Simple yes-or-no, fr fr.

🌸 nth_name

Returns the nth Biber::Entry::Name object in the object, or the last one if n > total names. So if you overshoot, you just get the last name — no error, no drama, she's chill like that. 😌

🌸 first_n_names

Returns an array ref of Biber::Entry::Name objects containing only the first n Biber::Entry::Name objects, or all names if n > total names. Same energy as above: ask for too many, get everything. 🌈

🌸 del_last_name

Deletes the last Biber::Entry::Name object in the object. Bye bestie, we hardly knew ye. 😭

🌸 last_name

Returns the last Biber::Entry::Name object in the object. The final girl of the name list. 👑

🌸 get_xdata

Get any xdata reference information for a namelist. Cross-reference lore, iykyk. 🔥

🌸 dump

Dump a Biber::Entry::Names object for debugging purposes. Not for the vibes, for the bug hunt. 🐛

---

🌟 AUTHORS 🌟

Philip Kime <philip at kime.org.uk> — the icon, the legend. 🫶

---

🚨 BUGS 🚨

Please report any bugs or feature requests on our Github tracker at <https://github.com/plk/biber/issues>. Spill the tea, we wanna know. 💜

---

📜 COPYRIGHT & LICENSE 📜

Copyright 2009-2012 François Charette and Philip Kime, all rights reserved. Copyright 2012-2026 Philip Kime, all rights reserved.

This module is free software. You can redistribute it and/or modify it under the terms of the Artistic License 2.0. Slay, legally. ✨

This program is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose. (Translation: it's giving no promises, bestie. 🙈)

---

Okay that's the whole page! Written for perl v5.42.3, dated 2026-08-14, and documented under the manual name Biber:...::Names(3pm). Mwah, go forth and name things. 💅🎀