 |
 |
 |
 |
|
|
Date: 10/01/00
- Next message: Rui Hirokawa: "[PHP-DOC] cvs: phpdoc /ja Translators chapters.ent /ja/functions shmop.xml"
- Previous message: Derick Rethans: "[PHP-DOC] cvs: phpdoc / manual.xml.in"
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
hirokawa Sun Oct 1 08:36:45 2000 EDT
Modified files:
/phpdoc/en/functions oci8.xml
/phpdoc/ja/functions ifx.xml ldap.xml mcrypt.xml oci8.xml pcre.xml
session.xml
Log:
update translations aand cosmetic changes.
Index: phpdoc/en/functions/oci8.xml
diff -u phpdoc/en/functions/oci8.xml:1.11 phpdoc/en/functions/oci8.xml:1.12
--- phpdoc/en/functions/oci8.xml:1.11 Sat Sep 30 11:30:12 2000
+++ phpdoc/en/functions/oci8.xml Sun Oct 1 08:36:44 2000
@@ -63,7 +63,7 @@
<?php
// by sergo <email protected>
-// Use option: OCI_DEFAULT for execute command to delay ececution
+// Use option: OCI_DEFAULT for execute command to delay execution
OCIExecute($stmt, OCI_DEFAULT);
// for retrieve data use (after fetch):
Index: phpdoc/ja/functions/ifx.xml
diff -u phpdoc/ja/functions/ifx.xml:1.5 phpdoc/ja/functions/ifx.xml:1.6
--- phpdoc/ja/functions/ifx.xml:1.5 Fri Sep 29 19:01:27 2000
+++ phpdoc/ja/functions/ifx.xml Sun Oct 1 08:36:45 2000
@@ -5,7 +5,6 @@
<partintro>
<para>
- Informix driver for
Informix (IDS) 7.x, SE 7.x, Universal Server (IUS) 9.x ,IDS 2000
用のInformixドライバは、informix拡張機能用ディレクトリの"ifx.ec"
および"php3_ifx.h"に実装されています。
@@ -17,157 +16,161 @@
</para>
<note>
<title>設定に関する注意</title>
- <para>
- PHP Informix ドライバをコンパイルするには、何らかのバージョンのESQL/C
- が必要です。7.2x以降のバージョンに付属するESQL/Cは問題なく使用できます。
- 現在では、ESQL/CはInformixクライアントSDKに含まれています。
- </para>
- <para>
- "configure" スクリプトを実行する前に、必ず"INFORMIXDIR" 変数を設定し、
- PATHに$INFORMIXDIR/bin を設定しておいてください。
- </para>
- <para>
- "configure --with_informix=yes" を実行した場合、
- configure スクリプトは、ライブラリおよびインクルードディレクトリを
- 自動検出します。
- 環境変数 "IFX_LIBDIR", "IFX_LIBS", "IFX_INCDIR" を指定することにより、
- この検出結果を上書きすることが可能です。
- configure スクリプトは、Informix サーバーのバージョンを検出しようと
- もします。
- Informix のバージョンが 9.00 以上である場合、条件コンパイル用変数
- "HAVE_IFX_IUS" が設定されます。
- </para>
+ <para>
+ PHP Informix ドライバをコンパイルするには、何らかのバージョンのESQL/C
+ が必要です。7.2x以降のバージョンに付属するESQL/Cは問題なく使用できます。
+ 現在では、ESQL/CはInformixクライアントSDKに含まれています。
+ </para>
+ <para>
+ "configure" スクリプトを実行する前に、必ず"INFORMIXDIR" 変数を設定し、
+ PATHに$INFORMIXDIR/bin を設定しておいてください。
+ </para>
+ <para>
+ "configure --with_informix=yes" を実行した場合、
+ configure スクリプトは、ライブラリおよびインクルードディレクトリを
+ 自動検出します。
+ 環境変数 "IFX_LIBDIR", "IFX_LIBS", "IFX_INCDIR" を指定することにより、
+ この検出結果を上書きすることが可能です。
+ configure スクリプトは、Informix サーバーのバージョンを検出しようと
+ もします。
+ Informix のバージョンが 9.00 以上である場合、条件コンパイル用変数
+ "HAVE_IFX_IUS" が設定されます。
+ </para>
</note>
<note>
- <title>実行時に考慮すべき点</title>
- <para>
- Informix用環境変数INFORMIXDIRおよびINFORMIXSERVERがPHP ifxドライバ
- で利用可能であり、INFORMIXのバイナリがあるディレクトリにパスが
- 通っていることを確認して下さい。テストを始める前に
- <function>phpinfo()</function>と書いたスクリプトを実行し、
- これを確認して下さい。
- <function>phpinfo()</function> があるスクリプトは、これらの環境変数
- の一覧を出力します。これは、CGI版のPHPおよびApache mod_phpで共に
- 行われます。これらの環境変数はApacheのスタートアップスクリプトで設定
- する必要があります。
- </para>
- <para>
- また、Informix共有ライブラリがローダーで利用可能である必要があります。
- (LD_LINBRARY_PATHまたはld.so.conf/ldconfigを確認して下さい)
- </para>
+ <title>実行時に考慮すべき点</title>
+ <para>
+ Informix用環境変数INFORMIXDIRおよびINFORMIXSERVERがPHP ifxドライバ
+ で利用可能であり、INFORMIXのバイナリがあるディレクトリにパスが
+ 通っていることを確認して下さい。テストを始める前に
+ <function>phpinfo()</function>と書いたスクリプトを実行し、
+ これを確認して下さい。
+ <function>phpinfo()</function> があるスクリプトは、これらの環境変数
+ の一覧を出力します。これは、CGI版のPHPおよびApache mod_phpで共に
+ 行われます。これらの環境変数はApacheのスタートアップスクリプトで設定
+ する必要があります。
+ </para>
+ <para>
+ また、Informix共有ライブラリがローダーで利用可能である必要があります。
+ (LD_LINBRARY_PATHまたはld.so.conf/ldconfigを確認して下さい)
+ </para>
</note>
<note>
<title>BLOB (TEXT および BYTE カラム)の使用に関する注意</title>
- <para>
- 通常、BLOB はBLOB ID により指定されます。
- select クエリーは、BYTE および TEXT カラム毎に "blob id" を返します。
- ( "ifx_blobinfile(0);" により) メモリー上で BLOB を得ることを選択した場合、
- "string_var = ifx_get_blob($blob_id);" で内容を得ることができます。
- ファイルから BLOB カラムの内容を取得したい場合、
- "ifx_blobinfile(1);" を使用して下さい。
- "ifx_get_blob($blob_id);" によりファイル名を得ることができます。
- BLOB の内容を得る際には、通常のファイル入出力を行ってください。
- </para>
- <para>
- insert/update クエリーに関しては、
- "ifx_create_blob(..);" により自分で "blob id" を作成する必要があります。
- その後、blob id を配列に代入し、
- クエリー文字列の中の blob カラムを疑問符 (?) で置換します。
- updates/inserts の場合、ifx_update_blob(...) で blob の内容を設定する
- のが便利でしょう。
- </para>
- <para>
- BLOB カラムの動作は、設定用変数で変更することができます。
- これらの変数は、実行時にも設定可能です。
- </para>
- <para>
- </para>
- <para>
- 設定変数 : ifx.textasvarchar
- </para>
- <para>
- 設定変数 : ifx.byteasvarchar
- </para>
- <para>
- </para>
- <para>
- ランタイム関数 :
- </para>
- <para>
- ifx_textasvarchar(0) : TEXT カラムを有する select クエリーに blob id を使用する
- </para>
- <para>
- ifx_byteasvarchar(0) : BYTE カラムを有する select クエリーに blob id を使用する
- </para>
- <para>
- ifx_textasvarchar(1) : TEXTカラムをVARCHARカラムとして返します。
- このため、selectクエリーにおいてblob idを使用する必要はありません。
- </para>
- <para>
- ifx_byteasvarchar(1) : BYTEカラムをVARCHARカラムとして返します。
- このため、selectクエリーにおいてblob idを使用する必要はありません。
- </para>
- <para>
- </para>
- <para>
- 設定変数 : ifx.blobinfile
- </para>
- <para>
- ランタイム関数 :
- </para>
- <para>
- ifx_blobinfile_mode(0) : メモリーに BYTE カラムを返す, blob id によりその内容を取り出す
- </para>
- <para>
- ifx_blobinfile_mode(1) : メモリーに BYTE カラムを返す, blob id によりそのファイル名を取り出す
- </para>
- <para>
- ifx_text/byteasvarchar を 1 に設定した場合、
- 通常の(しかしやや長い) VARCHAR フィールドのように
- select クエリーで TEXT や BYTE カラムを使用することが可能です。
- 全ての文字列は、PHP で "数えられる" ので、これにより、"バイナリ・セーフ"
- が維持されます。
- これを正しく処理するのはあなた次第です。
- 返されるデータには何でも含むことができますが、その内容について
- 責任を負うことになります。
- </para>
- <para>
- ifx_blobinfile を 1 に設定した場合、blob の内容を得るために
- ifx_get_blob(..) により返されたファイル名を使用して下さい。
- この場合、行を取得する際に Informix により作成されたテンポラリファイル
- を削除する責任があります。
- 取得された新規の行は、BYTE カラム毎に新規のテンポラリファイルを
- 作成します。
- </para>
- <para>
- テンポラリファイルの位置は、環境変数 "blobdir" により
- 設定することができます。
- デフォルトは、"." (カレントディレクトリ)です。
- putenv(blobdir="tmpblob"); のようにすることにより、
- 誤って残ってしまったテンポラリファイルを削除することが容易に
- なります。(テンポラリファイルの名前は "blb" で始まります)
+ <para>
+ 通常、BLOB はBLOB ID により指定されます。
+ select クエリーは、BYTE および TEXT カラム毎に "blob id" を返します。
+ ( "ifx_blobinfile(0);" により) メモリー上で BLOB を得ることを選択した場合、
+ "string_var = ifx_get_blob($blob_id);" で内容を得ることができます。
+ ファイルから BLOB カラムの内容を取得したい場合、
+ "ifx_blobinfile(1);" を使用して下さい。
+ "ifx_get_blob($blob_id);" によりファイル名を得ることができます。
+ BLOB の内容を得る際には、通常のファイル入出力を行ってください。
+ </para>
+ <para>
+ insert/update クエリーに関しては、
+ "ifx_create_blob(..);" により自分で "blob id" を作成する必要があります。
+ その後、blob id を配列に代入し、
+ クエリー文字列の中の blob カラムを疑問符 (?) で置換します。
+ updates/inserts の場合、ifx_update_blob(...) で blob の内容を設定する
+ のが便利でしょう。
+ </para>
+ <para>
+ BLOB カラムの動作は、設定用変数で変更することができます。
+ これらの変数は、実行時にも設定可能です。
+ </para>
+ <para>
+ </para>
+ <para>
+ 設定変数 : ifx.textasvarchar
+ </para>
+ <para>
+ 設定変数 : ifx.byteasvarchar
+ </para>
+ <para>
+ </para>
+ <para>
+ ランタイム関数 :
+ </para>
+ <para>
+ ifx_textasvarchar(0) : TEXT カラムを有する select クエリーに blob
+ id を使用する
+ </para>
+ <para>
+ ifx_byteasvarchar(0) : BYTE カラムを有する select クエリーに blob
+ id を使用する
+ </para>
+ <para>
+ ifx_textasvarchar(1) : TEXTカラムをVARCHARカラムとして返します。
+ このため、selectクエリーにおいてblob idを使用する必要はありません。
+ </para>
+ <para>
+ ifx_byteasvarchar(1) : BYTEカラムをVARCHARカラムとして返します。
+ このため、selectクエリーにおいてblob idを使用する必要はありません。
+ </para>
+ <para>
+ </para>
+ <para>
+ 設定変数 : ifx.blobinfile
+ </para>
+ <para>
+ ランタイム関数 :
+ </para>
+ <para>
+ ifx_blobinfile_mode(0) : メモリーに BYTE カラムを返す, blob id によ
+ りその内容を取り出す
+ </para>
+ <para>
+ ifx_blobinfile_mode(1) : メモリーに BYTE カラムを返す, blob id によ
+ りそのファイル名を取り出す
+ </para>
+ <para>
+ ifx_text/byteasvarchar を 1 に設定した場合、
+ 通常の(しかしやや長い) VARCHAR フィールドのように
+ select クエリーで TEXT や BYTE カラムを使用することが可能です。
+ 全ての文字列は、PHP で "数えられる" ので、これにより、"バイナリ・セー
+ フ"が維持されます。
+ これを正しく処理するのはあなた次第です。
+ 返されるデータには何でも含むことができますが、その内容について
+ 責任を負うことになります。
+ </para>
+ <para>
+ ifx_blobinfile を 1 に設定した場合、blob の内容を得るために
+ ifx_get_blob(..) により返されたファイル名を使用して下さい。
+ この場合、行を取得する際に Informix により作成されたテンポラリファイル
+ を削除する責任があります。取得された新規の行は、BYTE カラム毎に新
+ 規のテンポラリファイルを作成します。
+ </para>
+ <para>
+ テンポラリファイルの位置は、環境変数 "blobdir" により設定すること
+ ができます。デフォルトは、"." (カレントディレクトリ)です。
+ putenv(blobdir="tmpblob"); のようにすることにより、誤って残ってし
+ まったテンポラリファイルを削除することが容易になります。(テンポラ
+ リファイルの名前は "blb" で始まります)
</para>
</note>
<note>
<title>自動的に "char" (SQLCHAR および SQLNCHAR) データを取り去る</title>
- <para>
- これは、次の設定変数により設定することが可能です。
- </para>
- <para>
- ifx.charasvarchar : 最後尾のスペースを何らかの削除処理を行わずに
- 自動的に取り去る場合に1に設定します。
- </para>
+ <para>
+ これは、次の設定変数により設定することが可能です。
+ </para>
+ <para>
+ ifx.charasvarchar : 最後尾のスペースを何らかの削除処理を行わずに
+ 自動的に取り去る場合に1に設定します。
+ </para>
</note>
<note>
- <title>NULL 値</title>
+ <title>NULL 値</title>
<para>
- 設定変数 ifx.nullformat (およびランタイム関数 <function>ifx_nullformat</function>) をTRUEに設定した場合、文字列 "NULL" として NULL カラムを返します。
- FALSEに設定した場合は空文字列を返します。
- これにより、NULLカラムと空のカラムを識別することが可能となります。
- </para>
+ 設定変数 ifx.nullformat (およびランタイム関数
+ <function>ifx_nullformat</function>) をTRUEに設定した場合、文字列
+ "NULL" として NULL カラムを返します。FALSEに設定した場合は空文字
+ 列を返します。これにより、NULLカラムと空のカラムを識別することが
+ 可能となります。
+ </para>
</note>
</partintro>
-
+
<refentry id="function.ifx-connect">
<refnamediv>
<refname>ifx_connect</refname>
@@ -178,22 +181,25 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ifx_connect</function></funcdef>
- <paramdef>string <parameter><optional>database</optional>
- </parameter></paramdef>
- <paramdef>string <parameter><optional>userid</optional>
- </parameter></paramdef>
- <paramdef>string <parameter><optional>password</optional>
- </parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>database</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>userid</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>password</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- 成功時に接続 ID を、エラー時に FALSE を返します。
+ 成功時に接続 ID を、エラー時に FALSE を返します。
</para>
<para>
<function>ifx_connect</function> は、Informix サーバーへの接続を
確立します。全ての引数はオプションであり、指定されない場合には、
- <link linkend="configuration.file">設定ファイル</link>にて指定された値
- がデフォルト値として設定されます。
+ <link linkend="configuration.file">設定ファイル</link>にて指定された値
+ がデフォルト値として設定されます。
(ホストに関して ifx.default_host (定義されていない場合、Informix
ライブラリは、環境変数<envar>INFORMIXSERVER</envar>を参照します)
, ユーザーに関して ifx.default_user,
@@ -201,28 +207,28 @@
となります。
</para>
<para>
- 同じ引数で
+ 同じ引数で
<function>ifx_connect</function> を2回目にコールした際には、
新規のリンクは確立されず、代わりに既にオープンされたリンクの
リンク ID が返されます。
</para>
<para>
- サーバーへのリンクは、<function>ifx_close</function> のコールに
- より明示的に事前に閉じない限り、スクリプトの実行終了直後に閉じられます。
+ サーバーへのリンクは、<function>ifx_close</function> のコールに
+ より明示的に事前に閉じない限り、スクリプトの実行終了直後に閉じられます。
</para>
<para>
<function>ifx_pconnect</function>,
- <function>ifx_close</function> も参照下さい。
+ <function>ifx_close</function> も参照下さい。
<example>
<title>Informix データベースへの接続</title>
- <programlisting role="php3">
+ <programlisting role="php">
$conn_id = ifx_connect ("mydb <email protected>", "imyself", "mypassword");
</programlisting>
</example>
- </para>
+ </para>
</refsect1>
</refentry>
-
+
<refentry id="function.ifx-pconnect">
<refnamediv>
<refname>ifx_pconnect</refname>
@@ -233,36 +239,41 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ifx_pconnect</function></funcdef>
- <paramdef>string <parameter><optional>database</optional>
- </parameter></paramdef>
- <paramdef>string <parameter><optional>userid</optional>
- </parameter></paramdef>
- <paramdef>string <parameter><optional>password</optional>
- </parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>database</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>userid</optional></parameter>
+ </paramdef>
+ <paramdef>string
+ <parameter><optional>password</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- 返り値: 成功時に正の Informix 持続的リンク ID 、エラー時に FALSE</para>
+ 返り値: 成功時に正の Informix 持続的リンク ID 、エラー時に FALSE
+ </para>
<para>
-
<function>ifx_pconnect</function> は、二つの大きな違いはあるものの、
- <function>ifx_connect</function> と非常に似た動作をします。</para>
+ <function>ifx_connect</function> と非常に似た動作をします。
+ </para>
<para>
- この関数は、PHP が Apache モジュールとして実行されていない場合、
- <function>ifx_connect</function> とほとんど似た動作をします。
- まず、接続時に、関数は、既にオープンされている同じホスト、ユーザ名、
- パスワード の(持続的)リンク探します。
- そのリンクが見つかった場合、新規に接続をオープンする代わりに
- おの ID が返されます。</para>
- <para>
- 第二に、SQL サーバーへの接続は、スクリプトの実行終了時に閉じられません。
- 代わりにリンクは、後の使用のためにオープンされたままとなります。
- (<function>ifx_close</function> は <function>ifx_pconnect</function>
- により確立されたリンクを閉じません。)
+ この関数は、PHP が Apache モジュールとして実行されていない場合、
+ <function>ifx_connect</function> とほとんど似た動作をします。
+ まず、接続時に、関数は、既にオープンされている同じホスト、ユーザ名、
+ パスワード の(持続的)リンク探します。
+ そのリンクが見つかった場合、新規に接続をオープンする代わりに
+ おの ID が返されます。
</para>
<para>
- この型のリンクは、このため、'持続的' であると呼ばれます。
+ 第二に、SQL サーバーへの接続は、スクリプトの実行終了時に閉じられません。
+ 代わりにリンクは、後の使用のためにオープンされたままとなります。
+ (<function>ifx_close</function> は <function>ifx_pconnect</function>
+ により確立されたリンクを閉じません。)
</para>
+ <para>
+ この型のリンクは、このため、'持続的' であると呼ばれます。
+ </para>
<para>
<function>ifx_connect</function> も参照下さい。
</para>
@@ -279,8 +290,9 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>ifx_close</function></funcdef>
- <paramdef>int <parameter><optional>link_identifier</optional>
- </parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>link_identifier</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -293,9 +305,9 @@
リンク ID が指定されない場合、最後にオープンされたリンクが仮定されます。
</para>
<para>
- 非持続的関数としてオープンされたリンクはスクリプトの実行終了時に
- 自動的に閉じられるため、
- この関数は通常の場合は必要ではないことに注意して下さい。
+ 非持続的関数としてオープンされたリンクはスクリプトの実行終了時に
+ 自動的に閉じられるため、
+ この関数は通常の場合は必要ではないことに注意して下さい。
</para>
<para>
<function>ifx_close</function> は、<function>ifx_pconnect</function>
@@ -303,10 +315,10 @@
</para>
<para>
<function>ifx_connect</function>,
- <function>ifx_pconnect</function> も参照下さい。
+ <function>ifx_pconnect</function> も参照下さい。
<example>
<title>Informix 接続を閉じる</title>
- <programlisting role="php3">
+ <programlisting role="php">
$conn_id = ifx_connect (mydb <email protected>, "itsme", "mypassword");
... クエリー等を実行 ...
ifx_close($conn_id);
@@ -327,77 +339,76 @@
<funcprototype>
<funcdef>int <function>ifx_query</function></funcdef>
<paramdef>string <parameter>query</parameter></paramdef>
- <paramdef>int <parameter><optional>link_identifier</optional>
- </parameter></paramdef>
- <paramdef>int <parameter><optional>cursor_type</optional>
- </parameter></paramdef>
- <paramdef>mixed <parameter><optional>blobidarray</optional>
- </parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>link_identifier</optional></parameter>
+ </paramdef>
+ <paramdef>int
+ <parameter><optional>cursor_type</optional></parameter>
+ </paramdef>
+ <paramdef>mixed
+ <parameter><optional>blobidarray</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
返り値: 成功時に正の Informix 結果 ID、エラー時に FALSE
</para>
<para>
- リソース "result_id" は、クエリー結果を取得するために
- 他の関数により使用されます。
+ リソース "result_id" は、クエリー結果を取得するために
+ 他の関数により使用されます。
<function>ifx_affected_rows</function> 関数による取得を行うために
"affected_rows" をセットします。
</para>
<para>
- <function>ifx_query</function> は、サーバー上の
- 指定したリンク ID が指す現在アクティブなデータベースに
- クエリーを送信します。リンク ID が指定されない場合は、
- 最後にオープンされたリンクを仮定します。
+ <function>ifx_query</function> は、サーバー上の指定したリンク ID
+ が指す現在アクティブなデータベースにクエリーを送信します。リンク
+ ID が指定されない場合は、最後にオープンされたリンクを仮定します。
リンクがオープンされていない場合、この関数は、
- <function>ifx_connect</function> がコールされた時と同様に
- リンクを確立しようと試み、それを使用します。
+ <function>ifx_connect</function> がコールされた時と同様にリンクを
+ 確立しようと試み、それを使用します。
</para>
<para>
- 接続 <parameter>conn_id</parameter> において <parameter>query</parameter>
- を実行します。
- "select 型" のクエリーでは、カーソルが定義され、オープンされます。
- オプションの <parameter>cursor_type</parameter> パラメータにより、
- そのカーソルを
- "スクロール" または "ホールド" カーソルとすることができます。
- このオプションはビットマスクであり、IFX_SCROLL, IFX_HOLD, または
- 両方とも指定することができます。
- select でないクエリーは、"直ちに実行"されます。
- IFX_SCROLL および IFX_HOLD はシンボル定数なので
- 引用符で括る必要はありません。
- このパラメ―タを省略した場合、カーソルは通常のシーケンãルカーソル
- になります。
- </para><para>
- どちらのタイプのクエリーにおいても、(予測または実際の数として)
- 作用された行の数は、<function>ifx_affected_rows</function> により
- 取得するために保存されます。
- </para>
- <para>
- もし、update クエリーにおいて BLOB (BYTE または TEXT) カラムがある場合、
- 対応する "BLOB ID" を有する
- <parameter>blobidarray</parameter> パラメータを追加することが可能です。
- この場合、クエリーテキストのこれらのカラムを "?" で置換することが必要です。
- </para>
- <para>
- TEXT (または BYTE) カラムの内容が許すならば、
- "ifx_textasvarchar(1)" または "ifx_byteasvarchar(1)" を使用することも
- 可能です。
- これにより、TEXT (または BYTE) カラムは、select クエリーの
- 通常の(しかし長い)VARCHAR カラムと同様に処理され、
- BLOB ID で悩むこともなくなります。
- </para>
- <para>
- ifx_textasvarchar(0) または ifx_byteasvarchar(0) (デフォルト値)
- の場合、select クエリーは、BLOB ID (整数値) に属するものとして
- BLOB カラムを返します。
- BLOB 関数により文字列またはファイルとして BLOB の値を得ることが可能です。
- (以下を参照)
+ 接続 <parameter>conn_id</parameter> において
+ <parameter>query</parameter>を実行します。"select 型" のクエリー
+ では、カーソルが定義され、オープンされます。オプションの
+ <parameter>cursor_type</parameter> パラメータにより、そのカーソル
+ を"スクロール" または "ホールド" カーソルとすることができます。こ
+ のオプションはビットマスクであり、IFX_SCROLL, IFX_HOLD, または両
+ 方とも指定することができます。select でないクエリーは、"直ちに実
+ 行"されます。IFX_SCROLL および IFX_HOLD はシンボル数なので引用
+ 符で括る必要はありません。このパラメータを省略した場合、カーソル
+ は通常のシーケンシャルカーソルになります。
+ </para>
+ <para>
+ どちらのタイプのクエリーにおいても、(予測または実際の数として)
+ 作用された行の数は、<function>ifx_affected_rows</function> により
+ 取得するために保存されます。
+ </para>
+ <para>
+ もし、update クエリーにおいて BLOB (BYTE または TEXT) カラムがあ
+ る場合、対応する "BLOB ID" を有する
+ <parameter>blobidarray</parameter> パラメータを追加することが可能
+ です。この場合、クエリーテキストのこれらのカラムを "?" で置換する
+ ことが必要です。
+ </para>
+ <para>
+ TEXT (または BYTE) カラムの内容が許すならば、
+ "ifx_textasvarchar(1)" または "ifx_byteasvarchar(1)" を使用するこ
+ とも可能です。これにより、TEXT (または BYTE) カラムは、select ク
+ エリーの通常の(しかし長い)VARCHAR カラムと同様に処理され、BLOB ID
+ で悩むこともなくなります。
+ </para>
+ <para>
+ ifx_textasvarchar(0) または ifx_byteasvarchar(0) (デフォルト値)
+ の場合、select クエリーは、BLOB ID (整数値) に属するものとして
+ BLOB カラムを返します。BLOB 関数により文字列またはファイルとして
+ BLOB の値を得ることが可能です。(以下を参照)
</para>
<para>
<function>ifx_connect</function> も参照下さい。
<example>
<title>"orders" テーブルの全行を HTML テーブルとして表示する</title>
- <programlisting role="php3">
+ <programlisting role="php">
ifx_textasvarchar(1); // BLOB 用に "text mode" を使用する
$res_id = ifx_query("select * from orders", $conn_id);
if (! $res_id) {
@@ -412,7 +423,7 @@
</example>
<example>
<title>値を "catalog" テーブルに挿入する</title>
- <programlisting role="php3">
+ <programlisting role="php">
// バイトおよびテキストカラムに関する BLOB ID を作成する。
$textid = ifx_create_blob(0, 0, "Text column in memory");
$byteid = ifx_create_blob(1, 0, "Byte column in memory");
@@ -446,51 +457,52 @@
<funcdef>int <function>ifx_prepare</function></funcdef>
<paramdef>string <parameter>query</parameter></paramdef>
<paramdef>int <parameter>conn_id</parameter></paramdef>
- <paramdef>int <parameter><optional>cursor_def</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>cursor_def</optional></parameter>
+ </paramdef>
<paramdef>mixed <parameter>blobidarray</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
-
- <function>ifx_do</function> で使用するために
- 整数 <parameter>result_id</parameter> を返します。
- <function>ifx_affected_rows</function> 関数による取得を可能にするために
- <parameter>affected_rows</parameter> をセットします。
- </para><para>
- 接続 <parameter>conn_id</parameter> に関して <parameter>query</parameter>
- を準備します。
- "select 型" クエリーの場合、カーソルが宣言され、オープンされます。
- オプションの <parameter>cursor_type</parameter> パラメータにより、
- そのカーソルを "スクロール" または "ホールド" カーソルとすることが
- できます。
+ <function>ifx_do</function> で使用するために整数
+ <parameter>result_id</parameter> を返します。
+ <function>ifx_affected_rows</function> 関数による取得を可能にする
+ ために<parameter>affected_rows</parameter> をセットします。
+ </para>
+ <para>
+ 接続 <parameter>conn_id</parameter> に関して
+ <parameter>query</parameter>を準備します。"select 型" クエリーの
+ 場合、カーソルが宣言され、オープンされます。オプションの
+ <parameter>cursor_type</parameter> パラメータにより、そのカーソル
+ を "スクロール" または "ホールド" カーソルとすることができます。
このオプションはビットマスクであり、IFX_SCROLL, IFX_HOLD, または
両方とも指定することができます。
select でないクエリーは、"直ちに実行"されます。
</para>
<para>
- どちらのタイプのクエリーにおいても、(予測または実際の数として)
- 作用された行の数は、<function>ifx_affected_rows</function> により
- 取得可能とするために保存されます。
+ どちらのタイプのクエリーにおいても、(予測または実際の数として)
+ 作用された行の数は、<function>ifx_affected_rows</function> により
+ 取得可能とするために保存されます。
</para>
<para>
- もし、クエリーにおいて BLOB (BYTE または TEXT) カラムがある場合、
- 対応する "BLOB ID" を有する
- <parameter>blobidarray</parameter> パラメータを追加することが可能です。
- この場合、クエリーテキストのこれらのカラムを "?" で置換することが必要です。
+ もし、クエリーにおいて BLOB (BYTE または TEXT) カラムがある場合、
+ 対応する "BLOB ID" を有する<parameter>blobidarray</parameter> パ
+ ラメータを追加することが可能です。この場合、クエリーテキストのこ
+ れらのカラムを "?" で置換することが必要です。
</para>
<para>
- TEXT (または BYTE) カラムの内容が許すならば、
- "ifx_textasvarchar(1)" または "ifx_byteasvarchar(1)" を使用することも
- 可能です。
- これにより、TEXT (または BYTE) カラムは、select クエリーの
- 通常の(しかし長い)VARCHAR カラムと同様に処理され、
- BLOB ID で悩むこともなくなります。
+ TEXT (または BYTE) カラムの内容が許すならば、
+ "ifx_textasvarchar(1)" または "ifx_byteasvarchar(1)" を使用するこ
+ とも可能です。
+ これにより、TEXT (または BYTE) カラムは、select クエリーの
+ 通常の(しかし長い)VARCHAR カラムと同様に処理され、
+ BLOB ID で悩むこともなくなります。
</para>
<para>
- ifx_textasvarchar(0) または ifx_byteasvarchar(0) (デフォルト値)
- の場合、select クエリーは、BLOB ID (整数値) に属するものとして
- BLOB カラムを返します。
- BLOB 関数により文字列またはファイルとして BLOB の値を得ることが可能です。
+ ifx_textasvarchar(0) または ifx_byteasvarchar(0) (デフォルト値)
+ の場合、select クエリーは、BLOB ID (整数値) に属するものとして
+ BLOB カラムを返します。
+ BLOB 関数により文字列またはファイルとして BLOB の値を得ることが可能です。
</para>
<para>
<function>ifx_do</function> も参照下さい。
@@ -512,18 +524,18 @@
</funcprototype>
</funcsynopsis>
<para>
- 成功時に TRUE、エラーの時に FALSE を返す。
+ 成功時に TRUE、エラーの時に FALSE を返す。
</para>
<para>
- 事前に準備されたクエリーを実行し、カーソルをオープンします。
+ 事前に準備されたクエリーを実行し、カーソルをオープンします。
</para>
<para>
- エラーの際に、<parameter>result_id</parameter> を解放しないで下さい。
+ エラーの際に、<parameter>result_id</parameter> を解放しないで下さい。
</para>
<para>
- select 文でない場合に、<function>ifx_affected_rows</function>
- に数を設定します。
- これは、<function>ifx_affected_rows</function> で取得可能です。
+ select 文でない場合に、<function>ifx_affected_rows</function>
+ に数を設定します。
+ これは、<function>ifx_affected_rows</function> で取得可能です。
</para>
<para>
<function>ifx_prepare</function> も参照下さい。例があります。
@@ -544,33 +556,48 @@
<void/>
</funcprototype>
</funcsynopsis>
+ <para>
+ Informix エラーコード (SQLSTATE & SQLCODE) は次のようなフォーマッ
+ トとなります :
+ </para>
<para>
- Informix エラーコード (SQLSTATE & SQLCODE) は次のようなフォーマットとなります :
- </para><para>
x [SQLSTATE = aa bbb SQLCODE=cccc]
- </para><para>
- where x = space : no error
- </para><para> E : error
- </para><para> N : no more data
- </para><para> W : warning
- </para><para> ? : undefined
- </para><para>
- 文字 "x" が空白以外の文字だった場合、SQLSTATE および SQLCODE は、
- エラーをより詳細に記述します。
- </para><para>
- SQLSTATE および SQLCODE の詳細については、Informix マニュアルを
- 参照下さい。
- </para><para>
- 文の一般的な結果を記述する一文字からなる文字列および
- 直近に実行された SQL 文に関する SQLSTATE および SQLCODE の両方を
- 返します。
- 文字列のフォーマットは、
- "(char) [SQLSTATE=(two digits) (three digits) SQLCODE=(one
- digit)]" となります。
- 最初の文字は、'<literal> </literal>'
- (space) (success), '<literal>W</literal>' (その文において警告を生じた), '<literal>E</literal>' (その文の実行時にエラーを発生した) ,'<literal>N</literal>' (その文はデータを全く返さなかった) となります
-
- </para><para>
+ </para>
+ <para>
+ ただし、x = 空白 : エラーなし
+ </para>
+ <para>
+ E : エラー
+ </para>
+ <para>
+ N : データがもうない
+ </para>
+ <para>
+ W : 警告
+ </para>
+ <para>
+ ? : 未定義
+ </para>
+ <para>
+ 文字 "x" が空白以外の文字だった場合、SQLSTATE および SQLCODE は、
+ エラーをより詳細に記述します。
+ </para>
+ <para>
+ SQLSTATE および SQLCODE の詳細については、Informix マニュアルを
+ 参照下さい。
+ </para>
+ <para>
+ 文の一般的な結果を記述する一文字からなる文字列および直近に実行さ
+ れた SQL 文に関する SQLSTATE および SQLCODE の両方を返します。文
+ 字列のフォーマットは、
+ "(char) [SQLSTATE=(2桁の数値) (3桁の数値) SQLCODE=(1桁の数値)]"
+ となります。最初の文字は、'<literal> </literal>'
+ (空白) (成功), '<literal>W</literal>' (その文において警告を生
+ じた), '<literal>E</literal>' (その文の実行時にエラーを発生した)
+ ,'<literal>N</literal>' (その文はデータを全く返さなかった) となり
+ ます。
+ </para>
+ <para>
<function>ifx_errormsg</function> も参照下さい。
</para>
</refsect1>
@@ -586,22 +613,25 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>ifx_errormsg</function></funcdef>
- <paramdef>int <parameter><optional>errorcode</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>errorcode</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- 直近の Informix エラーに関する Informix エラーメッセージ、または、
- オプションの "<parameter>errorcode</parameter>" パラメータが指定された
- 場合、"<parameter>errorcode</parameter>" に対応するエラーメッセージ
- が返されます。
- </para><para>
+ 直近の Informix エラーに関する Informix エラーメッセージ、または、
+ オプションの "<parameter>errorcode</parameter>" パラメータが指定された
+ 場合、"<parameter>errorcode</parameter>" に対応するエラーメッセージ
+ が返されます。
+ </para>
+ <para>
<function>ifx_error</function> も参照下さい。
</para>
- <informalexample>
- <programlisting>
+ <informalexample>
+ <programlisting role="php">
printf("%s\n<br>", ifx_errormsg(-201));
- </programlisting>
- </informalexample>
+ </programlisting>
+ </informalexample>
</refsect1>
</refentry>
@@ -619,29 +649,32 @@
</funcprototype>
</funcsynopsis>
<para>
- <parameter>result_id</parameter> は、
- <function>ifx_query</function> または
+ <parameter>result_id</parameter>は、
+ <function>ifx_query</function>または
<function>ifx_prepare</function> により返される有効な結果 ID です。
- </para><para>
- <parameter>result_id</parameter> に関連するクエリーにより作用された
- 行の数を返します。
- </para><para>
- insert, update ,delete の場合、その数は、実際に作用された行の数
- (sqlerrd[2]) です。select の場合、これは推定値 (sqlerrd[0])です。
- この値を信用してはいけません。
- データベースサーバーは、SELECTにより実際に返される行の数を
- 返すことはありません。これは、この段階(オプティマイザがクエリー
- 手順を定義している場合には、"PREPARE"を行った直後)では、
- 行の取得を始めてさえもいないためです。
- </para><para>
- <function>ifx_prepare</function> の実行後に
- クエリー結果を適当な量に制限するために使用すると便利です。
- </para><para>
+ </para>
+ <para>
+ <parameter>result_id</parameter> に関連するクエリーにより作用され
+ た行の数を返します。
+ </para>
+ <para>
+ insert, update ,delete の場合、その数は、実際に作用された行の数
+ (sqlerrd[2]) です。select の場合、これは推定値 (sqlerrd[0])です。
+ この値を信用してはいけません。データベースサーバーは、SELECTによ
+ り実際に返される行の数を返すことはありません。これは、この段階(オ
+ プティマイザがクエリー手順を定義している場合には、"PREPARE"を行っ
+ た直後)では、行の取得を始めてさえもいないためです。
+ </para>
+ <para>
+ <function>ifx_prepare</function> の実行後にクエリー結果を適当な量
+ に制限するために使用すると便利です。
+ </para>
+ <para>
<function>ifx_num_rows</function> も参照下さい。
</para>
- <example>
- <title>Informix affected rows</title>
- <programlisting role="php3">
+ <example>
+ <title>Informix affected rows</title>
+ <programlisting role="php">
$rid = ifx_prepare ("select * from emp where name like " . $name, $connid);
if (! $rid) {
... error ...
@@ -651,11 +684,11 @@
printf ("Too many rows in result set (%d)\n<br>", $rowcount);
die ("Please restrict your query<br>\n");
}
- </programlisting>
- </example>
+ </programlisting>
+ </example>
</refsect1>
</refentry>
-
+
<refentry id="function.ifx-getsqlca">
<refnamediv>
<refname>ifx_getsqlca</refname>
@@ -670,38 +703,41 @@
</funcprototype>
</funcsynopsis>
<para>
- <parameter>result_id</parameter> は、<function>ifx_query</function> または
+ <parameter>result_id</parameter> は、
+ <function>ifx_query</function> または
<function>ifx_prepare</function> から返される有効な結果IDです。
- </para><para>
- <parameter>result_id</parameter> に関連するクエリを実行した後の
- sqlca.sqlerrd[0] から sqlca.sqlerrd[5] に関する擬似レコード(連想配列)を
- 返します。
- </para><para>
- insert、update、delete の場合、クエリが実行された後、サーバーにより
- 設定される場合と同様にレコードの値が返されます。
- これにより、作用を受けた行の下図および連番の挿入値にアクセスすることが
- 可能となります。
- SELECT の場合、この値はPREPARE 文の後で保存された値となります。
- この値から作用を受けた行の数の"推測"値が分かります。
+ </para>
+ <para>
+ <parameter>result_id</parameter> に関連するクエリを実行した後の
+ sqlca.sqlerrd[0] から sqlca.sqlerrd[5] に関する擬似レコード(連想
+ 配列)を返します。
+ </para>
+ <para>
+ insert、update、delete の場合、クエリが実行された後、サーバーにより
+ 設定される場合と同様にレコードの値が返されます。
+ これにより、作用を受けた行の下図および連番の挿入値にアクセスすることが
+ 可能となります。
+ SELECT の場合、この値はPREPARE 文の後で保存された値となります。
+ この値から作用を受けた行の数の"推測"値が分かります。
ifx ドライバにより適当な時に保存された値が取得されるため、
この関数を使用することにより、
"select dbinfo('sqlca.sqlerrdx')" クエリを実行するオーバーヘッドを
防止することができます。
</para>
- <example>
- <title>Informix sqlca.sqlerrd[x] の値を取得する</title>
- <programlisting role="php3">
+ <example>
+ <title>Informix sqlca.sqlerrd[x] の値を取得する</title>
+ <programlisting role="php">
/* 'sometable' の最初のカラムは連番であると仮定する */
$qid = ifx_query("insert into sometable
- values(0, '2nd column', 'another column' ", $connid));
+ values(0, '2nd column', 'another column') ", $connid));
if (! $qid) {
... error ...
}
$sqlca = ifx_getsqlca ($qid);
$serial_value = $sqlca["sqlerrd1"];
echo "挿入された行の続き番号は : " . "$serial_value<br>\n";
- </programlisting>
- </example>
+ </programlisting>
+ </example>
</refsect1>
</refentry>
@@ -716,44 +752,49 @@
<funcprototype>
<funcdef>array <function>ifx_fetch_row</function></funcdef>
<paramdef>int <parameter>result_id</parameter></paramdef>
- <paramdef>mixed <parameter><optional>position</optional>
- </parameter></paramdef>
+ <paramdef>mixed
+ <parameter><optional>position</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
<para>
- 取得された行に対応する連想配列または、行がもうない場合に FALSE を
- 返します。
- </para><para>
- BLOB カラムが、<function>ifx_get_blob</function> で使用するために
- 整数値 BLOB ID として返されます。
- ただし、ifx_textasvarchar(1) または ifx_byteasvarchar(1) を指定している
- 場合を除きます。この場合、BLOB は、文字列として返されます。
- エラーの場合、false が返されます。
- </para><para>
+ 取得された行に対応する連想配列または、行がもうない場合に FALSE を
+ 返します。
+ </para>
+ <para>
+ BLOB カラムが、<function>ifx_get_blob</function> で使用するために
+ 整数値 BLOB ID として返されます。ただし、ifx_textasvarchar(1) ま
+ たは ifx_byteasvarchar(1) を指定している場合を除きます。この場合、
+ BLOB は、文字列として返されます。エラーの場合、false が返されます。
+ </para>
+ <para>
<parameter>result_id</parameter> は、
<function>ifx_query</function> または
<function>ifx_prepare</function> (select 型のクエリーのみ!)
により返された有効な結果 ID です。
- </para><para>
+ </para>
+ <para>
<parameter><optional>position</optional></parameter> は、オプション
パラメータで、"スクロール" カーソルで "取得" 操作を行うためのもので、
次のようになります。
"NEXT", "PREVIOUS", "CURRENT", "FIRST", "LAST" ,または番号。
番号を指定した場合、"絶対" 行の取得が行われます。このパラメータは、
オプションであり、SCROLL カーソルの場合にのみ有効です。
- </para><para>
+ </para>
+ <para>
<function>ifx_fetch_row</function> は、指定された結果 ID が関連する
結果から1行文のデータを取得します。
各結果カラムは、オフセット 0 から始まる配列オフセットに保存されます。
カラム名がキーとなります。
- </para><para>
- <function>ifx_fetch_row</function> を続けてコールした場合、結果セッの
+ </para>
+ <para>
+ <function>ifx_fetch_row</function> を続けてコールした場合、結果セッÈの
次の行が返されるます。
行がもうない場合は、false が返されます。
</para>
<example>
<title>Informix 行の取得</title>
- <programlisting role="php3">
+ <programlisting role="php">
$rid = ifx_prepare ("select * from emp where name like " . $name,
$connid, IFX_SCROLL);
if (! $rid) {
@@ -785,7 +826,9 @@
<refentry id="function.ifx-htmltbl-result">
<refnamediv>
<refname>ifx_htmltbl_result</refname>
- <refpurpose>クエリー結果の全行を HTML テーブルにフォーマットする</refpurpose>
+ <refpurpose>
+ クエリー結果の全行を HTML テーブルにフォーマットする
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -793,20 +836,22 @@
<funcprototype>
<funcdef>int <function>ifx_htmltbl_result</function></funcdef>
<paramdef>int <parameter>result_id</parameter></paramdef>
- <paramdef>string <parameter><optional>html_table_options</optional></parameter></paramdef>
+ <paramdef>string
+ <parameter><optional>html_table_options</optional></parameter>
+ </paramdef>
</funcprototype>
</funcsynopsis>
+ <para>
+ 取得された行の数またはエラーの場合に FALSE を返します。
+ </para>
<para>
- 取得された行の数またはエラーの場合に FALSE を返します。
- </para><para>
クエリー結果 <parameter>result_id</parameter> の全ての行を
HTML テーブルにフォーマットします。オプションの 2番目の引数は、
<table> タグのオプションとする文字列です。
-
</para>
- <example>
- <title>Informix 結果を HTML テーブルとして出力</title>
- <programlisting role="php3">
+ <example>
+ <title>Informix 結果を HTML テーブルとして出力</title>
+ <programlisting role="php">
$rid = ifx_prepare ("select * from emp where name like " . $name,
$connid, IFX_SCROLL);
if (! $rid) {
@@ -824,8 +869,8 @@
ifx_htmltbl_result ($rid, "border=\"2\"");
ifx_free_result($rid);
- </programlisting>
- </example>
+ </programlisting>
+ </example>
</refsect1>
</refentry>
@@ -843,13 +888,13 @@
</funcprototype>
</funcsynopsis>
<para>
- <parameter>result_id</parameter> のクエリーについて
- フィールド名をキーとし、SQL フィールド型をデータとした連想配列を返します。
- エラーの場合にfalseを返します。
+ <parameter>result_id</parameter> のクエリーについてフィールド名を
+ キーとし、SQL フィールド型をデータとした連想配列を返します。エラー
+ の場合にfalseを返します。
</para>
<example>
<title>フィールド名および SQL フィールド型</title>
- <programlisting role="php3">
+ <programlisting role="php">
$types = ifx_fieldtypes ($resultid);
if (! isset ($types)) {
... エラー処理 ...
@@ -878,21 +923,21 @@
</funcprototype>
</funcsynopsis>
<para>
- <parameter>result_id</parameter> のクエリーについて
- フィールド名をキーとし、SQL フィールドプロパティをデータとした
- 連想配列を返します。
- エラーの場合にfalseを返します。
- </para><para>
- クエリー中の全てのフィールドの Informix SQL フィールドプロパティ
- を連想配列として返します。コード化されるプロパティを次に示します。
+ <parameter>result_id</parameter> のクエリーについてフィールド名を
+ キーとし、SQL フィールドプロパティをデータとした連想配列を返しま
+ す。エラーの場合にfalseを返します。
+ </para>
+ <para>
+ クエリー中の全てのフィールドの Informix SQL フィールドプロパティ
+ を連想配列として返します。コード化されるプロパティを次に示します。
"SQLTYPE;length;precision;scale;ISNULLABLE" ただし、SQLTYPE は、
- "SQLVCHAR" 等の Informix 型。
- ISNULLABLE は、"Y" または "N" となります。
+ "SQLVCHAR" 等の Informix 型。ISNULLABLE は、"Y" または "N" となり
+ ます。
</para>
<example>
<title>Informix SQL フィールドプロパティ</title>
- <programlisting role="php3">
-$properties = ifx_fieldtypes ($resultid);
+ <programlisting role="php">
+$properties = ifx_fieldproperties ($resultid);
if (! isset($properties)) {
... error ...
}
@@ -922,14 +967,15 @@
<para>
<parameter>result_id</parameter> に関するクエリー結果のカラム数または
エラーの場合にfalseを返します。
- </para><para>
- クエリーを準備または実行された後、この関数をコールすることにより、
- クエリー結果中でカラム数が得られます。
+ </para>
+ <para>
+ クエリーを準備または実行された後、この関数をコールすることにより、
+ クエリー結果中でカラム数が得られます。
</para>
</refsect1>
</refentry>
- <refentry id="function.ifx-num-rows">
+ <refentry id="function.ifx-num-rows">
<refnamediv>
<refname>ifx_num_rows</refname>
<refpurpose>クエリー既に取得された行の数を数える</refpurpose>
@@ -984,8 +1030,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 文字オブジェクトを作成します。<parameter>param</parameter> は、
- 内容となる文字とする必要があります。
+ 文字オブジェクトを作成します。<parameter>param</parameter> は、
+ 内容となる文字とする必要があります。
</para>
</refsect1>
</refentry>
@@ -1004,9 +1050,9 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定したオブジェクト ID <parameter>bid</parameter>
- に関する文字オブジェクトを削除します。
- エラーの場合は FALSE、それ以外は TRUE を返します。
+ 指定したオブジェクト ID <parameter>bid</parameter>に関する文字オ
+ ブジェクトを削除します。エラーの場合は FALSE、それ以外は TRUE を
+ 返します。
</para>
</refsect1>
</refentry>
@@ -1026,10 +1072,10 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定した文字オブジェクト <parameter>bid</parameter> に関して
- 文字オブジェクトの内容を更新します。
- <parameter>content</parameter> は新規のデータを有する文字列です。
- エラーの場合に FALSE、それ以外の場合に TRUE を返します。
+ 指定した文字オブジェクト <parameter>bid</parameter> に関して
+ 文字オブジェクトの内容を更新します。
+ <parameter>content</parameter> は新規のデータを有する文字列です。
+ エラーの場合に FALSE、それ以外の場合に TRUE を返します。
</para>
</refsect1>
</refentry>
@@ -1048,8 +1094,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定した文字オブジェクト ID <parameter>bid</parameter> について
- 文字オブジェクトの内容を返します。
+ 指定した文字オブジェクト ID <parameter>bid</parameter> について
+ 文字オブジェクトの内容を返します。
</para>
</refsect1>
</refentry>
@@ -1070,19 +1116,23 @@
</funcprototype>
</funcsynopsis>
<para>
- BLOB オブジェクトを作成します。
- </para><para>
+ BLOB オブジェクトを作成します。
+ </para>
+ <para>
type: 1 = TEXT, 0 = BYTE
- </para><para>
+ </para>
+ <para>
mode: 0 = BLOB オブジェクトはメモリーに内容を保持する,
1 = BLOB オブジェクトはファイルに内容を保持する。
- </para><para>
- param: if mode = 0: 内容へのポインタ
- if mode = 1: ファイル文字列へのポインタ
- </para><para>
- エラーの場合に FALSE、それ以外の場合に新規の BLOB オブジェクト ID を
- 返します。
</para>
+ <para>
+ param: mode = 0 の場合: 内容へのポインタ
+ mode = 1 の場合: ファイル文字列へのポインタ
+ </para>
+ <para>
+ エラーの場合に FALSE、それ以外の場合に新規の BLOB オブジェクト ID を
+ 返します。
+ </para>
</refsect1>
</refentry>
@@ -1100,11 +1150,12 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定した BLOB オブジェクトを2重化します。
- <parameter>bid</parameter> は BLOB オブジェクトの ID です。
- </para><para>
- エラーの場合に FALSE、それ以外の場合に新規の BLOB オブジェクト ID を
- 返します。
+ 指定した BLOB オブジェクトを2重化します。
+ <parameter>bid</parameter> は BLOB オブジェクトの ID です。
+ </para>
+ <para>
+ エラーの場合に FALSE、それ以外の場合に新規の BLOB オブジェクト ID を
+ 返します。
</para>
</refsect1>
</refentry>
@@ -1123,7 +1174,7 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定された BLOB オブジェクト ID
+ 指定された BLOB オブジェクト ID
<parameter>bid</parameter> の BLOB オブジェクトを削除します。
エラーの場合に FALSE、それ以外の場合に TRUE を返します。
</para>
@@ -1144,8 +1195,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定した BLOB オブジェクト ID <parameter>bid</parameter>
- に関する BLOB オブジェクトの内容を返します。
+ 指定した BLOB オブジェクト ID <parameter>bid</parameter>
+ に関する BLOB オブジェクトの内容を返します。
</para>
</refsect1>
</refentry>
@@ -1165,9 +1216,9 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定っ_ BLOB オブジェクト ID <parameter>bid</parameter>
- に関する BLOB オブジェクトの内容を更新します。
- <parameter>content</parameter> は、新規データの文字列です。
+ 指定したBLOB オブジェクト ID <parameter>bid</parameter>
+ に関する BLOB オブジェクトの内容を更新します。
+ <parameter>content</parameter> は、新規データの文字列です。
エラーの場合に FALSE、それ以外の場合に TRUE を返します。
</para>
</refsect1>
@@ -1176,7 +1227,9 @@
<refentry id="function.ifx-blobinfile-mode">
<refnamediv>
<refname>ifx_blobinfile_mode</refname>
- <refpurpose>全ての select クエリーに関するデフォルトの BLOB モードを設定する</refpurpose>
+ <refpurpose>
+ 全ての select クエリーに関するデフォルトの BLOB モードを設定する
+ </refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
@@ -1187,9 +1240,9 @@
</funcprototype>
</funcsynopsis>
<para>
- 全ての select クエリーに関するデフォルトの BLOB モードを設定します。
- モード "0" は、BLOB をメモリーに保存することを意味し、
- モード "1" は、BLOB をファイルに保存することを意味します。
+ 全ての select クエリーに関するデフォルトの BLOB モードを設定します。
+ モード "0" は、BLOB をメモリーに保存することを意味し、
+ モード "1" は、BLOB をファイルに保存することを意味します。
</para>
</refsect1>
</refentry>
@@ -1208,9 +1261,9 @@
</funcprototype>
</funcsynopsis>
<para>
- 全ての select クエリーに関するデフォルトのテキストモードを設定します。
- モード "0" は、BLOB を返し、"1" は、テキストの内容を有する varchar を
- 返します。
+ 全ての select クエリーに関するデフォルトのテキストモードを設定します。
+ モード "0" は、BLOB を返し、"1" は、テキストの内容を有する varchar を
+ 返します。
</para>
</refsect1>
</refentry>
@@ -1229,8 +1282,8 @@
</funcprototype>
</funcsynopsis>
<para>
- 全ての select クエリーに関するデフォルトのバイトモードを設定します。
- モード "0" はBLOB ID を返し、モード "1" がテキストの内容を有する
+ 全ての select クエリーに関するデフォルトのバイトモードを設定します。
+ モード "0" は。LOB ID を返し、モード "1" がテキストの内容を有する
varchar を返します。
</para>
</refsect1>
@@ -1250,7 +1303,7 @@
</funcprototype>
</funcsynopsis>
<para>
- 取得する行のデフォルトの返り値を NULL 値に設定します。
+ 取得する行のデフォルトの返り値を NULL 値に設定します。
モード "0" は "" を返し、モード "1" は "NULL" を返します。
</para>
</refsect1>
@@ -1270,8 +1323,8 @@
</funcprototype>
</funcsynopsis>
<para>
- SLOB オブジェクトを作成し、オープンします。
- モードは、1 = LO_RDONLY, 2 =
+ SLOB オブジェクトを作成し、オープンします。
+ モードは、1 = LO_RDONLY, 2 =
LO_WRONLY, 4 = LO_APPEND, 8 = LO_RDWR, 16 = LO_BUFFER, 32 =
LO_NOBUFFER -> or-mask となります。
IFX_LO_RDONLY, IFX_LO_WRONLY 等の名前の定数を使用することも可能です。
@@ -1295,9 +1348,9 @@
</funcprototype>
</funcsynopsis>
<para>
- SLOB オブジェクトを削除します。<parameter>bid</parameter> は
- SLOB オブジェクトの ID です。
- エラーの場合に FALSE、その他の場合に TRUE を返します。
+ SLOB オブジェクトを削除します。<parameter>bid</parameter> は
+ SLOB オブジェクトの ID です。
+ エラーの場合に FALSE、その他の場合に TRUE を返します。
</para>
</refsect1>
</refentry>
@@ -1316,9 +1369,9 @@
</funcprototype>
</funcsynopsis>
<para>
- 指定した SLOB オブジェクト ID <parameter>bid</parameter>
- の SLOB オブジェクトを削除します。
- エラーの場合に FALSE、その他の場合に TRUE を返します。
+ 指定した SLOB オブジェクト ID <parameter>bid</parameter>
+ の SLOB オブジェクトを削除します。
+ エラーの場合に FALSE、その他の場合に TRUE を返します。
</para>
</refsect1>
</refentry>
@@ -1338,7 +1391,7 @@
</funcprototype>
</funcsynopsis>
<para>
- SLOB オブジェクトをオープンします。
+ SLOB オブジェクトをオープンします。
<parameter>bid</parameter> は存在する SLOB ID である必要があります。
モードは、1 = LO_RDONLY, 2 = LO_WRONLY, 4 =
LO_APPEND, 8 = LO_RDWR, 16 = LO_BUFFER, 32 = LO_NOBUFFER ->
@@ -1363,10 +1416,10 @@
</funcprototype>
</funcsynopsis>
<para>
- オープンされた SLOB オブジェクトに関して
- カレントのファイルまたはシーク位置を返します。
- <parameter>bid</parameter> は存在する SLOB ID である必要があります。
- エラーの場合に FALSE、その他の場合にシーク位置を返します。
+ オープンされた SLOB オブジェクトに関してカレントのファイルまたは
+ シーク位置を返します。<parameter>bid</parameter> は存在する SLOB
+ ID である必要があります。エラーの場に FALSE、その他の場合にシー
+ ク位置を返します。
</para>
</refsect1>
</refentry>
@@ -1387,11 +1440,10 @@
</funcprototype>
</funcsynopsis>
<para>
- オープンされた SLOB オブジェクトに関する
- カレントのファイルまたはシーク位置を設定します。
- <parameter>bid</parameter> は存在する SLOB ID である必要があります。
- モードは、
- 0 = LO_SEEK_SET, 1 = LO_SEEK_CUR, 2 = LO_SEEK_END となり、
+ オープンされた SLOB オブジェクトに関するカレントのファイルまたは
+ シーク位置を設定します。<parameter>bid</parameter> は存在する
+ SLOB ID である必要があります。モードは、0 = LO_SEEK_SET, 1 =
+ LO_SEEK_CUR, 2 = LO_SEEK_END となり、
<parameter>offset</parameter> はバイトオフセットです。
エラーの場合に FALSE、その他の場合にシーク位置を返します。
</para>
@@ -1413,10 +1465,10 @@
</funcprototype>
</funcsynopsis>
<para>
- SLOB オブジェクトから n バイト読みこみます。
- <parameter>bid</parameter> は存在する SLOB ID であり、
- <parameter>nbytes</parameter> は読みこむバイト数です。
- エラーの場合に FALSE、その他の場合にその文字列を返します。
+ SLOB オブジェクトから n バイト読みこみます。
+ <parameter