Index: phpdoc/ja/functions/array.xml diff -u phpdoc/ja/functions/array.xml:1.25 phpdoc/ja/functions/array.xml:1.26 --- phpdoc/ja/functions/array.xml:1.25 Thu Apr 19 07:08:53 2001 +++ phpdoc/ja/functions/array.xml Fri Apr 27 19:20:55 2001 @@ -348,6 +348,184 @@ + + + array_map + 指定した配列の要素にコールバック関数を適用する + + + 説明 + + + array array_map + mixed callback + array arr1 + array + arr2... + + + + + array_map は、arr1の + 各要素にコールバック関数を適用した後、その全ての要素を含む要素を + 返します。コールバック関数が受け付けるパラメータの数は、 + array_mapに渡される配列の数に一致している必 + 要があります。 + + + + <function>array_map</function> の例 + +function cube($n) { + return $n*$n*$n; +} + +$a = array(1, 2, 3, 4, 5); +$b = array_map("cube", $a); + + + + + この例により $bには、array (1, 8, 27, + 64, 125);が代入されます。 + + + + <function>array_map</function> - より多くの配列を使用 + +function show_Spanish($n, $m) { + return "The number $n is called $m in Spanish"; +} + +function map_Spanish($n, $m) { + return array ($n => $m); +} + +$a = array(1, 2, 3, 4, 5); +$b = array("uno", "dos", "tres", "cuatro", "cinco"); + +$c = array_map("show_Spanish", $a, $b); + +print_r($c); + +// 出力: +// Array +// ( +// [0] => The number 1 is called uno in Spanish +// [1] => The number 2 is called dos in Spanish +// [2] => The number 3 is called tres in Spanish +// [3] => The number 4 is called cuatro in Spanish +// [4] => The number 5 is called cinco in Spanish +// ) + +$d = array_map("map_Spanish", $a , $b); + +print_r($d); + +// 出力: +// Array +// ( +// [0] => Array +// ( +// [1] => uno +// ) +// +// [1] => Array +// ( +// [2] => dos +// ) +// +// [2] => Array +// ( +// [3] => tres +// ) +// +// [3] => Array +// ( +// [4] => cuatro +// ) +// +// [4] => Array +// ( +// [5] => cinco +// ) +// +// ) + + + + + 通常、二つ以上の配列を使用する場合、それらの長さは等しい必要があ + ります。これは、コールバック関数が対応する要素に対して並行して適 + 用されるためです。配列の長さが等しくない場合、最も短い配列は空の + 要素で拡張されます。 + + + この関数の面白い使用方法として、配列の配列を構築するというものが + あります。これは、コールバック関数の名前として + nullを使用することにより、簡単に実行できるもの + です。 + + + + <function>array_map</function> - 配列の配列を作成する + +$a = array(1, 2, 3, 4, 5); +$b = array("one", "two", "three", "four", "five"); +$c = array("uno", "dos", "tres", "cuatro", "cinco"); + +$d = array_map(null, $a, $b, $c); +print_r($d); + +// 出力: +// Array +// ( +// [0] => Array +// ( +// [0] => 1 +// [1] => one +// [2] => uno +// ) +// +// [1] => Array +// ( +// [0] => 2 +// [1] => two +// [2] => dos +// ) +// +// [2] => Array +// ( +// [0] => 3 +// [1] => three +// [2] => tres +// ) +// +// [3] => Array +// ( +// [0] => 4 +// [1] => four +// [2] => cuatro +// ) +// +// [4] => Array +// ( +// [0] => 5 +// [1] => five +// [2] => cinco +// ) +// +// ) + + + + + array_filter, + array_reduceも参照下さい。 + + + + array_merge Index: phpdoc/ja/functions/bzip2.xml diff -u phpdoc/ja/functions/bzip2.xml:1.2 phpdoc/ja/functions/bzip2.xml:1.3 --- phpdoc/ja/functions/bzip2.xml:1.2 Tue Feb 20 07:12:19 2001 +++ phpdoc/ja/functions/bzip2.xml Fri Apr 27 19:20:55 2001 @@ -131,6 +131,7 @@ $str = "sample data"; $bzstr = bzcompress($str, 9); +print $bzstr; @@ -170,7 +171,17 @@ <function>bzdecompress</function> -$str = $bzdecompress($bzstr); +$start_str = "This is not an honest face?"; +$bzstr = bzcompress($start_str); + +print "Compressed String: "; +print $bzstr; +print "\n<br>n"; + +$str = bzdecompress($bzstr); +print "Decompressed String: "; +print $str; +print "\n<br>n"; @@ -327,6 +338,12 @@ <function>bzopen</function> の例 $bz = bzopen("/tmp/foo.bz2", "r"); +$decompressed_file = bzread($bz, filesize("/tmp/foo.bz2")); +bzclose($bz); + +print "The contents of /tmp/foo.bz2 are: "; +print "\n<br>n"; +print $decompressed_file; @@ -369,7 +386,7 @@ $bz = bzopen("/tmp/foo.bz2", "r"); $str = bzread($bz, 2048); -echo $str; +print $str; @@ -413,6 +430,7 @@ $str = "uncompressed data"; $bz = bzopen("/tmp/foo.bz2", "w"); bzwrite($bz, $str, strlen($str)); +bzclose($bz); Index: phpdoc/ja/functions/datetime.xml diff -u phpdoc/ja/functions/datetime.xml:1.24 phpdoc/ja/functions/datetime.xml:1.25 --- phpdoc/ja/functions/datetime.xml:1.24 Thu Apr 19 07:08:53 2001 +++ phpdoc/ja/functions/datetime.xml Fri Apr 27 19:20:55 2001 @@ -315,7 +315,7 @@ - "wday" - 曜日、数字 + "wday" - 曜日、数字: 0が日曜、6が土曜日 Index: phpdoc/ja/functions/dbase.xml diff -u phpdoc/ja/functions/dbase.xml:1.2 phpdoc/ja/functions/dbase.xml:1.3 --- phpdoc/ja/functions/dbase.xml:1.2 Sat Jun 24 00:38:44 2000 +++ phpdoc/ja/functions/dbase.xml Fri Apr 27 19:20:55 2001 @@ -4,192 +4,210 @@ - これらの関数は、dBase 形式(dbf)のデータベースに保存されたレコードに - アクセスすることを可能にします。 + これらの関数は、dBase 形式(dbf)のデータベースに保存されたレコード + にアクセスすることを可能にします。 + - これらの関数では、インデックスおよびメモフィールドのサポートは行われません。 - ロックのサポートも行われません。 - 二つの Web サーバープロセスが同時に同じ dBase ファイルを修正しようとした場合、 - データベースはほぼ確実に駄目になってしまうでしょう。 - - SQL データベースと異なり、dBase "databases" はデータベース定義を - 後で変更することが出来ません。 - 検索を高速化したりデータを体系化するようなインデックスはありません。 - dBase ファイルは、簡単な固定レコード長の連続ファイルです。 - レコードはファイルの終端に付加され、削除されたレコードは - dbase_pack() をコールするまで保持されています。 + これらの関数では、インデックスおよびメモフィールドのサポートは行わ + れません。ロックのサポートも行われません。二つの Web サーバープロ + セスが同時に同じ dBase ファイルを修正しようとした場合、データベー + スはほぼ確実に駄目になってしまうでしょう。 + + + dBaseファイルは、固定長の単純なシーケンシャルファイルです。レコー + ドは、ファイルの終りに追加され、削除されたレコードは + dbase_packがコールされるまで保持されます。 + 商用データベースとして dBase ファイルを使用するべきではありません。 - 本物の SQL サーバーを替わりに選んで下さい。通常、MySQL または Postgres - が PHP で使用されています。 - dBase ファイルフォーマットは Windows の表計算ソフトや統合ソフトで - 通常サポートされているので、 - dBase サポートにより Web データベースとのデータのインポート/エクスポート - が可能となります。 - dBase サポートが有用なのは、データのインポート/エクスポート機能に - 限定されるでしょう。 + 本物の SQL サーバーを替わりに選んで下さい。通常、MySQL または + Postgresが PHP で使用されています。dBase ファイルフォーマットは + Windows の表計算ソフトや統合ソフトで通常サポートされているので、 + dBase サポートにより Web データベースとのデータのインポート/エクス + ポートが可能となります。 + dbase_create - dBase データベースを作成します + dBase データベースを作成する 説明 int dbase_create - string ファイル名 - array フィールド + string filename + array fields - フィールド パラメータは、配列の配列です。 - 各配列は、データベースにおける一つのフィールドのフォーマット - を記述します。 - 各フィールドは、名前、フィールド型、長さ、精度を示す文字から構成されます。 - - 利用可能なフィールド型は次のようになります。 - - - L - - 論理値。長さも精度もありません。 - - - M - - メモ。(PHP ではサポートされないことに注意して下さい。) - 長さも精度もありません。 - - - D - - 日付(Date) (YYYYMMDD という形式で保持されます)。 - 長さも精度もありません。 - - - N - - 番号(Number)。長さおよび精度(小数点以下の桁数)を有します。 - - - C - - 文字列。 - - - - データベースの作成に成功した場合、dbase ID が返されます。 - 失敗した場合は、false が返されます。 - - - dBase データベースファイルを作成する - - // データベース名 - $dbname = "/tmp/test.dbf"; - - // データベースの定義 - $def = - array( - array("date", "D"), - array("name", "C", 50), - array("age", "N", 3, 0), - array("email", "C", 128), - array("ismember", "L") - ); + fields パラメータは、配列の配列です。各配 + 列は、データベースにおける一つのフィールドのフォーマットを記述し + ます。各フィールドは、名前、フィールド型、長さ、精度を示す文字か + ら構成されます。 + + + 利用可能なフィールド型は次のようになります。 + + + L + + + 論理値。長さも精度もありません。 + + + + + M + + + メモ。(PHP ではサポートされないことに注意して下さい。) + 長さも精度もありません。 + + + + + D + + + 日付(Date) (YYYYMMDD という形式で保持されます)。 + 長さも精度もありません。 + + + + + N + + + 番号(Number)。長さおよび精度(小数点以下の桁数)を有します。 + + + + + C + + + 文字列。 + + + + + + データベースの作成に成功した場合、dbase ID が返されます。失敗した + 場合は、false が返されます。 + + dBase データベースファイルを作成する + +// データベース名 +$dbname = "/tmp/test.dbf"; - // 作成 - if (!dbase_create($dbname, $def)) - print "<strong>Error!</strong>"; +// データベースの定義 +$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>"; + + + + dbase_open - dBase データベースをオープンします + dBase データベースをオープンする 説明 int dbase_open - string ファイル名 - int フラグ + string filename + int flags + + フラグは、open() システムコールにおけるフラグに対応します。 + (通常、0 は読込のみ可、1 は書込のみ可、2 は読み書きを意味します) + - フラグは、open() システムコールにおけるフラグに対応します。 - (通常、0 は読込のみ可、1 は書込のみ可、2 は読み書きを意味します) - - オープンされたデータベースの dbase ID を返します。 - データベースをオープンできなかった場合は、FALSE を返します。 + オープンされたデータベースの dbase ID を返します。 + データベースをオープンできなかった場合は、FALSE を返します。 + dbase_close - dBase データベースを閉じます + dBase データベースを閉じる 説明 bool dbase_close - int dbase ID + int dbase_identifier - dbase ID - が指すデータベースを閉じます。 + dbase_identifierが指すデータベースを閉じま + す。 + dbase_pack - dBase データベースをパックします + dBase データベースをパックする 説明 bool dbase_pack - int dbase ID + int dbase_identifier - 指定されたデータベースをパックします。 - (dbase_delete_record を用いて削除指定を - 行った全てのレコードの削除を実際に行います。) + 指定されたデータベースをパックします。 + (dbase_delete_record を用いて削除指定を行っ + た全てのレコードの削除を実際に行います。) + dbase_add_record - dBase データベースにレコードを追加します + dBase データベースにレコードを追加する 説明 bool dbase_add_record - int dbase ID - array レコード + int dbase_identifier + array record - record のデータを - データベースに追加します。 - 指定したレコード中の項目数が、データベース中のフィールド数と - 等しくない場合、処理は失敗し、FALSE が返されます。 + record のデータをデータベースに追加します。 + 指定したレコード中の項目数が、データベース中のフィールド数と等し + くない場合、処理は失敗し、FALSE が返されます。 + @@ -209,68 +227,75 @@ - データベースのレコードrecord_numberが指すデータを - recordのデータで置換します。指定したレコードの - 項目数がデータベースのフィールド数に等しくない場合、操作は失敗し、 - FALSEが返されます。 - + データベースのレコードrecord_numberが指す + データをrecordのデータで置換します。指定し + たレコードの項目数がデータベースのフィールド数に等しくない場合、 + 操作は失敗し、FALSEが返されます。 + - dbase_record_number は1からデータベースのレコード数 - までの範囲の整数となります。( - dbase_numrecordsにより返されます) + dbase_record_number は1からデータベースの + レコード数までの範囲の整数となります。 + (dbase_numrecordsにより返されます) + dbase_delete_record - dBase データベースからレコードを削除します + dBase データベースからレコードを削除する 説明 bool dbase_delete_record - int dbase ID + int dbase_identifier int record - データベースから削除したいレコード record をマークします。 - 実際に削除を行うには、 - dbase_pack をコールする必要があります。 + データベースから削除したいレコード record + をマークします。実際に削除を行うには、 + dbase_pack をコールする必要があります。 + dbase_get_record - dBase データベースからレコードを得ます + dBase データベースからレコードを得る 説明 array dbase_get_record - int dbase ID + int dbase_identifier int record - record からのデータが配列に返されます。 - 配列の添字は 0から始まり、連想配列のメンバー 'deleted' を含んでいます。 - これには、そのレコードに削除指定が行われている場合に 1 がセットされます。 - (dbase_delete_record も参照下さい。) - - 各フィールドは、適当な PHP 型に変換されます。 - (日付は、文字列に変換されます。) + record からのデータが配列に返されます。配 + 列の添字は 0から始まり、連想配列のメンバー 'deleted' を含んでいま + す。これには、そのレコードに削除指定が行われている場合に 1 がセッ + トされます。(dbase_delete_record も参照下さ + い。) + + + 各フィールドは、適当な PHP 型に変換されます。(日付は、文字列に変 + 換されます。) + dbase_get_record_with_names - dBaseデータベースからレコードを連想配列として得る + + dBaseデータベースからレコードを連想配列として得る + 説明 @@ -281,64 +306,72 @@ int record - - - record からデータを連想配列として返します。 - 配列は、レコードに削除のマークが付けられている場合は、連想配列に - メンバー'deleted'が付加され、その値は1となります。 - (dbase_delete_recordを参照下さい。) - 各フィールドは、適当な PHP 型に変換されます。 - (日付は、文字列に変換されます。) + record からデータを連想配列として返します。 + 配列は、レコードに削除のマークが付けられている場合は、連想配列に + メンバー'deleted'が付加され、その値は1となります。 + (dbase_delete_recordを参照下さい。) + + + 各フィールドは、適当な PHP 型に変換されます。(日付は、文字列に変 + 換されます。) + dbase_numfields - dBase データベースにおけるフィールド数を返します + + dBase データベースにおけるフィールド数を返す + 説明 int dbase_numfields - int dbase ID + int dbase_identifier - 指定したデータベースにおけるフィールド(カラム)数を返します。 - フィールド番号は 0 から dbase_numfields($db)-1 まで、 - レコード番号は 1 から dbase_numrecords($db) までです。 + 指定したデータベースにおけるフィールド(カラム)数を返します。フィー + ルド番号は 0 から dbase_numfields($db)-1 まで、レコード番号は 1 + から dbase_numrecords($db) までです。 <function>dbase_numfields</function> の使用法 - $rec = dbase_get_record($db, $recno); - $nf = dbase_numfields($db); - for ($i=0; $i < $nf; $i++) { - print $rec[$i]."<br>\n"; - } - +$rec = dbase_get_record($db, $recno); +$nf = dbase_numfields($db); +for ($i=0; $i < $nf; $i++) { + print $rec[$i]."<br>\n"; +} + + + dbase_numrecords - dBase データベースにおけるレコード数を返します + + dBase データベースにおけるレコード数を返す + 説明 int dbase_numrecords - int dbase ID + int dbase_identifier - 指定したデータベースにレコード(行)数を返します。 - レコード番号は 1 から dbase_numrecords($db) まで、 - フィールド番号は 0 から dbase_numfields($db)-1 までです。 + 指定したデータベースにレコード(行)数を返します。レコード番号は 1 + から dbase_numrecords($db) まで、フィールド番号は 0 から + dbase_numfields($db)-1 までです。 + @@ -354,7 +387,7 @@ sgml-indent-step:1 sgml-indent-data:t sgml-parent-document:nil -sgml-default-dtd-file:"../manual.ced" +sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil Index: phpdoc/ja/functions/imap.xml diff -u phpdoc/ja/functions/imap.xml:1.18 phpdoc/ja/functions/imap.xml:1.19 --- phpdoc/ja/functions/imap.xml:1.18 Thu Apr 12 08:30:00 2001 +++ phpdoc/ja/functions/imap.xml Fri Apr 27 19:20:55 2001 @@ -32,13 +32,13 @@ - RFC821 : + RFC2821 : Simple Mail Transfer Protocol (SMTP) - RFC822 : + RFC2822 : Standard for ARPA internet text messages @@ -834,7 +834,7 @@ この関数は、指定したメッセージのヘッダーを完全でフィルターリング - されていないRFC822フォー + されていないRFC2822フォー マットのテキスト文字列として取得し、テキスト文字列を返します。 @@ -2145,7 +2145,7 @@ - この関数は、RFC822 + この関数は、RFC2822 の定義に基づきアドレス文字列を解釈し、各アドレス毎にオブジェクトの 配列を返します。4 つのオブジェクトは、以下のようになります。 Index: phpdoc/ja/functions/mail.xml diff -u phpdoc/ja/functions/mail.xml:1.10 phpdoc/ja/functions/mail.xml:1.11 --- phpdoc/ja/functions/mail.xml:1.10 Sun Feb 18 15:29:44 2001 +++ phpdoc/ja/functions/mail.xml Fri Apr 27 19:20:55 2001 @@ -129,6 +129,13 @@ + + + 追加したパラメータあるいはsubjectパラメータの後に改行(または他の + 空白文字)を付加しないようにして下さい。この場合、おかしな結果に + なってしまう可能性があります。 + + Index: phpdoc/ja/functions/ming.xml diff -u phpdoc/ja/functions/ming.xml:1.3 phpdoc/ja/functions/ming.xml:1.4 --- phpdoc/ja/functions/ming.xml:1.3 Thu Apr 19 07:08:53 2001 +++ phpdoc/ja/functions/ming.xml Fri Apr 27 19:20:55 2001 @@ -2523,13 +2523,13 @@ ンプレートファイルから作成することが可能です。 - ブラウザで定義されたフォントには、フォント名以外のフォント情報g含 + ブラウザで定義されたフォントには、フォント名以外のフォント情報が含 まれていません。フォント定義は、ムービープレイヤーに提供されると 仮定します。フォント _serif, _sans, _typewriter は、常に使用可能 です。例えば、 <?php -$f = newSWFFont("_sans"); +$f = new SWFFont("_sans"); ?> により、標準的な sans-serif フォントが指定されます。これは、HTML Index: phpdoc/ja/functions/ovrimos.xml diff -u phpdoc/ja/functions/ovrimos.xml:1.3 phpdoc/ja/functions/ovrimos.xml:1.4 --- phpdoc/ja/functions/ovrimos.xml:1.3 Thu Mar 1 07:24:45 2001 +++ phpdoc/ja/functions/ovrimos.xml Fri Apr 27 19:20:55 2001 @@ -165,8 +165,8 @@ ovrimos_longreadlen は、long データ型(long varcharとlong varbinary))から取得されるバイト数を指定します。デフォ ルトはゼロです。引数として特定の result_id をとりますが、この関数 - は現在このパラメータを全てのクエリ結果に設定します。trueを返しま - す。 + は現在このパラメータを全てのクエリ結果に設定します。 + TRUEを返します。 @@ -234,7 +234,7 @@ 説明 - int ovrimos_execute + boolean ovrimos_execute int result_id array @@ -249,7 +249,8 @@ ovrimos_execute は準備された命令を実行します。 - trueまたはfalseを返します。準備された命令がパラメータ(命令の中の + TRUEまたはFALSEを返します。 + 準備された命令がパラメータ(命令の中の 疑問符)を有する場合、正しい数のパラメータを配列で指定する必要があ りあmす。オプションのパラメータの名前を角括弧の中に置くPHPの流儀 に従っていないことに注意して下さい。リンクする際にはこのようにし @@ -317,7 +318,7 @@ 説明 - int ovrimos_fetch_into + boolean ovrimos_fetch_into int result_id array result_array string @@ -345,7 +346,7 @@ 先頭から前方、終端から後方、先頭から絶対位置('first'と本質的に等 価ですが、'rownumber'が必要)となります。大文字小文字は関係ありま せん。'rownumber'は絶対位置を指定する場合以外はオプションです。 - trueまたはfalseを返します。 + TRUEまたはFALSEを返します。 @@ -391,7 +392,7 @@ 説明 - int ovrimos_fetch_row + boolean ovrimos_fetch_row int result_id int @@ -411,8 +412,8 @@ ovrimos_fetch_row は結果からレコードを取得し - ます。カラムの値は、別の関数により取得する必要があります。trueま - たはfalseを返します。 + ます。カラムの値は、別の関数により取得する必要があります。 + TRUEまたはFALSEを返します。 @@ -487,7 +488,7 @@ 説明 - int ovrimos_result_all + boolean ovrimos_result_all int result_id string @@ -502,7 +503,8 @@ ovrimos_result_all は結果をHTMLとして出力し - ます。trueまたはfalseを返します。 + ます。TRUEまたはFALSEを返し + ます。 @@ -707,8 +709,10 @@ めに使用されます。 - ovrimos_field_len は(1から始まる)指定したフィー - ルド番号の出力カラムの長さを返します。 + ovrimos_field_len は、結果ID + result_id の(1から始まる)指定したフィール + ド番号 field_number の出力カラムの長さを返 + します。 @@ -758,8 +762,9 @@ ために使用されます。 - ovrimos_free_result は指定した result_id を - 開放します。trueを返します。 + ovrimos_free_result は指定した結果 + IDresult_idを開放します。 + TRUEを返します。 Index: phpdoc/ja/functions/strings.xml diff -u phpdoc/ja/functions/strings.xml:1.33 phpdoc/ja/functions/strings.xml:1.34 --- phpdoc/ja/functions/strings.xml:1.33 Thu Apr 19 07:08:53 2001 +++ phpdoc/ja/functions/strings.xml Fri Apr 27 19:20:55 2001 @@ -1417,6 +1417,11 @@ 前に '<br />' を挿入して返します。 + PHP 4.0.5より前の nl2br は、 + stringの全ての改行記号の前に'<br>'を + 挿入して返します。 + + htmlspecialcharshtmlentitieswordwrap も参照下さい。 Index: phpdoc/ja/functions/var.xml diff -u phpdoc/ja/functions/var.xml:1.25 phpdoc/ja/functions/var.xml:1.26 --- phpdoc/ja/functions/var.xml:1.25 Thu Mar 22 07:48:05 2001 +++ phpdoc/ja/functions/var.xml Fri Apr 27 19:20:55 2001 @@ -826,8 +826,8 @@ 説明 - int settype - string var + boolean settype + mixed var string type @@ -836,9 +836,10 @@ type にセットします。 - type の値は令؋のいずれかです。 + type の値は以下の命令のいずれかです。 + "boolean" "integer" "double" "string" @@ -848,6 +849,18 @@ 成功すればtrue、そうでなければfalseを返します。 + + + + <function>settype</function> の例 + +$foo = "5bar"; // string +$bar = true; // boolean + +settype($foo, "integer"); // ここでは、$foo は 5です (整数) +settype($bar, "string"); // ここでは、$bar は "1" です (文字列) + + gettype も参照下さい。