cvs: phpdoc /kr/functions yaz.xml
| From: | Jungmin Song | Date: | Thu, 11 Jan 2001 14:05:42 +0000 |
| Subject: | cvs: phpdoc /kr/functions yaz.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333564@lists.php.net to get a copy of this message | ||
karoora Thu Jan 11 06:05:42 2001 EDT
Modified files:
/phpdoc/kr/functions yaz.xml
Log:
translation 90
Index: phpdoc/kr/functions/yaz.xml diff -u phpdoc/kr/functions/yaz.xml:1.1 phpdoc/kr/functions/yaz.xml:1.2 --- phpdoc/kr/functions/yaz.xml:1.1 Tue Jan 9 17:05:48 2001 +++ phpdoc/kr/functions/yaz.xml Thu Jan 11 06:05:42 2001 @@ -1,40 +1,27 @@ - <reference id="ref.yaz"> - <title>YAZ functions</title> - <titleabbrev>YAZ</titleabbrev> - <partintro> - <sect1 id="yaz.intro"> - <title>Introduction</title> - <para> - This extension offers a PHP interface to the - <productname>YAZ</productname> toolkit that implements the Z39.50 - protocol for information retrieval. With this extension you can easily - implement a Z39.50 origin (client) that searches Z39.50 targets - (servers) in parallel. +<reference id="ref.yaz"> + <title>YAZ functions</title> + <titleabbrev>YAZ</titleabbrev> + <partintro> + <sect1 id="yaz.intro"> + <title>Introduction</title> + <para> + ì´ ìµì¤í ì ì ì ë³´ê²ìì ìí Z39.50 íë¡í ì½ì ì¬ì©íë<productname>YAZ</productname>í´í·ì PHP ì¸í°íì´ì¤ë¥¼ ì ê³µíë¤. ì´ ìµì¤í ì ì Z39.50 origin(client)ìê² ì½ê² Z39.50 targets (servers)ì ë³ë ¬ ê²ìí ì ìë ë구를 ì ê³µíë¤. </para> - <para> - <productname>YAZ</productname> is available at <ulink - url="&url.yaz;">&url.yaz;</ulink>. You can find news information, - example scripts, etc. for this extension at <ulink - url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>. + <para> + <productname>YAZ</productname>ë <ulink url="&url.yaz;">&url.yaz;</ulink>ì ë§ëë³¼ ì ìë¤. ë´ì¤, ìì ì¤í¬ë¦½í¸, ë±ë± ì´ ìµì¤í ì ì <ulink url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>ì¬ê¸°ì 구í ì ìë¤. </para> - <para> - The module hides most of the complexity of Z39.50 so it should be - fairly easy to use. It supports persistent stateless connections very - similar to those offered by the various SQL APIs that are available - for PHP. This means that sessions are stateless but shared amongst - users, thus saving the connect and initialize phase steps in most cases. + <para> + ì´ ëª¨ëì Z39.50ì ë³µì¡ì±ì ëë¶ë¶ ê°ì¶ì´ì ¸ ìì´ì ë§¤ì° ì¬ì©í기 ì½ë¤. ì´ê²ì PHPê° ì´ì©í ì ìë ë¤ìí SQL APIsì ë§¤ì° ì ì¬í persistent stateless connections ì ì ê³µíë¤. ì´ê²ì ì¸ì ë¤ì´ stateless íì§ë§ ì¬ì©ìë¤ìê² ë¶ë°°ëë¤ë ê²ì ì미íë¤. ê²°êµ. ëë¶ë¶ì ê²½ì° ì°ê²°ì ì ì¥ëê³ ìíì ì§íì ì´ê¸°í ëë¤. </para> - </sect1> - <sect1 id="yaz.install"> - <title>Installation</title> - <para> - Compile YAZ and install it. Build PHP with your favourite - modules and add option --with-yaz. Your task is roughly the - following: + </sect1> + <sect1 id="yaz.install"> + <title>ì¤ì¹</title> + <para> + YAZ를 ì»´íì¼ íê³ ì¤ì¹ë¥¼ íë¤. PHP를 íìí 모ëê³¼ ë¹ë í ë --with-yaz ìµì ì ì¶ê°íë¤. ìì ì ëê° ë¤ìê³¼ ê°ë¤.: </para> - <para> - <informalexample> - <programlisting> + <para> + <informalexample> + <programlisting> gunzip -c yaz-1.6.tar.gz|tar xf - gunzip -c php-4.0.X.tar.gz|tar xf - cd yaz-1.6 @@ -46,26 +33,24 @@ make make install </programlisting> - </informalexample> + </informalexample> + </para> + </sect1> + <sect1 id="yaz.example"> + <title>Example</title> + <para> + PHP/YAZë targets(Z-Associations)ì ì°ê²°ì ì ì§íë¤. positive integerë ID of a + particular를 ëíë¸ë¤. </para> - </sect1> - <sect1 id="yaz.example"> - <title>Example</title> - <para> - PHP/YAZ keeps track of connections with targets - (Z-Associations). A positive integer represents the ID of a - particular association. - </para> - <para> - The script below demonstrates the parallel searching feature of - the API. When invoked with no arguments it prints a query form; else - (arguments are supplied) it searches the targets as given in in array - host. - </para> - <para> - <example> - <title><function>YAZ</function></title> - <programlisting role="php"> + <para> + ìëì ìì ì¤í¬ë¦½í¸ë APIì parallel searchingì ë³´ì¬ì¤ë¤. ë 립ë³ì ì ì ë¶ë¬ë¼ë query formì ì¶ë ¥íê³ ê·¸ë ì§ ììê²½ì°(ë 립ë³ìê° ì£¼ì´ì§ë) 주ì´ì§ ë°°ì´ìì targetsì ì°¾ìë¸ë¤ + </para> + <para> + <example> + <title> + <function>YAZ</function> + </title> + <programlisting role="php"> $num_hosts = count ($host); if (empty($term) || count($host) == 0) { echo '<form method="get"> @@ -112,342 +97,334 @@ } } </programlisting> - </example> - </para> - </sect1> - </partintro> - - <refentry id="function.yaz-addinfo"> - <refnamediv> - <refname>yaz_addinfo</refname> - <refpurpose>Returns additional error information</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_addinfo</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns additional error message for target (last request). An - empty string is returned if last operation was a success or if no - additional information was provided by the target. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-close"> - <refnamediv> - <refname>yaz_close</refname> - <refpurpose>Closes a YAZ connection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_close</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Closes a connection to a target. The application can no longer - refer to the target with the given ID. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-connect"> - <refnamediv> - <refname>yaz_connect</refname> - <refpurpose> - Returns a positive association ID on success; zero on failure + </example> + </para> + </sect1> + </partintro> + <refentry id="function.yaz-addinfo"> + <refnamediv> + <refname>yaz_addinfo</refname> + <refpurpose>ì¶ê°ì ì¸ error ì 보를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_addinfo</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + ë¶ê°ì ì¸ target (ë§ì§ë§ ìì²í)ì ê´í ì 보를 리í´íë¤. ë§ì¼ ë§ì§ë§ ìì ì´ ì±ê³µì ì¼ë¡ ì´ë£¨ì´ì§ê±°ë targetì´ ì ê³µíë ì¶ê°ì ë³´ê° ìë ê²½ì° ê³µë°±ë¬¸ì(A empty string)를 리í´íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-close"> + <refnamediv> + <refname>yaz_close</refname> + <refpurpose>YAZì ì°ê²°ì ë«ëë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_close</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + targetê³¼ì ì°ê²°ì ë«ëë¤. applicationì 주ì´ì§ IDë¡ targetì ì¡°íí ì ìë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-connect"> + <refnamediv> + <refname>yaz_connect</refname> + <refpurpose> + ì±ê³µí ê²½ì° ìì association ID를 리í´íë¤ : ì¤í¨ì ê²½ì° "0"ì ë¦¬í´ </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_connect</function></funcdef> - <paramdef>string <parameter>zurl</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>Yaz_connect</function> prepares for a connection to a - Z39.50 target. The zurl argument takes the form - host[:port][/database]. If port is omitted 210 is used. If - database is omitted Default is used. This function is - non-blocking and doesn't attempt to establish a socket - it - merely prepares a connect to be performed later when - <function>yaz_wait</function> is called. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-errno"> - <refnamediv> - <refname>yaz_errno</refname> - <refpurpose>Returns error number</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_errno</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns error for target (last request). A positive value is - returned if the target returned a diagnostic code; a value of - zero is returned if no errors occurred (success); negative value - is returned for other errors targets didn't indicate the error in - question. - </para> - <para> - <function>Yaz_errno</function> should be called after network - activity for each target - (after <function>yaz_wait</function> - returns) to determine the success or failure of the last - operation (e.g. search). - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-error"> - <refnamediv> - <refname>yaz_error</refname> - <refpurpose>Returns error description</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_error</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns error message for target (last request). An empty string - is returned if last operation was a success. - </para> - <para> - <function>Yaz_error</function> returns a english message - corresponding to the last error number as returned by - <function>yaz_errno</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-hits"> - <refnamediv> - <refname>yaz_hits</refname> - <refpurpose>Returns number of hits for last search</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_hits</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>Yaz_hits</function> returns number of hits for last - search. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-range"> - <refnamediv> - <refname>yaz_range</refname> - <refpurpose> - Specifies the maximum number of records to retrieve + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_connect</function> + </funcdef> + <paramdef>string <parameter>zurl</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Yaz_connect</function>ì Z39.50 targetê³¼ì ì°ê²°ì ì¤ë¹íë¤. zurl ë³ìë host[:port][/database]íí를 ì·¨íë¤. + ë§ì¼ portê° ì£¼ì´ì§ì§ ìì¼ë©´ "210"ì´ ì¬ì©ëê³ , databaseê° ì£¼ì´ì§ì§ ìì¼ë©´ "Default"를 ì¬ì©íë¤. non-blockingí¨ìì´ê³ , socketì ë§ë¤ë ¤ê³ ìëíì§ ìëë¤. + - ì´ê²ì ë¨ì§ ë§ì§ë§ì¼ë¡ <function>yaz_wait</function>ê° í¸ì¶ëììë ìíë ì°ê²°ì ì¤ë¹íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-errno"> + <refnamediv> + <refname>yaz_errno</refname> + <refpurpose>error number를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_errno</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + target (last request)ì ê´í errorì 리í´íë¤. targetì´ ì§ë¨ì½ë(diagnostic code)를 리í´í ê²½ì° ìì ê°ì; ì±ê³µíì¬ ìë¬ê° ìë ê²½ì°ë "0"ì ê°ì; ìì²ì ëí ìë¬ë¥¼ ëíë´ì§ 못íë ê²½ì° ìì ê°ì 리í´íë¤. + </para> + <para> + <function>Yaz_errno</function>ì ë§ì§ë§ ìì ì´ success/failureê° ê²°ì ë targetì ëí ë¤í¸ìí¬ê° íì±í(<function>yaz_wait</function>ë¼ ë¦¬í´ë íì) ë ë¤ìì í¸ì¶ëì´ì¼ íë¤. (ì. search) + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-error"> + <refnamediv> + <refname>yaz_error</refname> + <refpurpose>errorë´ì©ì 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_error</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + target (ë§ì§ë§ ìì²í)ì error ë©ì¸ì§ë¥¼ 리í´íë¤. ë§ì§ë§ íí ìì ì´ ì±ê³µì ì¸ ê²½ì° ê³µë°±ë¬¸ì(empty string)ì 리í´íë¤. + </para> + <para> + <function>Yaz_error</function>ë <function>yaz_errno</function>ì ìí´ ë¦¬í°ë ë§ì§ë§ ìë¬ë²í¸ì ì¼ì¹íë ì문 ë©ì¸ì§ë¥¼ 리í´íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-hits"> + <refnamediv> + <refname>yaz_hits</refname> + <refpurpose>ë§ì§ë§ ê²ìì ëí íí¸ì를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_hits</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Yaz_hits</function> ë§ì§ë§ ê²ìì ëí íí¸ì를 리í´íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-range"> + <refnamediv> + <refname>yaz_range</refname> + <refpurpose> + ê²ì결과를 ëíë¼ ë²ì를 ì§ì íë¤. </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_range</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>int <parameter>start</parameter></paramdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - This function is used in conjunction with - <function>yaz_search</function> to specify the maximum number of - records to retrieve (number) and the first record position - (start). If this function is not invoked (only - <function>yaz_search</function>) start is set to 1 and number is - set to 10. - </para> - <para> - Returns true on success; false on error. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-record"> - <refnamediv> - <refname>yaz_record</refname> - <refpurpose>Returns a record</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_record</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>int <parameter>pos</parameter></paramdef> - <paramdef>string <parameter>type</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns record at position or empty string if no record exists at - given position. - </para> - <para> - The <function>yaz_record</function> function inspects a record in - the current result set at the position specified. If no database - record exists at the given position an empty string is - returned. The argument, type, specifies the form of the returned - record. If type is "string" the record is returned in a string - representation suitable for printing (for XML and SUTRS). If type - is "array" the record is returned as an array representation (for - structured records). - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-search"> - <refnamediv> - <refname>yaz_search</refname> - <refpurpose>Prepares for a search</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_search</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>string <parameter>type</parameter></paramdef> - <paramdef>string <parameter>query</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yaz_search</function> prepares for a search on the - target with given id. The type represents the query type - only - "rpn" is supported now in which case the third argument specifies - a Type-1 query (RPN). Like <function>yaz_connect</function> this - function is non-blocking and only prepares for a search to be - executed later when <function>yaz_wait</function> is called. - </para> - </refsect1> - <refsect1> - <title>The RPN query</title> - <para> - The RPN query is a textual represenation of the Type-1 query as - defined by the Z39.50 standard. However, in the text representation + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_range</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>int <parameter>start</parameter> + </paramdef> + <paramdef>int <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + ì´ í¨ìë <function>yaz_search</function>ì ì¡°í©íì¬ ìììì¹(start)ì ê²ìë´ì© ì¤ ëì´í ìµëê°(number)ì ëíë´ëë° ì´ì©ëë¤. startì ëí´í¸ ê°ì "1"ì´ê³ , numberì ëí´í¸ ê°ì "10"ì´ë¤.( ë¨ì§ <function>yaz_search</function>ë§ì´ ìëê²½ì°) + </para> + <para> + ì±ê³µíë©´ true를 : ìë¬ê° ë ê²½ì°ë false 를 ë°ííë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-record"> + <refnamediv> + <refname>yaz_record</refname> + <refpurpose>ë ì½ë를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_record</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>int <parameter>pos</parameter> + </paramdef> + <paramdef>string <parameter>type</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 주ì´ì§ í¬ì§ì ì ë ì½ëê° ìëê²½ì° ê³µë°±ë¬¸ì를 ë°ííê³ , ìëê²½ì° ë ì½ë를 ë°ííë¤. + </para> + <para> + <function>yaz_record</function>ë ì§ì ë ìì¹ì result setììì ë ì½ë를 ì ê²íë¤. ë§ì¼ 주ì´ì§ ìì¹ìì database record ì¡´ì¬íì§ ìì¼ë©´ 공백문ì를 리í´íë¤. ë³ìë 리í´ë ë ì½ëì type를 ì§ì íë¤. ë§ì¼ "string"ì´ ì£¼ì´ì§ë©´ ë ì½ëë (XMLê³¼ SUTRS)ì¶ë ¥ì ì í©í 문ìë¡ ë¦¬í´ëë¤. ë§ì¼ "array"ë¡ ì§ì íë©´ (structured recordsìí) ë°°ì´ë¡ 리í´ëë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-search"> + <refnamediv> + <refname>yaz_search</refname> + <refpurpose>ê²ìì ì¤ë¹íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_search</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>string <parameter>type</parameter> + </paramdef> + <paramdef>string <parameter>query</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>yaz_search</function>ì 주ì´ì§ IDë¡ targetì ê²ìì ì¤ë¹íë¤. typeì 쿼리 íì ì ëíë¸ë¤.-ì¸ë²ì§¸ ë³ìë¡ ì§ì ë Type-1 query (RPN)ì¸ ê²½ì° ë¨ì§ "rpn"ë§ì ì§ìíë¤. <function>yaz_connect</function>ì²ë¼ non-blocking ì´ê³ <function>yaz_wait</function>ì´ í¸ì¶ë ì´íì ê²ìì ì¤ë¹íë¤. + </para> + </refsect1> + <refsect1> + <title>The RPN query</title> + <para> + The RPN query is a textual represenation of the Type-1 query as defined by the Z39.50 standard. However, in the text representation as used by YAZ a prefix notation is used, that is the operater precedes the operands. The query string is a sequence of tokens where white space is ignored is ignored unless surrounded by double quotes. Tokens beginning with an at-character (<literal>@</literal>) are considered operators, otherwise they are treated as search terms. </para> - <table> - <title>RPN Operators</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Syntax</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>@and query1 query2</literal></entry> - <entry>intersection of query1 and query2</entry> - </row> - <row> - <entry><literal>@or query1 query2</literal></entry> - <entry>union of query1 and query2</entry> - </row> - <row> - <entry><literal>@not query1 query2</literal></entry> - <entry>query1 and not query2</entry> - </row> - <row> - <entry><literal>@set name</literal></entry> - <entry>result set reference</entry> - </row> - <row> - <entry><literal>@attrset set query</literal></entry> - <entry>specifies attribute-set for query. This construction is only + <table> + <title>RPN Operators</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Syntax</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>@and query1 query2</literal> + </entry> + <entry>intersection of query1 and query2</entry> + </row> + <row> + <entry> + <literal>@or query1 query2</literal> + </entry> + <entry>union of query1 and query2</entry> + </row> + <row> + <entry> + <literal>@not query1 query2</literal> + </entry> + <entry>query1 and not query2</entry> + </row> + <row> + <entry> + <literal>@set name</literal> + </entry> + <entry>result set reference</entry> + </row> + <row> + <entry> + <literal>@attrset set query</literal> + </entry> + <entry>specifies attribute-set for query. This construction is only allowed once - in the beginning of the whole query</entry> - </row> - <row> - <entry><literal>@attr set type=value query</literal></entry> - <entry>applies attribute to query. The type and value are + </row> + <row> + <entry> + <literal>@attr set type=value query</literal> + </entry> + <entry>applies attribute to query. The type and value are integers specifying the attribute-type and attribute-value respectively. The set, if given, specifies the attribute-set.</entry> - </row> - </tbody> - </tgroup> - </table> - <para> + </row> + </tbody> + </tgroup> + </table> + <para> The following illustrates valid query constructions: <informalexample> - <screen>computer</screen> - </informalexample> + <screen>computer</screen> + </informalexample> Matches documents where "computer" occur. No attributes are specified. </para> - <para> - <informalexample> - <screen>"donald knuth"</screen> - </informalexample> + <para> + <informalexample> + <screen>"donald knuth"</screen> + </informalexample> Matches documents where "donald knuth" occur. </para> - <para> - <informalexample> - <screen>@attr 1=4 art</screen> - </informalexample> + <para> + <informalexample> + <screen>@attr 1=4 art</screen> + </informalexample> Attribute type is 1 (Bib-1 use), attribute value is 4 Title), so this should match documents where "art" occur in the title. </para> - <para> - <informalexample> -<screen>@attrset gils @and @attr 1=4 art @attr 1=1003 "donald knuth"</screen> - </informalexample> + <para> + <informalexample> + <screen>@attrset gils @and @attr 1=4 art @attr 1=1003 "donald knuth"</screen> + </informalexample> The query as a whole uses the GILS attributeset. The query matches documents where "art" occur in the title and in which "donald knuth" occur in the author. </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-syntax"> - <refnamediv> - <refname>yaz_syntax</refname> - <refpurpose> + </refsect1> + </refentry> + <refentry id="function.yaz-syntax"> + <refnamediv> + <refname>yaz_syntax</refname> + <refpurpose> Specifies the object identifier (OID) for the preferred record syntax for retrieval. </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_syntax</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>string <parameter>syntax</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_syntax</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>string <parameter>syntax</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> The syntax may be specified in a raw dot-notation (like <literal>1.2.840.10003.5.10</literal>) or as one of the known record syntaxes (sutrs, usmarc, grs1, xml, etc.). @@ -455,24 +432,26 @@ <function>yaz_search</function> to specify the preferred record syntax for retrieval. </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-wait"> - <refnamediv> - <refname>yaz_wait</refname> - <refpurpose>Executes queries</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_wait</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>string <parameter>syntax</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> + </refsect1> + </refentry> + <refentry id="function.yaz-wait"> + <refnamediv> + <refname>yaz_wait</refname> + <refpurpose>Executes queries</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_wait</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>string <parameter>syntax</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> This function carries out networked (blocked) activity for outstanding requests which have been prepared by the functions <function>yaz_connect</function>, @@ -480,11 +459,9 @@ returns when all targets have either completed all requests or otherwise completed (in case of errors). </para> - </refsect1> - </refentry> - - </reference> - + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml
Index: phpdoc/kr/functions/yaz.xml diff -u phpdoc/kr/functions/yaz.xml:1.1 phpdoc/kr/functions/yaz.xml:1.2 --- phpdoc/kr/functions/yaz.xml:1.1 Tue Jan 9 17:05:48 2001 +++ phpdoc/kr/functions/yaz.xml Thu Jan 11 06:05:42 2001 @@ -1,40 +1,27 @@ - <reference id="ref.yaz"> - <title>YAZ functions</title> - <titleabbrev>YAZ</titleabbrev> - <partintro> - <sect1 id="yaz.intro"> - <title>Introduction</title> - <para> - This extension offers a PHP interface to the - <productname>YAZ</productname> toolkit that implements the Z39.50 - protocol for information retrieval. With this extension you can easily - implement a Z39.50 origin (client) that searches Z39.50 targets - (servers) in parallel. +<reference id="ref.yaz"> + <title>YAZ functions</title> + <titleabbrev>YAZ</titleabbrev> + <partintro> + <sect1 id="yaz.intro"> + <title>Introduction</title> + <para> + ì´ ìµì¤í ì ì ì ë³´ê²ìì ìí Z39.50 íë¡í ì½ì ì¬ì©íë<productname>YAZ</productname>í´í·ì PHP ì¸í°íì´ì¤ë¥¼ ì ê³µíë¤. ì´ ìµì¤í ì ì Z39.50 origin(client)ìê² ì½ê² Z39.50 targets (servers)ì ë³ë ¬ ê²ìí ì ìë ë구를 ì ê³µíë¤. </para> - <para> - <productname>YAZ</productname> is available at <ulink - url="&url.yaz;">&url.yaz;</ulink>. You can find news information, - example scripts, etc. for this extension at <ulink - url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>. + <para> + <productname>YAZ</productname>ë <ulink url="&url.yaz;">&url.yaz;</ulink>ì ë§ëë³¼ ì ìë¤. ë´ì¤, ìì ì¤í¬ë¦½í¸, ë±ë± ì´ ìµì¤í ì ì <ulink url="&url.yaz-phpyaz;">&url.yaz-phpyaz;</ulink>ì¬ê¸°ì 구í ì ìë¤. </para> - <para> - The module hides most of the complexity of Z39.50 so it should be - fairly easy to use. It supports persistent stateless connections very - similar to those offered by the various SQL APIs that are available - for PHP. This means that sessions are stateless but shared amongst - users, thus saving the connect and initialize phase steps in most cases. + <para> + ì´ ëª¨ëì Z39.50ì ë³µì¡ì±ì ëë¶ë¶ ê°ì¶ì´ì ¸ ìì´ì ë§¤ì° ì¬ì©í기 ì½ë¤. ì´ê²ì PHPê° ì´ì©í ì ìë ë¤ìí SQL APIsì ë§¤ì° ì ì¬í persistent stateless connections ì ì ê³µíë¤. ì´ê²ì ì¸ì ë¤ì´ stateless íì§ë§ ì¬ì©ìë¤ìê² ë¶ë°°ëë¤ë ê²ì ì미íë¤. ê²°êµ. ëë¶ë¶ì ê²½ì° ì°ê²°ì ì ì¥ëê³ ìíì ì§íì ì´ê¸°í ëë¤. </para> - </sect1> - <sect1 id="yaz.install"> - <title>Installation</title> - <para> - Compile YAZ and install it. Build PHP with your favourite - modules and add option --with-yaz. Your task is roughly the - following: + </sect1> + <sect1 id="yaz.install"> + <title>ì¤ì¹</title> + <para> + YAZ를 ì»´íì¼ íê³ ì¤ì¹ë¥¼ íë¤. PHP를 íìí 모ëê³¼ ë¹ë í ë --with-yaz ìµì ì ì¶ê°íë¤. ìì ì ëê° ë¤ìê³¼ ê°ë¤.: </para> - <para> - <informalexample> - <programlisting> + <para> + <informalexample> + <programlisting> gunzip -c yaz-1.6.tar.gz|tar xf - gunzip -c php-4.0.X.tar.gz|tar xf - cd yaz-1.6 @@ -46,26 +33,24 @@ make make install </programlisting> - </informalexample> + </informalexample> + </para> + </sect1> + <sect1 id="yaz.example"> + <title>Example</title> + <para> + PHP/YAZë targets(Z-Associations)ì ì°ê²°ì ì ì§íë¤. positive integerë ID of a + particular를 ëíë¸ë¤. </para> - </sect1> - <sect1 id="yaz.example"> - <title>Example</title> - <para> - PHP/YAZ keeps track of connections with targets - (Z-Associations). A positive integer represents the ID of a - particular association. - </para> - <para> - The script below demonstrates the parallel searching feature of - the API. When invoked with no arguments it prints a query form; else - (arguments are supplied) it searches the targets as given in in array - host. - </para> - <para> - <example> - <title><function>YAZ</function></title> - <programlisting role="php"> + <para> + ìëì ìì ì¤í¬ë¦½í¸ë APIì parallel searchingì ë³´ì¬ì¤ë¤. ë 립ë³ì ì ì ë¶ë¬ë¼ë query formì ì¶ë ¥íê³ ê·¸ë ì§ ììê²½ì°(ë 립ë³ìê° ì£¼ì´ì§ë) 주ì´ì§ ë°°ì´ìì targetsì ì°¾ìë¸ë¤ + </para> + <para> + <example> + <title> + <function>YAZ</function> + </title> + <programlisting role="php"> $num_hosts = count ($host); if (empty($term) || count($host) == 0) { echo '<form method="get"> @@ -112,342 +97,334 @@ } } </programlisting> - </example> - </para> - </sect1> - </partintro> - - <refentry id="function.yaz-addinfo"> - <refnamediv> - <refname>yaz_addinfo</refname> - <refpurpose>Returns additional error information</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_addinfo</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns additional error message for target (last request). An - empty string is returned if last operation was a success or if no - additional information was provided by the target. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-close"> - <refnamediv> - <refname>yaz_close</refname> - <refpurpose>Closes a YAZ connection</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_close</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Closes a connection to a target. The application can no longer - refer to the target with the given ID. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-connect"> - <refnamediv> - <refname>yaz_connect</refname> - <refpurpose> - Returns a positive association ID on success; zero on failure + </example> + </para> + </sect1> + </partintro> + <refentry id="function.yaz-addinfo"> + <refnamediv> + <refname>yaz_addinfo</refname> + <refpurpose>ì¶ê°ì ì¸ error ì 보를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_addinfo</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + ë¶ê°ì ì¸ target (ë§ì§ë§ ìì²í)ì ê´í ì 보를 리í´íë¤. ë§ì¼ ë§ì§ë§ ìì ì´ ì±ê³µì ì¼ë¡ ì´ë£¨ì´ì§ê±°ë targetì´ ì ê³µíë ì¶ê°ì ë³´ê° ìë ê²½ì° ê³µë°±ë¬¸ì(A empty string)를 리í´íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-close"> + <refnamediv> + <refname>yaz_close</refname> + <refpurpose>YAZì ì°ê²°ì ë«ëë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_close</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + targetê³¼ì ì°ê²°ì ë«ëë¤. applicationì 주ì´ì§ IDë¡ targetì ì¡°íí ì ìë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-connect"> + <refnamediv> + <refname>yaz_connect</refname> + <refpurpose> + ì±ê³µí ê²½ì° ìì association ID를 리í´íë¤ : ì¤í¨ì ê²½ì° "0"ì ë¦¬í´ </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_connect</function></funcdef> - <paramdef>string <parameter>zurl</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>Yaz_connect</function> prepares for a connection to a - Z39.50 target. The zurl argument takes the form - host[:port][/database]. If port is omitted 210 is used. If - database is omitted Default is used. This function is - non-blocking and doesn't attempt to establish a socket - it - merely prepares a connect to be performed later when - <function>yaz_wait</function> is called. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-errno"> - <refnamediv> - <refname>yaz_errno</refname> - <refpurpose>Returns error number</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_errno</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns error for target (last request). A positive value is - returned if the target returned a diagnostic code; a value of - zero is returned if no errors occurred (success); negative value - is returned for other errors targets didn't indicate the error in - question. - </para> - <para> - <function>Yaz_errno</function> should be called after network - activity for each target - (after <function>yaz_wait</function> - returns) to determine the success or failure of the last - operation (e.g. search). - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-error"> - <refnamediv> - <refname>yaz_error</refname> - <refpurpose>Returns error description</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_error</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns error message for target (last request). An empty string - is returned if last operation was a success. - </para> - <para> - <function>Yaz_error</function> returns a english message - corresponding to the last error number as returned by - <function>yaz_errno</function>. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-hits"> - <refnamediv> - <refname>yaz_hits</refname> - <refpurpose>Returns number of hits for last search</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_hits</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>Yaz_hits</function> returns number of hits for last - search. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-range"> - <refnamediv> - <refname>yaz_range</refname> - <refpurpose> - Specifies the maximum number of records to retrieve + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_connect</function> + </funcdef> + <paramdef>string <parameter>zurl</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Yaz_connect</function>ì Z39.50 targetê³¼ì ì°ê²°ì ì¤ë¹íë¤. zurl ë³ìë host[:port][/database]íí를 ì·¨íë¤. + ë§ì¼ portê° ì£¼ì´ì§ì§ ìì¼ë©´ "210"ì´ ì¬ì©ëê³ , databaseê° ì£¼ì´ì§ì§ ìì¼ë©´ "Default"를 ì¬ì©íë¤. non-blockingí¨ìì´ê³ , socketì ë§ë¤ë ¤ê³ ìëíì§ ìëë¤. + - ì´ê²ì ë¨ì§ ë§ì§ë§ì¼ë¡ <function>yaz_wait</function>ê° í¸ì¶ëììë ìíë ì°ê²°ì ì¤ë¹íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-errno"> + <refnamediv> + <refname>yaz_errno</refname> + <refpurpose>error number를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_errno</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + target (last request)ì ê´í errorì 리í´íë¤. targetì´ ì§ë¨ì½ë(diagnostic code)를 리í´í ê²½ì° ìì ê°ì; ì±ê³µíì¬ ìë¬ê° ìë ê²½ì°ë "0"ì ê°ì; ìì²ì ëí ìë¬ë¥¼ ëíë´ì§ 못íë ê²½ì° ìì ê°ì 리í´íë¤. + </para> + <para> + <function>Yaz_errno</function>ì ë§ì§ë§ ìì ì´ success/failureê° ê²°ì ë targetì ëí ë¤í¸ìí¬ê° íì±í(<function>yaz_wait</function>ë¼ ë¦¬í´ë íì) ë ë¤ìì í¸ì¶ëì´ì¼ íë¤. (ì. search) + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-error"> + <refnamediv> + <refname>yaz_error</refname> + <refpurpose>errorë´ì©ì 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_error</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + target (ë§ì§ë§ ìì²í)ì error ë©ì¸ì§ë¥¼ 리í´íë¤. ë§ì§ë§ íí ìì ì´ ì±ê³µì ì¸ ê²½ì° ê³µë°±ë¬¸ì(empty string)ì 리í´íë¤. + </para> + <para> + <function>Yaz_error</function>ë <function>yaz_errno</function>ì ìí´ ë¦¬í°ë ë§ì§ë§ ìë¬ë²í¸ì ì¼ì¹íë ì문 ë©ì¸ì§ë¥¼ 리í´íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-hits"> + <refnamediv> + <refname>yaz_hits</refname> + <refpurpose>ë§ì§ë§ ê²ìì ëí íí¸ì를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_hits</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>Yaz_hits</function> ë§ì§ë§ ê²ìì ëí íí¸ì를 리í´íë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-range"> + <refnamediv> + <refname>yaz_range</refname> + <refpurpose> + ê²ì결과를 ëíë¼ ë²ì를 ì§ì íë¤. </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_range</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>int <parameter>start</parameter></paramdef> - <paramdef>int <parameter>number</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - This function is used in conjunction with - <function>yaz_search</function> to specify the maximum number of - records to retrieve (number) and the first record position - (start). If this function is not invoked (only - <function>yaz_search</function>) start is set to 1 and number is - set to 10. - </para> - <para> - Returns true on success; false on error. - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-record"> - <refnamediv> - <refname>yaz_record</refname> - <refpurpose>Returns a record</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_record</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>int <parameter>pos</parameter></paramdef> - <paramdef>string <parameter>type</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - Returns record at position or empty string if no record exists at - given position. - </para> - <para> - The <function>yaz_record</function> function inspects a record in - the current result set at the position specified. If no database - record exists at the given position an empty string is - returned. The argument, type, specifies the form of the returned - record. If type is "string" the record is returned in a string - representation suitable for printing (for XML and SUTRS). If type - is "array" the record is returned as an array representation (for - structured records). - </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-search"> - <refnamediv> - <refname>yaz_search</refname> - <refpurpose>Prepares for a search</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_search</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>string <parameter>type</parameter></paramdef> - <paramdef>string <parameter>query</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> - <function>yaz_search</function> prepares for a search on the - target with given id. The type represents the query type - only - "rpn" is supported now in which case the third argument specifies - a Type-1 query (RPN). Like <function>yaz_connect</function> this - function is non-blocking and only prepares for a search to be - executed later when <function>yaz_wait</function> is called. - </para> - </refsect1> - <refsect1> - <title>The RPN query</title> - <para> - The RPN query is a textual represenation of the Type-1 query as - defined by the Z39.50 standard. However, in the text representation + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_range</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>int <parameter>start</parameter> + </paramdef> + <paramdef>int <parameter>number</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + ì´ í¨ìë <function>yaz_search</function>ì ì¡°í©íì¬ ìììì¹(start)ì ê²ìë´ì© ì¤ ëì´í ìµëê°(number)ì ëíë´ëë° ì´ì©ëë¤. startì ëí´í¸ ê°ì "1"ì´ê³ , numberì ëí´í¸ ê°ì "10"ì´ë¤.( ë¨ì§ <function>yaz_search</function>ë§ì´ ìëê²½ì°) + </para> + <para> + ì±ê³µíë©´ true를 : ìë¬ê° ë ê²½ì°ë false 를 ë°ííë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-record"> + <refnamediv> + <refname>yaz_record</refname> + <refpurpose>ë ì½ë를 리í´íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_record</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>int <parameter>pos</parameter> + </paramdef> + <paramdef>string <parameter>type</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + 주ì´ì§ í¬ì§ì ì ë ì½ëê° ìëê²½ì° ê³µë°±ë¬¸ì를 ë°ííê³ , ìëê²½ì° ë ì½ë를 ë°ííë¤. + </para> + <para> + <function>yaz_record</function>ë ì§ì ë ìì¹ì result setììì ë ì½ë를 ì ê²íë¤. ë§ì¼ 주ì´ì§ ìì¹ìì database record ì¡´ì¬íì§ ìì¼ë©´ 공백문ì를 리í´íë¤. ë³ìë 리í´ë ë ì½ëì type를 ì§ì íë¤. ë§ì¼ "string"ì´ ì£¼ì´ì§ë©´ ë ì½ëë (XMLê³¼ SUTRS)ì¶ë ¥ì ì í©í 문ìë¡ ë¦¬í´ëë¤. ë§ì¼ "array"ë¡ ì§ì íë©´ (structured recordsìí) ë°°ì´ë¡ 리í´ëë¤. + </para> + </refsect1> + </refentry> + <refentry id="function.yaz-search"> + <refnamediv> + <refname>yaz_search</refname> + <refpurpose>ê²ìì ì¤ë¹íë¤.</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_search</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>string <parameter>type</parameter> + </paramdef> + <paramdef>string <parameter>query</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> + <function>yaz_search</function>ì 주ì´ì§ IDë¡ targetì ê²ìì ì¤ë¹íë¤. typeì 쿼리 íì ì ëíë¸ë¤.-ì¸ë²ì§¸ ë³ìë¡ ì§ì ë Type-1 query (RPN)ì¸ ê²½ì° ë¨ì§ "rpn"ë§ì ì§ìíë¤. <function>yaz_connect</function>ì²ë¼ non-blocking ì´ê³ <function>yaz_wait</function>ì´ í¸ì¶ë ì´íì ê²ìì ì¤ë¹íë¤. + </para> + </refsect1> + <refsect1> + <title>The RPN query</title> + <para> + The RPN query is a textual represenation of the Type-1 query as defined by the Z39.50 standard. However, in the text representation as used by YAZ a prefix notation is used, that is the operater precedes the operands. The query string is a sequence of tokens where white space is ignored is ignored unless surrounded by double quotes. Tokens beginning with an at-character (<literal>@</literal>) are considered operators, otherwise they are treated as search terms. </para> - <table> - <title>RPN Operators</title> - <tgroup cols="2"> - <thead> - <row> - <entry>Syntax</entry> - <entry>Description</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>@and query1 query2</literal></entry> - <entry>intersection of query1 and query2</entry> - </row> - <row> - <entry><literal>@or query1 query2</literal></entry> - <entry>union of query1 and query2</entry> - </row> - <row> - <entry><literal>@not query1 query2</literal></entry> - <entry>query1 and not query2</entry> - </row> - <row> - <entry><literal>@set name</literal></entry> - <entry>result set reference</entry> - </row> - <row> - <entry><literal>@attrset set query</literal></entry> - <entry>specifies attribute-set for query. This construction is only + <table> + <title>RPN Operators</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Syntax</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry> + <literal>@and query1 query2</literal> + </entry> + <entry>intersection of query1 and query2</entry> + </row> + <row> + <entry> + <literal>@or query1 query2</literal> + </entry> + <entry>union of query1 and query2</entry> + </row> + <row> + <entry> + <literal>@not query1 query2</literal> + </entry> + <entry>query1 and not query2</entry> + </row> + <row> + <entry> + <literal>@set name</literal> + </entry> + <entry>result set reference</entry> + </row> + <row> + <entry> + <literal>@attrset set query</literal> + </entry> + <entry>specifies attribute-set for query. This construction is only allowed once - in the beginning of the whole query</entry> - </row> - <row> - <entry><literal>@attr set type=value query</literal></entry> - <entry>applies attribute to query. The type and value are + </row> + <row> + <entry> + <literal>@attr set type=value query</literal> + </entry> + <entry>applies attribute to query. The type and value are integers specifying the attribute-type and attribute-value respectively. The set, if given, specifies the attribute-set.</entry> - </row> - </tbody> - </tgroup> - </table> - <para> + </row> + </tbody> + </tgroup> + </table> + <para> The following illustrates valid query constructions: <informalexample> - <screen>computer</screen> - </informalexample> + <screen>computer</screen> + </informalexample> Matches documents where "computer" occur. No attributes are specified. </para> - <para> - <informalexample> - <screen>"donald knuth"</screen> - </informalexample> + <para> + <informalexample> + <screen>"donald knuth"</screen> + </informalexample> Matches documents where "donald knuth" occur. </para> - <para> - <informalexample> - <screen>@attr 1=4 art</screen> - </informalexample> + <para> + <informalexample> + <screen>@attr 1=4 art</screen> + </informalexample> Attribute type is 1 (Bib-1 use), attribute value is 4 Title), so this should match documents where "art" occur in the title. </para> - <para> - <informalexample> -<screen>@attrset gils @and @attr 1=4 art @attr 1=1003 "donald knuth"</screen> - </informalexample> + <para> + <informalexample> + <screen>@attrset gils @and @attr 1=4 art @attr 1=1003 "donald knuth"</screen> + </informalexample> The query as a whole uses the GILS attributeset. The query matches documents where "art" occur in the title and in which "donald knuth" occur in the author. </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-syntax"> - <refnamediv> - <refname>yaz_syntax</refname> - <refpurpose> + </refsect1> + </refentry> + <refentry id="function.yaz-syntax"> + <refnamediv> + <refname>yaz_syntax</refname> + <refpurpose> Specifies the object identifier (OID) for the preferred record syntax for retrieval. </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_syntax</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>string <parameter>syntax</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_syntax</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>string <parameter>syntax</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> The syntax may be specified in a raw dot-notation (like <literal>1.2.840.10003.5.10</literal>) or as one of the known record syntaxes (sutrs, usmarc, grs1, xml, etc.). @@ -455,24 +432,26 @@ <function>yaz_search</function> to specify the preferred record syntax for retrieval. </para> - </refsect1> - </refentry> - - <refentry id="function.yaz-wait"> - <refnamediv> - <refname>yaz_wait</refname> - <refpurpose>Executes queries</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <funcsynopsis> - <funcprototype> - <funcdef>int <function>yaz_wait</function></funcdef> - <paramdef>int <parameter>id</parameter></paramdef> - <paramdef>string <parameter>syntax</parameter></paramdef> - </funcprototype> - </funcsynopsis> - <para> + </refsect1> + </refentry> + <refentry id="function.yaz-wait"> + <refnamediv> + <refname>yaz_wait</refname> + <refpurpose>Executes queries</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <funcsynopsis> + <funcprototype> + <funcdef>int <function>yaz_wait</function> + </funcdef> + <paramdef>int <parameter>id</parameter> + </paramdef> + <paramdef>string <parameter>syntax</parameter> + </paramdef> + </funcprototype> + </funcsynopsis> + <para> This function carries out networked (blocked) activity for outstanding requests which have been prepared by the functions <function>yaz_connect</function>, @@ -480,11 +459,9 @@ returns when all targets have either completed all requests or otherwise completed (in case of errors). </para> - </refsect1> - </refentry> - - </reference> - + </refsect1> + </refentry> +</reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml