+The only additional (non-ZOOM-C) function provided by this module is
+C<event_str()>, which takes as its argument an event code such as
+C<Net::Z3950::ZOOM::EVENT_SEND_APDU>, and returns a corresponding
+short string.
+
+=cut
+
+sub event_str {
+ my($code) = @_;
+
+ if ($code == EVENT_NONE) {
+ return "none";
+ } elsif ($code == EVENT_CONNECT) {
+ return "connect";
+ } elsif ($code == EVENT_SEND_DATA) {
+ return "send data";
+ } elsif ($code == EVENT_RECV_DATA) {
+ return "receive data";
+ } elsif ($code == EVENT_TIMEOUT) {
+ return "timeout";
+ } elsif ($code == EVENT_UNKNOWN) {
+ return "unknown";
+ } elsif ($code == EVENT_SEND_APDU) {
+ return "send apdu";
+ } elsif ($code == EVENT_RECV_APDU) {
+ return "receive apdu";
+ } elsif ($code == EVENT_RECV_RECORD) {
+ return "receive record";
+ } elsif ($code == EVENT_RECV_SEARCH) {
+ return "receive search";
+ } elsif ($code == EVENT_END) {
+ return "end";
+ }
+ return "impossible event " . $code;
+}
+
+
+# Switch API variant depending on $type. This works because the
+# get_string() and get_binary() functions have different returns
+# types, one of which is implemented as a NUL-terminated string and
+# the other as a pointer-and-length structure.
+#
+# Some Z39.50 servers, when asked for an OPAC-format record in the
+# case where no circulation information is available, will return a
+# USMARC record rather than an OPAC record containing only a
+# bibliographic part. This non-OPAC records is not recognised by the
+# underlying record_get() code in ZOOM-C, which ends up returning a
+# null pointer. To make life a little less painful when dealing with
+# such servers until ZOOM-C is fixed, this code recognises the
+# wrong-record-syntax case and returns the XML for the bibliographic
+# part anyway.
+#
+sub record_get {
+ my($rec, $type) = @_;
+
+ my $simpletype = $type;
+ $simpletype =~ s/;.*//;
+ if (grep { $type eq $_ } qw(database syntax schema)) {
+ return record_get_string($rec, $type);
+ } else {
+ my $val = record_get_binary($rec, $type);
+ if ($simpletype eq "opac" && !defined $val) {
+ my $newtype = $type;
+ if ($newtype !~ s/.*?;/xml;/) {
+ $newtype = "xml";
+ }
+ $val = record_get_binary($rec, $newtype);
+ $val = ("<opacRecord>\n <bibliographicRecord>\n" . $val .
+ " </bibliographicRecord>\n</opacRecord>");
+
+ }
+ return $val;
+ }
+}
+
+