/usr/share/doc/libyazpp4-doc/zoom.html is in libyazpp4-doc 1.4.1-0ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 3. ZOOM-C++</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="YAZ++ User's Guide and Reference"><link rel="up" href="index.html" title="YAZ++ User's Guide and Reference"><link rel="prev" href="windows.html" title="2. Installation on Windows"><link rel="next" href="zoom-connection.html" title="2. ZOOM::connection"></head><body><link rel="stylesheet" type="text/css" href="common/style1.css"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. ZOOM-C++</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="windows.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="zoom-connection.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter 3. ZOOM-C++"><div class="titlepage"><div><div><h2 class="title"><a name="zoom"></a>Chapter 3. ZOOM-C++</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="zoom.html#zoom-introduction">1. Introduction</a></span></dt><dt><span class="sect1"><a href="zoom-connection.html">2. <code class="literal">ZOOM::connection</code></a></span></dt><dd><dl><dt><span class="sect2"><a href="zoom-connection.html#connection.references">2.1. References</a></span></dt></dl></dd><dt><span class="sect1"><a href="zoom-query.html">3. <code class="literal">ZOOM::query</code> and subclasses</a></span></dt><dd><dl><dt><span class="sect2"><a href="zoom-query.html#ZOOM::prefixQuery">3.1. <code class="literal">ZOOM::prefixQuery</code></a></span></dt><dt><span class="sect2"><a href="zoom-query.html#ZOOM::CCLQuery">3.2. <code class="literal">ZOOM::CCLQuery</code></a></span></dt><dt><span class="sect2"><a href="zoom-query.html#queries.discussion">3.3. Discussion</a></span></dt><dt><span class="sect2"><a href="zoom-query.html#query.references">3.4. References</a></span></dt></dl></dd><dt><span class="sect1"><a href="zoom-resultset.html">4. <code class="literal">ZOOM::resultSet</code></a></span></dt><dd><dl><dt><span class="sect2"><a href="zoom-resultset.html#resultset.references">4.1. References</a></span></dt></dl></dd><dt><span class="sect1"><a href="zoom-record.html">5. <code class="literal">ZOOM::record</code></a></span></dt><dd><dl><dt><span class="sect2"><a href="zoom-record.html#zoom.memory.management">5.1. Memory Management</a></span></dt><dt><span class="sect2"><a href="zoom-record.html#record.references">5.2. References</a></span></dt></dl></dd><dt><span class="sect1"><a href="zoom-exception.html">6. <code class="literal">ZOOM::exception</code> and subclasses</a></span></dt><dd><dl><dt><span class="sect2"><a href="zoom-exception.html#ZOOM::systemException">6.1. <code class="literal">ZOOM::systemException</code></a></span></dt><dt><span class="sect2"><a href="zoom-exception.html#ZOOM::bib1Exception">6.2. <code class="literal">ZOOM::bib1Exception</code></a></span></dt><dt><span class="sect2"><a href="zoom-exception.html#ZOOM::queryException">6.3. <code class="literal">ZOOM::queryException</code></a></span></dt><dt><span class="sect2"><a href="zoom-exception.html#revised-sample">6.4. Revised Sample Program</a></span></dt><dt><span class="sect2"><a href="zoom-exception.html#exception.references">6.5. References</a></span></dt></dl></dd></dl></div><div class="sect1" title="1. Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="zoom-introduction"></a>1. Introduction</h2></div></div></div><p>
<a class="ulink" href="http://zoom.z3950.org/" target="_top">ZOOM</a>
is the emerging standard API for information retrieval programming
using the Z39.50 protocol. ZOOM's
<a class="ulink" href="http://zoom.z3950.org/api/" target="_top">Abstract API</a>
specifies semantics for classes representing key IR concepts such as
connections, queries, result sets and records; and there are various
<a class="ulink" href="http://zoom.z3950.org/bindings/" target="_top">bindings</a>
specifying how those concepts should be represented in various
programming languages.
</p><p>
The YAZ++ library includes an implementation of the <a class="ulink" href="http://zoom.z3950.org/bind/cplusplus/" target="_top">C++ binding</a>
for ZOOM, enabling quick, easy development of client applications.
</p><p>
For example, here is a tiny Z39.50 client that fetches and displays
the MARC record for Farlow & Brett Surman's
<em class="citetitle">The Complete Dinosaur</em>
from the Library of Congress's Z39.50 server:
</p><pre class="programlisting">
#include <iostream>
#include <yazpp/zoom.h>
using namespace ZOOM;
int main(int argc, char **argv)
{
connection conn("z3950.loc.gov", 7090);
conn.option("databaseName", "Voyager");
conn.option("preferredRecordSyntax", "USMARC");
resultSet rs(conn, prefixQuery("@attr 1=7 0253333490"));
const record *rec = rs.getRecord(0);
cout << rec->render() << endl;
}
</pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
For the sake of simplicity, this program does not check
for errors: we show a more robust version of the same program
<a class="link" href="zoom-exception.html#revised-sample" title="6.4. Revised Sample Program">later</a>.)
</p></div><p>
YAZ++'s implementation of the C++ binding is a thin layer over YAZ's
implementation of the C binding. For information on the supported
options and other such details, see the ZOOM-C documentation, which
can be found on-line at
<a class="ulink" href="http://www.indexdata.com/yaz/doc/zoom.html" target="_top">http://www.indexdata.com/yaz/doc/zoom.html</a>
</p><p>
All of the classes defined by ZOOM-C++ are in the
<code class="literal">ZOOM</code> namespace. We will now consider
the five main classes in turn:
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
<code class="literal">connection</code>
</p></li><li class="listitem"><p>
<code class="literal">query</code> and its subclasses
<code class="literal">prefixQuery</code> and
<code class="literal">CCLQuery</code>
</p></li><li class="listitem"><p>
<code class="literal">resultSet</code>
</p></li><li class="listitem"><p>
<code class="literal">record</code>
</p></li><li class="listitem"><p>
<code class="literal">exception</code> and its subclasses
<code class="literal">systemException</code>,
<code class="literal">bib1Exception</code> and
<code class="literal">queryException</code>
</p></li></ul></div><p>
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="windows.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="zoom-connection.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">2. Installation on Windows </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> 2. <code class="literal">ZOOM::connection</code></td></tr></table></div></body></html>
|