DBIx::C...:Cursor(3)

💅 DBIx::Class::Storage::DBI::ADO::MS_Jet::Cursor(3) 💅

okay so this is a Perl manpage from the User Contributed Perl Documentation set, section 3 — and yes the header on the original is all chopped up as DBIx::C...:Cursor(3), but bestie the full name is the whole slay:

DBIx::Class::Storage::DBI::ADO::MS_Jet::Cursor

---

✨ NAME ✨

DBIx::Class::Storage::DBI::ADO::MS_Jet::Cursor — GUID Support for MS Access over ADO 🎀

Like, that's literally the entire job description. It supports GUIDs. For MS Access. Over ADO. Iconic, focused, no notes.

---

🦋 DESCRIPTION 🦋

This class is for normalizing GUIDs retrieved from Microsoft Access over ADO. That's it, that's the whole vibe check — it takes your messy GUIDs and makes them presentable. 💅

Real talk though: you probably don't want to be here. Like, genuinely. See DBIx::Class::Storage::DBI::ACCESS for the actual info on the Microsoft Access driver — that's the main character of this story, this class is just a supporting cast member. 🫶

So here's the situation 😭 — unfortunately, when you're using DBD::ADO, GUIDs come back wrapped in braces. Yeah. Braces. Just hanging out around your data being extra. The entire purpose of this class is to remove them. That's the whole mission. No cap.

DBIx::Class::Storage::DBI::ADO::MS_Jet sets cursor_class to this class by default, so it just kind of shows up to the party uninvited-but-welcome. 🎉 And good news: it is overridable via your connect_info, so if you want a different cursor class you absolutely can swap it out. Your call, bestie.

Also, little fun fact that's highkey useful: you can use DBIx::Class::Cursor::Cached safely with this class and not lose the GUID normalizing functionality. How? ::Cursor::Cached uses the underlying class data for the inner cursor class. So the brace-removal magic survives the caching. We love a class that plays nice with others. 💖✨

---

🌸 FURTHER QUESTIONS? 🌸

Check the list of additional DBIC resources. That's the move. Go look at it. 🔍

---

👑 COPYRIGHT AND LICENSE 👑

This module is free software copyright by the DBIx::Class (DBIC) authors. You can redistribute it and/or modify it under the same terms as the DBIx::Class library. Slay, and legally so. 🎀

---

and that's the whole page, bestie — go normalize some GUIDs 💅✨

source/version + date, as promised: perl v5.42.0, dated 2025-01-22 🦋 mwah, bye! 💜