cvs: phpdoc-ja /reference/dbase configure.xml reference.xml /reference/dbase/functions dbase-add-record.xml dbase-close.xml dbase-create.xml
dbase-delete-record.xml dbase-get-header-info.xml dbase-get-record-with-names.xml dbase-get-record.xml dbase-numfields.xml dbase-numrecords.xml
dbase-open.xml dbase-pack.xml dbase-replace-record.xml

From: Date: Wed, 17 Aug 2005 04:14:27 +0000
Subject: cvs: phpdoc-ja /reference/dbase configure.xml reference.xml /reference/dbase/functions dbase-add-record.xml dbase-close.xml dbase-create.xml
dbase-delete-record.xml dbase-get-header-info.xml dbase-get-record-with-names.xml dbase-get-record.xml dbase-numfields.xml dbase-numrecords.xml
dbase-open.xml dbase-pack.xml dbase-replace-record.xml
Groups: php.doc.ja 
Request: Send a blank email to doc-ja+get-1132@lists.php.net to get a copy of this message
takagi Wed Aug 17 00:14:27 2005 EDT Added files: /phpdoc-ja/reference/dbase/functions dbase-get-header-info.xml Modified files: /phpdoc-ja/reference/dbase/functions dbase-replace-record.xml dbase-pack.xml dbase-open.xml dbase-numrecords.xml dbase-numfields.xml dbase-get-record.xml dbase-get-record-with-names.xml dbase-delete-record.xml dbase-create.xml dbase-close.xml dbase-add-record.xml /phpdoc-ja/reference/dbase reference.xml configure.xml Log: sync with en.

http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-replace-record.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-replace-record.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-replace-record.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-replace-record.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-replace-record.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-replace-record.xml Wed Aug 17 00:14:26 2005 @@ -1,32 +1,117 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-replace-record"> - <refnamediv> - <refname>dbase_replace_record</refname> - <refpurpose>dBase データベースのレコードを置換する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_replace_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - <methodparam><type>int</type><parameter>dbase_record_number</parameter></methodparam> - </methodsynopsis> - <simpara> - データベースのレコード<parameter>record_number</parameter>が指す - データを<parameter>record</parameter>のデータで置換します。指定し - たレコードの項目数がデータベースのフィールド数に等しくない場合、 - 操作は失敗し、&false;が返されます。 - </simpara> - <simpara> - <parameter>dbase_record_number</parameter> は1からデータベースの - レコード数までの範囲の整数となります。 - (<function>dbase_numrecords</function>により返されます) - </simpara> - </refsect1> - </refentry> +<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-replace-record"> + <refnamediv> + <refname>dbase_replace_record</refname> + <refpurpose>データベースのレコードを置換する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_replace_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>array</type><parameter>record</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + データベースの指定したレコードを、指定した値で置換します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record</parameter></term> + <listitem> + <para> + データの配列。要素の数がデータベースのフィールド数と一致している + 必要があります。それ以外の場合は<function>dbase_replace_record</function> + は失敗します。 + </para> + <note> + <para> + <function>dbase_get_record</function> が返す値をこのパラメータに + 使用する際は、<literal>deleted</literal> という名前のキーを + リセットすることを忘れないでください。 + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + 1 からデータベース内のレコード数 + (<function>dbase_numrecords</function> が返す) + までの範囲の整数値。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>データベースのレコードの更新</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// read-write モードでオープンする +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + // 変更前の行を取得する + $row = dbase_get_record_with_names($db, 1); + + // 'deleted' エントリを削除する + unset($row['deleted']); + + // 現在のタイムスタンプでフィールドを更新する + $row['date'] = date('Ymd'); + + // レコードを置換する + dbase_replace_record($db, $row, 1); + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_add_record</function></member> + <member><function>dbase_delete_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-pack.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-pack.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-pack.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-pack.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-pack.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-pack.xml Wed Aug 17 00:14:26 2005 @@ -1,24 +1,82 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-pack"> - <refnamediv> - <refname>dbase_pack</refname> - <refpurpose>dBase データベースをパックする</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_pack</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - 指定されたデータベースをパックします。 - (<function>dbase_delete_record</function> を用いて削除指定を行っ - た全てのレコードの削除を実際に行います。) - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-pack"> + <refnamediv> + <refname>dbase_pack</refname> + <refpurpose>データベースを圧縮する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_pack</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + <function>dbase_delete_record</function> を使用して削除マークがつけられた + レコードを完全に削除することで、指定したデータベースを圧縮します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>dBase データベースを空にする</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// read-write モードでオープンする +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + $record_numbers = dbase_numrecords($db); + for ($i = 1; $i <= $record_numbers; $i++) { + dbase_delete_record($db, $i); + } + // データベースを消す + dbase_pack($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-open.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-open.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-open.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-open.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-open.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-open.xml Wed Aug 17 00:14:26 2005 @@ -1,29 +1,100 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-open"> - <refnamediv> - <refname>dbase_open</refname> - <refpurpose>dBase データベースをオープンする</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>int</type><methodname>dbase_open</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <para> - フラグは、open() システムコールにおけるフラグに対応します。 - (通常、0 は読込のみ可、1 は書込のみ可、2 は読み書きを意味します) - </para> - <para> - オープンされたデータベースの dbase ID を返します。 - データベースをオープンできなかった場合は、&false; を返します。 - </para> - &note.sm.uidcheck; - </refsect1> - </refentry> +<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-open"> + <refnamediv> + <refname>dbase_open</refname> + <refpurpose>データベースをオープンする</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_open</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>int</type><parameter>mode</parameter></methodparam> + </methodsynopsis> + <para> + <function>dbase_open</function> は、指定したアクセスモードで + dBase データベースをオープンします。 + </para> + &note.sm.uidcheck; + &note.open-basedir.func; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + データベースの名前。dBase がデータを格納するファイルの + 相対パスあるいは絶対パス。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + open() システムコールに対応する整数値(通常、0 は読み込みのみ可・ + 1 は書き込みのみ可・2 は読み書き両方可を意味します)。 + </para> + <note> + <para> + dBase ファイルを write-only モードでオープンしようとすると、 + ヘッダ情報を読み込むことができないために関数は失敗します。 + つまり、<parameter>mode</parameter> に 1 を指定することはできません。 + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>dBase データベースファイルのオープン</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// read-only モードでオープンする +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + // データを読み込む .. + + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + データベースのオープンに成功した場合にリンク ID 、エラーが発生した場合に + &false; を返します。 + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_create</function></member> + <member><function>dbase_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-numrecords.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-numrecords.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-numrecords.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-numrecords.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-numrecords.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-numrecords.xml Wed Aug 17 00:14:26 2005 @@ -1,26 +1,86 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-numrecords"> - <refnamediv> - <refname>dbase_numrecords</refname> - <refpurpose> - dBase データベースにおけるレコード数を返す - </refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>int</type><methodname>dbase_numrecords</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - 指定したデータベースにレコード(行)数を返します。レコード番号は 1 - から dbase_numrecords($db) まで、フィールド番号は 0 から - dbase_numfields($db)-1 までです。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-numrecords"> + <refnamediv> + <refname>dbase_numrecords</refname> + <refpurpose>データベースのレコード数を得る</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numrecords</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + 指定したデータベースのレコード(行)数を取得します。 + </para> + <note> + <para> + レコード番号は 1 から dbase_numrecords($db) までで、 + 一方フィールド番号は 0 から dbase_numfields($db)-1 までです。 + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + データベースのレコード数を返します。エラーが発生した場合には + &false; を返します。 + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>データベースの全レコードをループする</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// read-only モードでオープンする +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + $record_numbers = dbase_numrecords($db); + for ($i = 1; $i <= $record_numbers; $i++) { + // 各レコードに対して、ここで何かをする + } +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_num_fields</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-numfields.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-numfields.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-numfields.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-numfields.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-numfields.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-numfields.xml Wed Aug 17 00:14:26 2005 @@ -1,38 +1,82 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-numfields"> - <refnamediv> - <refname>dbase_numfields</refname> - <refpurpose> - dBase データベースにおけるフィールド数を返す - </refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>int</type><methodname>dbase_numfields</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - 指定したデータベースにおけるフィールド(カラム)数を返します。フィー - ルド番号は 0 から dbase_numfields($db)-1 まで、レコード番号は 1 - から dbase_numrecords($db) までです。 - <example> - <title><function>dbase_numfields</function> の使用法</title> - <programlisting> +<!-- EN-Revision: 1.8 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-numfields"> + <refnamediv> + <refname>dbase_numfields</refname> + <refpurpose>データベースのフィールド数を得る</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_numfields</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + 指定したデータベースにおけるフィールド(カラム)数を取得します。 + </para> + <note> + <para> + フィールド番号は 0 から dbase_numfields($db)-1 までで、 + 一方レコード番号は 1 から dbase_numrecords($db) までです。 + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + データベースのフィールド数を返します。エラーが発生した場合には + &false; を返します。 + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>dbase_numfields</function> の例</title> + <programlisting role="php"> <![CDATA[ +<?php + $rec = dbase_get_record($db, $recno); $nf = dbase_numfields($db); -for ($i=0; $i < $nf; $i++) { - print $rec[$i]."<br>\n"; +for ($i = 0; $i < $nf; $i++) { + echo $rec[$i], "\n"; } + +?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_numrecords</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-get-record.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-get-record.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-get-record.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-get-record.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-get-record.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-get-record.xml Wed Aug 17 00:14:26 2005 @@ -1,43 +1,88 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-get-record"> - <refnamediv> - <refname>dbase_get_record</refname> - <refpurpose>dBase データベースからレコードを得る</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>array</type><methodname>dbase_get_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>record</parameter> からのデータが配列に返されます。配 - 列の添字は 0から始まり、連想配列のメンバー 'deleted' を含んでいま - す。これには、そのレコードに削除指定が行われている場合に 1 がセッ - トされます。(<function>dbase_delete_record</function> も参照下さ - い。) - </para> - <para> - 各フィールドは、適当な PHP 型に変換されます。 - <itemizedlist> - <listitem> - <simpara> - 日付は、文字列のままとなります。 - </simpara> - </listitem> - <listitem> - <simpara> - 整数は、オーバーフロー(>32ビット)を起こす可能性がある整数が文 - 字列として返します。 - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-get-record"> + <refnamediv> + <refname>dbase_get_record</refname> + <refpurpose> + データベースからレコードを配列形式で得る + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + データベースから、レコードを配列形式で取得します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + レコードのインデックス。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + レコードの連想配列を返します。これには <literal>deleted</literal> + という名前のキーも含まれており、もしレコードに削除マークがつけられている + 場合にはその値が 1 となります + (<function>dbase_delete_record</function> を参照ください)。 + </para> + <para> + 各フィールドは、適切な PHP の型に変換されます。ただし以下の例外を除きます。 + <itemizedlist> + <listitem> + <simpara> + 日付は文字列のままとなります。 + </simpara> + </listitem> + <listitem> + <simpara> + オーバーフローを発生するような整数(&gt; 32 ビット)は、 + 文字列として返されます。 + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + エラー時には <function>dbase_get_record</function> + は &false; を返します。 + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record_with_names</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-get-record-with-names.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-get-record-with-names.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-get-record-with-names.xml:1.4 phpdoc-ja/reference/dbase/functions/dbase-get-record-with-names.xml:1.5 --- phpdoc-ja/reference/dbase/functions/dbase-get-record-with-names.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dbase/functions/dbase-get-record-with-names.xml Wed Aug 17 00:14:26 2005 @@ -1,44 +1,114 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-get-record-with-names"> - <refnamediv> - <refname>dbase_get_record_with_names</refname> - <refpurpose> - dBaseデータベースからレコードを連想配列として得る - </refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>array</type><methodname>dbase_get_record_with_names</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>record</parameter> からデータを連想配列として返します。 - 配列は、レコードに削除のマークが付けられている場合は、連想配列に - メンバー'deleted'が付加され、その値は1となります。 - (<function>dbase_delete_record</function>を参照ください。) - </para> - <para> - 各フィールドは以下の例外を除き表示適当なPHP型に変換されます。 - <itemizedlist> - <listitem> - <simpara> - 日付は文字列のままとなります。 - </simpara> - </listitem> - <listitem> - <simpara> - オーバーフローを発生するような整数(>32ビット)は、文字列として - 返されます。 - </simpara> - </listitem> - </itemizedlist> - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-get-record-with-names"> + <refnamediv> + <refname>dbase_get_record_with_names</refname> + <refpurpose> + データベースからレコードを連想配列として得る + </refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>array</type><methodname>dbase_get_record_with_names</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + dBase データベースから、レコードを連想配列として取得します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + レコードのインデックス。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + レコードの連想配列を返します。これには <literal>deleted</literal> + という名前のキーも含まれており、もしレコードに削除マークがつけられている + 場合にはその値が 1 となります + (<function>dbase_delete_record</function> を参照ください)。 + </para> + <para> + 各フィールドは、適切な PHP の型に変換されます。ただし以下の例外を除きます。 + <itemizedlist> + <listitem> + <simpara> + 日付は文字列のままとなります。 + </simpara> + </listitem> + <listitem> + <simpara> + オーバーフローを発生するような整数(&gt; 32 ビット)は、 + 文字列として返されます。 + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + エラー時には <function>dbase_get_record_with_names</function> + は &false; を返します。 + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>データベースに登録されているメンバの一覧表示</title> + <programlisting role="php"> +<![CDATA[ +<?php +// read-only モードでオープンする +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + $record_numbers = dbase_numrecords($db); + for ($i = 1; $i <= $record_numbers; $i++) { + $row = dbase_get_record_with_names($db, $i); + if ($row['ismember'] == 1) { + echo "Member #$i: " . trim($row['name']) . "\n"; + } + } +} +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_get_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-delete-record.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-delete-record.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-delete-record.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-delete-record.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-delete-record.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-delete-record.xml Wed Aug 17 00:14:26 2005 @@ -1,25 +1,72 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-delete-record"> - <refnamediv> - <refname>dbase_delete_record</refname> - <refpurpose>dBase データベースからレコードを削除する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_delete_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>int</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - データベースから削除したいレコード <parameter>record</parameter> - をマークします。実際に削除を行うには、 - <function>dbase_pack</function> をコールする必要があります。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-delete-record"> + <refnamediv> + <refname>dbase_delete_record</refname> + <refpurpose>データベースからレコードを削除する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_delete_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>int</type><parameter>record_number</parameter></methodparam> + </methodsynopsis> + <para> + データベースから削除したいレコードをマークします。 + </para> + <note> + <para> + 実際にデータベースからレコードを削除するには、 + <function>dbase_pack</function> もコールする必要があります。 + </para> + </note> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record_number</parameter></term> + <listitem> + <para> + 1 からデータベース内のレコード数 + (<function>dbase_numrecords</function> が返す) + までの範囲の整数値。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_add_record</function></member> + <member><function>dbase_replace_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-create.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-create.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-create.xml:1.4 phpdoc-ja/reference/dbase/functions/dbase-create.xml:1.5 --- phpdoc-ja/reference/dbase/functions/dbase-create.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dbase/functions/dbase-create.xml Wed Aug 17 00:14:26 2005 @@ -1,99 +1,104 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-create"> - <refnamediv> - <refname>dbase_create</refname> - <refpurpose>dBase データベースを作成する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>int</type><methodname>dbase_create</methodname> - <methodparam><type>string</type><parameter>filename</parameter></methodparam> - <methodparam><type>array</type><parameter>fields</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>fields</parameter> パラメータは、配列の配列です。各配 - 列は、データベースにおける一つのフィールドのフォーマットを記述し - ます。各フィールドは、名前、フィールド型、長さ、精度を示す文字か - ら構成されます。 - </para> - <para> - 利用可能なフィールド型は次のようになります。 - <variablelist> - <varlistentry> - <term>L</term> - <listitem> - <simpara> - 論理値。長さも精度もありません。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>M</term> - <listitem> - <simpara> - メモ。(PHP ではサポートされないことに注意してください。) - 長さも精度もありません。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>D</term> - <listitem> - <simpara> - 日付(Date) (YYYYMMDD という形式で保持されます)。 - 長さも精度もありません。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>N</term> - <listitem> - <simpara> - 番号(Number)。長さおよび精度(小数点以下の桁数)を有します。 - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term>C</term> - <listitem> - <simpara> - 文字列。 - </simpara> - </listitem> - </varlistentry> - </variablelist></para> - <para> - データベースの作成に成功した場合、dbase ID が返されます。失敗した - 場合は、&false; が返されます。 - <example> - <title>dBaseデータベースファイルを作成する</title> - <programlisting role="php"> +<!-- EN-Revision: 1.12 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-create"> + <refnamediv> + <refname>dbase_create</refname> + <refpurpose>データベースを作成する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>int</type><methodname>dbase_create</methodname> + <methodparam><type>string</type><parameter>filename</parameter></methodparam> + <methodparam><type>array</type><parameter>fields</parameter></methodparam> + </methodsynopsis> + <para> + <function>dbase_create</function> は、指定された定義で + dBase データベースを作成します。 + </para> + &note.sm.uidcheck; + &note.open-basedir.func; + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>filename</parameter></term> + <listitem> + <para> + データベースの名前。dBase がデータを格納するファイルの + 相対パスあるいは絶対パス。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>fields</parameter></term> + <listitem> + <para> + 配列の配列で、各配列はデータベースにおけるひとつのフィールドの + フォーマットを記述します。各フィールドは、名前・フィールド型を + 示す文字・長さ(オプション)・精度(オプション)から構成されます。 + </para> + <note> + <para> + フィールド名の長さは、10 文字までに制限されています。 + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + データベースの作成に成功した場合にリンク ID 、エラーが発生した場合に + &false; を返します。 + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>dBase データベースファイルの作成</title> + <programlisting role="php"> <![CDATA[ -// データベース名 -$dbname = "/tmp/test.dbf"; - +<?php + // データベースの定義 -$def = - array( - array("date", "D"), - array("name", "C", 50), - array("age", "N", 3, 0), - array("email", "C", 128), - array("ismember", "L") - ); - +$def = array( + array("date", "D"), + array("name", "C", 50), + array("age", "N", 3, 0), + array("email", "C", 128), + array("ismember", "L") +); + // 作成 -if (!dbase_create($dbname, $def)) - print "<strong>Error!</strong>"; +if (!dbase_create('/tmp/test.dbf', $def)) { + echo "Error, can't create the database\n"; +} + +?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-close.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-close.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-close.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-close.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-close.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-close.xml Wed Aug 17 00:14:26 2005 @@ -1,23 +1,79 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-close"> - <refnamediv> - <refname>dbase_close</refname> - <refpurpose>dBase データベースを閉じる</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_close</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>dbase_identifier</parameter>が指すデータベースを閉じま - す。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-close"> + <refnamediv> + <refname>dbase_close</refname> + <refpurpose>データベースを閉じる</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_close</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + </methodsynopsis> + <para> + 指定されたデータベースリンク ID を閉じます。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>dBase データベースファイルを閉じる</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// read-only モードでオープンする +$db = dbase_open('/tmp/test.dbf', 0); + +if ($db) { + // データを読む .. + + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_open</function></member> + <member><function>dbase_create</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/functions/dbase-add-record.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/dbase/functions/dbase-add-record.xml diff -u phpdoc-ja/reference/dbase/functions/dbase-add-record.xml:1.3 phpdoc-ja/reference/dbase/functions/dbase-add-record.xml:1.4 --- phpdoc-ja/reference/dbase/functions/dbase-add-record.xml:1.3 Mon Nov 22 23:45:31 2004 +++ phpdoc-ja/reference/dbase/functions/dbase-add-record.xml Wed Aug 17 00:14:26 2005 @@ -1,25 +1,101 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./ja/functions/dbase.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dbase-add-record"> - <refnamediv> - <refname>dbase_add_record</refname> - <refpurpose>dBase データベースにレコードを追加する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dbase_add_record</methodname> - <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> - <methodparam><type>array</type><parameter>record</parameter></methodparam> - </methodsynopsis> - <para> - <parameter>record</parameter> のデータをデータベースに追加します。 - 指定したレコード中の項目数が、データベース中のフィールド数と等し - くない場合、処理は失敗し、&false; が返されます。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dbase-add-record"> + <refnamediv> + <refname>dbase_add_record</refname> + <refpurpose>データベースにレコードを追加する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dbase_add_record</methodname> + <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> + <methodparam><type>array</type><parameter>record</parameter></methodparam> + </methodsynopsis> + <para> + 与えられたデータをデータベースに追加します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>dbase_identifier</parameter></term> + <listitem> + <para> + データベースのリンク ID 。<function>dbase_open</function> + あるいは <function>dbase_create</function> によって返されます。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>record</parameter></term> + <listitem> + <para> + データの配列。要素の数がデータベースのフィールド数と一致している + 必要があります。それ以外の場合は<function>dbase_add_record</function> + は失敗します。 + </para> + <note> + <para> + <function>dbase_get_record</function> が返す値をこのパラメータに + 使用する際は、<literal>deleted</literal> という名前のキーを + リセットすることを忘れないでください。 + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>dBase データベースにレコードを追加する</title> + <programlisting role="php"> +<![CDATA[ +<?php + +// read-write モードでオープンする +$db = dbase_open('/tmp/test.dbf', 2); + +if ($db) { + dbase_add_record($db, array( + date('Ymd'), + 'Maxim Topolov', + '23', + 'max@example.com', + 'T')); + dbase_close($db); +} + +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dbase_delete_record</function></member> + <member><function>dbase_replace_record</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/reference.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dbase/reference.xml diff -u phpdoc-ja/reference/dbase/reference.xml:1.4 phpdoc-ja/reference/dbase/reference.xml:1.5 --- phpdoc-ja/reference/dbase/reference.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dbase/reference.xml Wed Aug 17 00:14:26 2005 @@ -1,37 +1,99 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <reference id="ref.dbase"> - <title>dBase 関数</title> + <title>dBase Functions</title> <titleabbrev>dBase</titleabbrev> <partintro> <section id="dbase.intro"> &reftitle.intro; <para> - これらの関数は、dBase 形式(dbf)のデータベースに保存されたレコード - にアクセスすることを可能にします。 + これらの関数は、dBase 形式(dbf) のデータベースに保存されたレコードに + アクセスすることを可能にします。 </para> <para> - これらの関数では、インデックスおよびメモフィールドのサポートは行わ - れません。ロックのサポートも行われません。二つの Web サーバープロ - セスが同時に同じ dBase ファイルを修正しようとした場合、データベー - スはほぼ確実に駄目になってしまうでしょう。 + dBase ファイルは、固定長の単純なシーケンシャルファイルです。 + レコードはファイルの終りに追加され、削除されたレコードは + <function>dbase_pack</function> がコールされるまで保持されます。 </para> <para> - dBaseファイルは、固定長の単純なシーケンシャルファイルです。レコー - ドは、ファイルの終りに追加され、削除されたレコードは - <function>dbase_pack</function>がコールされるまで保持されます。 - </para> - <para> - 商用データベースとして dBase ファイルを使用するべきではありません。 - 本物の SQL サーバーを替わりに選んでください。通常、MySQL または - Postgresが PHP で使用されています。dBase ファイルフォーマットは - Windows の表計算ソフトや統合ソフトで通常サポートされているので、 - dBase サポートにより Web データベースとのデータのインポート/エクス - ポートが可能となります。 + dBase フィールドの型として有効なものは以下のとおりです。 + <table> + <title>有効なフィールド型</title> + <tgroup cols="3"> + <thead> + <row> + <entry>フィールド</entry> + <entry>dBase 型</entry> + <entry>フォーマット</entry> + <entry>補足情報</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>M</literal></entry> + <entry>Memo</entry> + <entry>n/a</entry> + <entry> + この型は PHP ではサポートされていません。 + このフィールドは無視されます。 + </entry> + </row> + <row> + <entry><literal>D</literal></entry> + <entry>Date</entry> + <entry><literal>YYYYMMDD</literal></entry> + <entry>フィールドの最大長は 8 です。</entry> + </row> + <row> + <entry><literal>N</literal></entry> + <entry>Number</entry> + <entry>数字</entry> + <entry> + 長さと精度(小数点以下の桁数)を指定する必要があります。 + </entry> + </row> + <row> + <entry><literal>C</literal></entry> + <entry>String</entry> + <entry>文字列</entry> + <entry> + 長さを指定する必要があります。データを取得する際、指定した長さに + 満たない文字列にはその右側に空白文字が付加されます。 + </entry> + </row> + <row> + <entry><literal>L</literal></entry> + <entry>Boolean</entry> + <entry><literal>T</literal> あるいは <literal>Y</literal> が &true;、 + <literal>F</literal> あるいは <literal>N</literal> が &false; です。</entry> + <entry>読み書きは整数値(1 または 0)で行われます。</entry> + </row> + </tbody> + </tgroup> + </table> </para> + <warning> + <para> + これらの関数では、インデックスおよびメモフィールドのサポートは + 行われません。ロックのサポートも行われません。ふたつの Web サーバ + プロセスが同時に同じ dBase ファイルを修正しようとした場合、 + データベースはほぼ確実に駄目になってしまうでしょう。 + </para> + <para> + 商用データベースとして dBase ファイルを使用しないことを推奨します。 + 本物の SQL サーバーを替わりに選んでください。通常、<ulink + url="&url.mysql;">MySQL</ulink> または <ulink url="&url.pgsql;"> + Postgres</ulink> PHP で使用されています。dBase サポートの目的は、 + Web データベースのデータのインポート・エクスポートを行うことです。 + なぜなら、Windows の表計算ソフトや統合ソフトでこのフォーマットが + 通常サポートされているからです。 + </para> + </warning> </section> - + &reference.dbase.configure; <section id="dbase.runtime"> @@ -44,6 +106,15 @@ &no.resource; </section> + <section id="dbase.examples"> + &reftitle.examples; + <para> + このリファレンスの例の多くは dBase データベースを必要とします。ここでは + <function>dbase_create</function> の例で作成した + <filename>/tmp/test.dbf</filename> を利用しています。 + </para> + </section> + <section id="dbase.constants"> &reftitle.constants; &no.constants; http://cvs.php.net/diff.php/phpdoc-ja/reference/dbase/configure.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/dbase/configure.xml diff -u phpdoc-ja/reference/dbase/configure.xml:1.1 phpdoc-ja/reference/dbase/configure.xml:1.2 --- phpdoc-ja/reference/dbase/configure.xml:1.1 Sun Dec 1 03:19:37 2002 +++ phpdoc-ja/reference/dbase/configure.xml Wed Aug 17 00:14:26 2005 @@ -1,11 +1,13 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.1 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <section id="dbase.installation"> &reftitle.install; <para> - 付属するdbaseライブラリを有効にし、これらの関数を使用するには、 - <option role="configure">--enable-dbase</option> オプションを指定し - てPHPをコンパイルする必要があります。 + 付属する dbase ライブラリを有効にしてこれらの関数を使用するには、 + <option role="configure">--enable-dbase</option> オプションを + 指定して PHP をコンパイルする必要があります。 </para> </section> http://cvs.php.net/co.php/phpdoc-ja/reference/dbase/functions/dbase-get-header-info.xml?r=1.1&p=1 Index: phpdoc-ja/reference/dbase/functions/dbase-get-header-info.xml +++ phpdoc-ja/reference/dbase/functions/dbase-get-header-info.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.8 Maintainer: takagi Status: ready --> <refentry id="function.dbase-get-header-info"> <refnamediv> <refname>dbase_get_header_info</refname> <refpurpose>データベースのヘッダ情報を得る</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>dbase_get_header_info</methodname> <methodparam><type>int</type><parameter>dbase_identifier</parameter></methodparam> </methodsynopsis> <para> 指定したデータベースリンク ID のカラム構造についての情報を返します。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>dbase_identifier</parameter></term> <listitem> <para> データベースのリンク ID 。<function>dbase_open</function> あるいは <function>dbase_create</function> によって返されます。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> データベースの各カラムについての要素を格納した配列を返します。 配列の添字は 0 から始まります。 </para> <para> 配列の各要素には、以下に述べるような形式の連想配列で カラムの情報が格納されます。 <variablelist> <varlistentry> <term>name</term> <listitem> <simpara> カラム名。 </simpara> </listitem> </varlistentry> <varlistentry> <term>type</term> <listitem> <simpara> カラムのデータ型を可読形式(例: date、boolean など)で格納。 </simpara> </listitem> </varlistentry> <varlistentry> <term>length</term> <listitem> <simpara> カラムのバイト数。 </simpara> </listitem> </varlistentry> <varlistentry> <term>precision</term> <listitem> <simpara> カラムの数値の精度。 </simpara> </listitem> </varlistentry> <varlistentry> <term>format</term> <listitem> <simpara> カラムに対して推奨される <function>printf</function> でのフォーマット指定。 </simpara> </listitem> </varlistentry> <varlistentry> <term>offset</term> <listitem> <simpara> 行の最初からのバイトオフセット。 </simpara> </listitem> </varlistentry> </variablelist> </para> <para> ヘッダ情報が読み込めない場合には &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>dBase データベースファイルの情報の表示</title> <programlisting role="php"> <![CDATA[ <?php // dbase ファイルのパス $db_path = "/tmp/test.dbf"; // dbase ファイルのオープン $dbh = dbase_open($db_path, 0) or die("Error! Could not open dbase database file '$db_path'."); // カラム情報の取得 $column_info = dbase_get_header_info($dbh); // 情報の表示 print_r($column_info); ?> ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
« previous php.doc.ja (#1132) next »