odbc_data_source(): fix refpurpose and return values, and add example

git-svn-id: https://svn.php.net/repository/phpdoc/ja/trunk@350622 c90b9560-bf6c-de11-be94-00142212c4b1

Author: Yoshinari Takaoka

reference/uodbc/functions/odbc-data-source.xml

@@ -1,10 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1248359f65f6d21492d8959df4dbe7df2c0f3053 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 7990427082721b073c3b64967d945f71746b0b60 Maintainer: takagi Status: ready -->
+<!-- Credits: mumumu -->
 <refentry xml:id="function.odbc-data-source" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>odbc_data_source</refname>
-  <refpurpose>現在の接続についての情報を返す</refpurpose>
+  <refpurpose>利用可能なDSNについての情報を返す</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;
@@ -47,8 +48,43 @@
   &reftitle.returnvalues;
   <para>
    エラー時には &false;、成功時には配列を返します。
+   最後の利用可能なDSNを取得した後は、&null; を返します。
   </para>
  </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="odbc-data-source.example.basic">
+   <title>利用可能なDSNの一覧を表示する</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$conn = odbc_connect('dsn', 'user', 'pass');
+$dsn_info = odbc_data_source($conn, SQL_FETCH_FIRST);
+while ($dsn_info) {
+    print_r($dsn_info);
+    $dsn_info = odbc_data_source($conn, SQL_FETCH_NEXT);
+}
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+Array
+(
+    [server] => dsn
+    [description] => ODBC Driver 17 for SQL Server
+)
+Array
+(
+    [server] => other_dsn
+    [description] => Microsoft Access Driver (*.mdb, *.accdb)
+)]]>
+   </screen>
+  </example>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file