Net::Z3950::ZOOM(3pm)

✨ NAME ✨

Net::Z3950::ZOOM — a Perl extension for invoking the ZOOM-C API 💅

okay so this is the module, and the vibe is "yes it exists, no you don't want it." let's get into it bestie 🫶

---

🌸 SYNOPSIS 🌸

use Net::Z3950::ZOOM;
$conn = Net::Z3950::ZOOM::connection_new($host, $port);
$errcode = Net::Z3950::ZOOM::connection_error($conn, $errmsg, $addinfo);
Net::Z3950::ZOOM::connection_option_set($conn, databaseName => "foo");
# etc.

---

🦋 DESCRIPTION 🦋

So what this module does: it's a simple thin-layer straight through to the ZOOM-C functions in the YAZ toolkit, for Z39.50 and SRW/U communication. and like… that's it. that's the layer. it's thin. it's real thin. 😭

And now the part where I'm gonna be so fr with you: you should not be using this very nasty, low-level API. nope. absolutely not. no cap. 🙈

You should be using the ZOOM module instead 💖 which implements a nice, Perlish API on top of this module, conformant to the ZOOM Abstract API described at http://zoom.z3950.org/api/. like… that one. that's the one you want. she's the moment. 👑

To enforce the don't-use-this-module prohibition, I am not even going to document it. 💀 (the author said that, not me, but honestly? respect.)

If you really, really, really want to use this anyway — bestie, why — then it pretty much follows the API described in the ZOOM-C documentation at http://www.indexdata.com/yaz/doc/zoom.html. iykyk. ✨

The only additional (non-ZOOM-C) function provided by this module is event_str(), which takes as its argument an event code such as Net::Z3950::ZOOM::EVENT_SEND_APDU, and returns a corresponding short string. cute, right? that's the little bonus. 🎀

---

🌈 SEE ALSO 🌈

• The ZOOM module, included in the same distribution as this one. (go there. live there. thrive there. 🌸)

---

💜 AUTHOR 💜

Mike Taylor, <mike@indexdata.com> 🫶

---

👑 COPYRIGHT AND LICENCE 👑

Copyright (C) 2005-2017 by Index Data.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available. slay, licence-wise. ⭐

---

and that's the whole page, bestie — written up for perl v5.42.3, dated 2026-08-19, from the User Contributed Perl Documentation for Net::Z3950::ZOOM(3pm). now go use the ZOOM module instead, mwah 💖🧚💅