From 5f0376f9af9f6a200f4996128a6ff29c56b7bf14 Mon Sep 17 00:00:00 2001 From: Haruki Tazoe <40142697+jdkfx@users.noreply.github.com> Date: Sat, 16 Nov 2024 21:31:04 +0900 Subject: [PATCH] =?UTF-8?q?language-snippets.ent=E3=81=AE=E7=BF=BB?= =?UTF-8?q?=E8=A8=B3=20(#161)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * session.sid_lengthとsession.sid_bits_per_characterの非推奨について追記 * feature-8-4-0, function-8-4-0, outputs.84, outputs.84.similar * dba.parameter.dba dba.changelog.dba-object * Memcached::RES_ * setWarningCallbackについて追記 * 既存の翻訳に合わせる * mbstring関数関連のものを追記 * Mongo関連を削除 * xml_set_関連のものを追記 * EN-Revision変更忘れ * 読みやすい文章にする Co-authored-by: KentarouTakeda * いらない改行を消す Co-authored-by: KentarouTakeda --------- Co-authored-by: KentarouTakeda --- language-snippets.ent | 366 +++++++++++++++++++++++++++++++++--------- 1 file changed, 288 insertions(+), 78 deletions(-) diff --git a/language-snippets.ent b/language-snippets.ent index 325ffb0b9c..14dfbb83f6 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,7 +1,7 @@ - - + + @@ -346,6 +346,14 @@ xmlns="http://docbook.org/ns/docbook">この機能は PHP 8.3.0 で xmlns="http://docbook.org/ns/docbook">この関数は PHP 8.3.0 で 非推奨になります。この関数に頼らないことを強く推奨します。'> +この機能は PHP 8.4.0 で +非推奨になります。この機能に頼らないことを強く推奨します。'> + +この関数は PHP 8.4.0 で +非推奨になります。この関数に頼らないことを強く推奨します。'> + きっと 将来 削除 されるでしょう。'> @@ -600,6 +608,10 @@ xmlns="http://docbook.org/ns/docbook">この関数は PHP 8.1.0 で 上の例の PHP 8.3 での出力は、たとえば以下のようになります。:'> +上の例の PHP 8.4 での出力は、このようになります。:'> + +上の例の PHP 8.4 での出力は、たとえば以下のようになります。:'> + 上の例の 32 ビットマシンでの出力は、このようになります。'> 上の例の 64 ビットマシンでの出力は、このようになります。'> @@ -1093,6 +1105,15 @@ $font = 'SomeFont'; '> + +dba_open または dba_popen によって返される Dba\Connection インスタンス'> + + 8.4.0 + + dba は Dba\Connection クラスのインスタンスを期待するようになりました。 + これより前のバージョンでは、 dba &resource; を期待していました。 + +'> @@ -1381,7 +1402,7 @@ STREAM モードのいくつかのアルゴリズムの初期化の際に使用 それぞれの要素には、 対応するキーが削除された場合に &true; が入ります。 対応するキーの削除が失敗した場合、 - 定数 Memcached::RES_* のうちの一つが入ります。 + 定数 Memcached::RES_* のうちの一つが入ります。 Memcached::getResultCode は、 @@ -1466,6 +1487,47 @@ STREAM モードのいくつかのアルゴリズムの初期化の際に使用 + + callback + + + 呼び出す関数またはメソッド。有効な Gearmanの値 を返す必要があります。 + + + return 文が存在しない場合、デフォルトで GEARMAN_SUCCESS が返されます。 + + + intcallback + GearmanTasktask + mixedcontext + + + + task + + + このコールバックが呼び出されるタスク。 + + + + + context + + + GearmanClient::addTask (または同等のメソッド) に context として渡されたもの。 + + + + + +'> + + + + このコールバックは、このメソッドを呼び出した後に追加されたタスク（例: GearmanClient::addTask を呼び出して追加されたタスク）に対してのみ実行されます。 + +'> + サポートされるタイムゾーンのリスト'> @@ -3600,79 +3662,6 @@ local: { tagThe attribute tag. This parameter is ignored unless the RADIUS_OPTION_TAGGED option is set.'> vendorThe vendor ID.'> - -read_preference読み込みの優先モード。MongoClient::RP_PRIMARY、MongoClient::RP_PRIMARY_PREFERRED、MongoClient::RP_SECONDARY、MongoClient::RP_SECONDARY_PREFERRED あるいは MongoClient::RP_NEAREST のいずれか。tagsゼロ個以上のタグセットの配列。各タグセット自体も配列で、レプリカセットのメンバーのタグにマッチさせる条件として使います。'> -成功した場合に &true;、それ以外の場合に &false; を返します。'> -パラメータが無効な場合、あるいは優先読み込みモードが MongoClient::RP_PRIMARY のときにタグセットを指定した場合に E_WARNING が発生します。'> -この関数は、優先読み込みに関する配列を返します。配列に含まれる内容は、type (優先読み込みモードを表す文字列。MongoClient の定数に対応)、そして tagsets (すべてのタグセット条件のリスト) です。タグセットを指定しなかった場合は、tagsets は存在しません。'> -w書き込み確認。何台のサーバーに書き込めたら成功とみなすのかを表す整数値、あるいは文字列 ("majority" など) でモードを指定します。wtimeoutサーバーが書き込み確認を待つ最大ミリ秒数。'> -成功した場合に &true;、それ以外の場合に &false; を返します。'> -w が整数値あるいは文字列でない場合に E_WARNING が発生します。'> -この関数は、書き込み確認を表す配列を返します。w の値はサーバーの台数を表す整数値かモードを表す文字列、そして wtimeout の値はサーバーが書き込み確認を待つ最大ミリ秒数です。'> -"maxTimeMS"サーバー上で操作を行う累積時間の制限 (アイドル時間を含まない) を、ミリ秒単位で指定します。この時間内にサーバー側の操作が完了しなければ、MongoExecutionTimeoutException をスローします。'> -"background"Builds the index in the background so that building an index does not block other database activities. Specify &true; to build in the background. The default value is &false;.Prior to MongoDB 2.6.0, index builds on secondaries were executed as foreground operations, irrespective of this option. See Building Indexes with Replica Sets for more information.'> -"dropDups"&true; を指定すると、一意なインデックスを強制的に作成します。このとき、コレクション内でキーの値が重複してしまう可能性があります。MongoDB は最初に出現したキーをインデックスし、それ以降に出現する同じキーのすべてのドキュメントを削除します。デフォルト値は &false; です。"dropDups" はデータベースのデータを削除することがあるので、使う際には十分な注意が必要です。このオプションは、MongoDB 2.8 以降には対応していません。コレクションに値の重複がある場合は、インデックスの作成に失敗します。'> -"expireAfterSeconds"このオプションの値に指定するのは、ドキュメントを有効期限切れとみなしてコレクションから自動削除するまでの秒数です。このオプションが使えるのは、単一フィールドインデックスで、フィールドに MongoDate の値を含む場合のみです。この機能が使えるのは、MongoDB 2.2 以降です。詳細は Expire Data from Collections by Setting TTL を参照ください。'> -"name"オプションの、インデックスを一意に特定するための名前。ドライバーがデフォルトで生成するインデックス名は、インデックスのフィールドと、並び順あるいは型に基づくものです。たとえば、複合インデックス array("x" => 1, "y" => -1) の名前は "x_1_y_-1" であり、地理空間インデックス array("loc" => "2dsphere") の名前は "loc_2dsphere" となります。多数のフィールドからなるインデックスの場合、自動生成される名前が MongoDB の インデックス名の制限 を超えてしまう可能性があります。"name" オプションは、そんな場合に短い名前を用意するときなどに使えます。'> -"sparse"&true; を指定すると、疎なインデックスを作ります。これは、指定したフィールドを含むドキュメントだけをインデックスします。デフォルト値は &false; です。'> -"unique"&true; を指定すると、一意なインデックスを作ります。デフォルト値は &false; です。このオプションを使えるのは、昇順もしくは降順のインデックスだけです。MongoDB がフィールドをインデックスするとき、もしそのフィールドに値を含まないドキュメントがあれば、&null; 値をインデックスします。このフィールドを含まないドキュメントが複数あった場合、一意なインデックスは、最初に出現したドキュメント以外を受け付けません。これを防ぐには "sparse" オプションを使います。このオプションを指定すれば、インデックス対象のフィールドが存在しないドキュメントはインデックスしなくなります。'> -このメソッドは、MongoDB 2.8 以降と通信する際に、データベースコマンド listCollections を利用します。以前のバージョンのデータベースの場合は、特別なコレクション system.namespaces を問い合わせます。'> -"filter"オプションの問い合わせ条件。これを指定すると、結果に含まれるコレクションをその条件でフィルタリングします。問い合わせの対象となる関連フィールドには、"name" (コレクション名を表す文字列。データベース名のプレフィックスは含まない) や "options" (コレクションを作成するために用いるオプションを含むオブジェクト) があります。MongoDB 2.6 以前のバージョンでは、"name" の条件指定には文字列しか使えませんでした (一致する文字列だけに絞り込むなど)。これは、ドライバが system.namespaces コレクションに問い合わせるときに、その値をデータベース名の先頭に付加する必要があったからです。最新版の MongoDB にはこの制約がなくなりました。listCollections コマンドを使うようになったからです。'> -"includeSystemCollections"Boolean で、デフォルトは &false; です。system コレクションを結果に含めるかどうかを指定します。'> - -"w" -WriteConcerns を参照ください。MongoClient でのデフォルト値は 1 です。 -'> -"wtimeout"廃止予定。"wTimeoutMS" のエイリアスです。'> -"wTimeoutMS"このオプションは、書き込み確認を待つ制限時間をミリ秒単位で指定します。これが書き込み操作に適用されるのは、"w" が 1 より大きい場合のみです。というのも、タイムアウトはレプリケーションに関する機能だからです。この時間内に書き込み確認ができなかった場合は MongoCursorException をスローします。0 を指定すると、永遠にブロックし続けます。MongoClient でのデフォルトは 10000 ミリ秒 (10 秒) です。'> -"fsync" -Boolean 型で、デフォルトは &false; です。 -ジャーナリングが有効な場合、これは "j" とまったく同じ動きをします。 -ジャーナリングが有効でない場合は、追加をディスク上のデータベースファイルに同期させるまで成功したと見なさないようになります。 -&true; にすると確認つき書き込みが暗黙のうちに設定され、"w" の値を 0 にします。 - -ジャーナリングが有効な場合は、"fsync" のかわりに "j" を使いましょう。 -"fsync" と "j" を同時に指定すると、エラーになります。 -'> -"socketTimeoutMS"このオプションは、ソケット通信の制限時間を、ミリ秒単位で指定します。この時間内にサーバーからの反応がなければ、MongoCursorTimeoutException をスローします。この場合、サーバー側で書き込み処理が行われたのかどうかを判断できなくなります。-1 を指定すると、永遠にブロックします。MongoClient のデフォルト値は 30000 (30 秒) です。'> -"j"デフォルトは &false; です。これを指定すると、追加をジャーナルに同期させるまで成功したと見なさないようになります。&true; にすると確認付き書き込みと見なされ、"w" の設定を 0 に上書きします。このオプションを使っているときにジャーナリングを無効にすると、MongoDB 2.6 以降ではエラーが発生して書き込みに失敗します。古いバージョンのサーバーでは、単純にオプションの指定を無視します。'> -"safe"非推奨。write concern の w オプションを使いましょう。'> -"timeout"非推奨。"socketTimeoutMS" のエイリアス。'> -"w" オプションが設定されていて書き込みが失敗した場合に MongoCursorException をスローします。"w" オプションの値が 1 より大きく設定されていて、操作の完了までの時間が MongoCursor::$timeout ミリ秒をこえた場合に MongoCursorTimeoutException をスローします。サーバー上での操作は止めません。これはクライアント側でのタイムアウトです。MongoCollection::$wtimeout はミリ秒です。'> -E_DEPRECATED が発生します。'> -これらのフィールドは、ドライバが自動生成したフィールドも上書きします。詳しい説明は、MongoDB コアドキュメントの files collection を参照ください。この挙動の現実的な使い道としては、ファイルの chunkSize や _id を独自に指定する場合などがあります。'> -格納したファイルドキュメントの _id を返します。metadata パラメータで _id を明示的に指定していない場合は、自動生成した MongoId となります。'> -書き込みオプションの配列。キー値w (int|string)WriteConcern の値wtimeout (int)レプリケーションを待つ時間の最大値orderedMongoDB にこのバッチを順番どおりに実行させるのかどうかを指定する。順番どおりの書き込みはシリアルに (一度に一行ずつ) 実行され、最初にエラーが発生した時点で実行は中断する。順番どおりでない書き込みはパラレルに実行され、エラーが発生しても処理は中断しない。デフォルトは &true;j (bool)プライマリーへのジャーナリングを待つかどうか。これは非推奨なので、かわりに確認付き書き込みを使うことfsync (bool)プライマリーへの fsync を待つかどうか。これは非推奨なので、かわりに確認付き書き込みを使うこと'> -バッチを実行する MongoCollection。確認付き書き込み をコピーして、デフォルトとして使います。$write_options で指定したり、MongoWriteBatch::execute で指定したりすることもできます。'> - server 選んだサーバーについての基本情報を含む配列。キー値hashハーバーハッシュ。例：localhost:27017;-;X;56052typeノード型 (primary/secondary/mongos/arbiter)。例：2max_bson_sizeこのノードがネットワーク越しに受け付ける BSON の最大サイズ。例：16777216max_message_sizeこのノードがネットワーク越しに受け入れるメッセージの最大サイズ。例：48000000request_idこのメッセージのリクエスト識別子。例：42'> - writeOptions キー値orderedboolean で、バッチ操作をシーケンシャルに行う必要がある (orderd = true) かどうかを表します。writeConcern書き込み確認のオプションの配列 (以下を参照ください)書き込み確認の配列の値キー値fsyncboolean で、強制的にディスクへのフラッシュをしてから返します。jboolean で、強制的にジャーナルに書き出してから返します。wtimeoutinteger で、プライマリがレプリケーションの検証までに待つ最大の時間をミリ秒で指定します。winteger でサーバー数、あるいは文字列でレプリケーションタグを指定します。
'> - protocolOptions キー値message_lengthネットワーク越しに送信するエンコード済みメッセージのサイズ (バイト数)。request_idこのメッセージのリクエスト識別子。例：42namespaceプロトコルメッセージに使う、MongoDB 名前空間。例：dbname.collectionname'> -このクラスを定義している拡張モジュールは非推奨です。 -かわりに MongoDB 拡張モジュールを使うべきです。 -このクラスの代替として、以下が使えます。'> -このクラスを定義している拡張モジュールは非推奨です。 -かわりに MongoDB 拡張モジュールを使うべきです。 -このクラスの代替は、新しい拡張モジュールには存在しません。'> -このメソッドを定義している拡張モジュールは非推奨です。 -かわりに MongoDB 拡張モジュールを使うべきです。 -このメソッドの代替として、以下が使えます。'> -このメソッドを定義している拡張モジュールは非推奨です。 -かわりに MongoDB 拡張モジュールを使うべきです。 -このメソッドの代替は、新しい拡張モジュールには存在しません。'> -このメソッドを定義している拡張モジュールは非推奨です。 -かわりに MongoDB 拡張モジュールを使うべきです。 -このメソッドの代替は、新しい拡張モジュールには存在しません。しかし、かわりに使える -PHP ライブラリ があります。'> - -この拡張モジュールは非推奨です。 -かわりに MongoDB 拡張モジュールを使うべきです。'> - @@ -4243,6 +4232,194 @@ local: { '> + + + + " ": ASCII の SP 文字 + 0x20 、通常のスペース。 + + + + + "\t": ASCII の HT 文字 + 0x09 、タブ。 + + + + + "\n": ASCII の LF 文字 + 0x0A 、改行（ラインフィード）。 + + + + + "\r": ASCII の CR 文字 + 0x0D 、キャリッジリターン。 + + + + + "\0": ASCII の NUL 文字 + 0x00 、NULバイト。 + + + + + "\v": ASCII VT 文字 + 0x0B 、垂直タブ。 + + + +'> + + + + + " " (Unicode U+0020)、通常のスペース。 + + + + + "\t" (Unicode U+0009)、タブ。 + + + + + "\n" (Unicode U+000A)、改行（ラインフィード）。 + + + + + "\r" (Unicode U+000D)、キャリッジリターン。 + + + + + "\0" (Unicode U+0000)、NULバイト。 + + + + + "\v" (Unicode U+000B)、垂直タブ。 + + + + + "\f" (Unicode U+000C)、フォームフィード。 + + + + + "\u00A0" (Unicode U+00A0)、ノーブレークスペース。もしくは、非分割スペース。 + + + + + "\u1680" (Unicode U+1680)、オガム文字（古代アイルランド語）用のスペース。 + + + + + "\u2000" (Unicode U+2000)、エンクアッド。アルファベット1文字分の幅を持つスペース。 + + + + + "\u2001" (Unicode U+2001)、エムクアッド。エンクアッドの2倍の幅を持つスペース。 + + + + + "\u2002" (Unicode U+2002)、エンスペース。エンクアッドと同じ幅のスペース。 + + + + + "\u2003" (Unicode U+2003)、エムスペース。エムクアッドと同じ幅のスペース。 + + + + + "\u2004" (Unicode U+2004)、エムスペースの3分の1の幅を持つスペース。 + + + + + "\u2005" (Unicode U+2005)、エムスペースの4分の1の幅を持つスペース。 + + + + + "\u2006" (Unicode U+2006)、エムスペースの6分の1の幅を持つスペース。 + + + + + "\u2007" (Unicode U+2007)、数字や図の間隔を整えるために使われるスペース。 + + + + + "\u2008" (Unicode U+2008)、句読点のためにデザインされたスペース。 + + + + + "\u2009" (Unicode U+2009)、シンスペース。非常に狭いスペース。 + + + + + "\u200A" (Unicode U+200A)、ヘアスペース。シンスペースよりもさらに細いスペース。 + + + + + "\u2028" (Unicode U+2028)、ラインセパレーター。行の区切りとして使用。 + + + + + "\u2029" (Unicode U+2029)、パラグラフセパレーター。段落の区切りとして使用。 + + + + + "\u202F" (Unicode U+202F)、ナローノーブレークスペース。通常の非分割スペースよりも狭く、ラテン文字や句読点の間で使用。 + + + + + "\u205F" (Unicode U+205F)、数式などで使われるスペース。 + + + + + "\u3000" (Unicode U+3000)、全角文字用のスペース。 + + + + + "\u0085" (Unicode U+0085)、次行（NEL）。 + + + + + "\u180E" (Unicode U+180E)、モンゴル語のテキスト内で母音を区切るために使用されるスペース。 + + + +'> + + 必要に応じて、削除する文字を characters パラメータで指定することもできます。 + 削除が必要なすべての文字を単純にリストとして記述してください。 + .. を使用することで、連続する文字の範囲を指定することも可能です。 + +'> + オプションの引数。文字を変換するときに使うエンコーディングを定義します。 @@ -4999,14 +5176,32 @@ xmlns="http://docbook.org/ns/docbook">この関数は、PECL uopz 5.0.0 '> - &null; や空文字列を渡すと、ハンドラはデフォルトの状態にリセットされます。 + &null; が渡されると、ハンドラはデフォルトの状態にリセットされます。 + + + 空文字列を渡すことでもハンドラはリセットされますが、これは PHP 8.4.0 以降非推奨となっています。 + + handler が callable の場合、その callable がハンドラとして設定されます。 handler が文字列の場合、xml_set_object で設定されたオブジェクトのメソッド名になります。 -'> + + + PHP 8.4.0 以降、非推奨となっています。 + + + + + + PHP 8.4.0 以降では、実際に呼び出されるときではなく、ハンドラを設定する際に callable であるかがチェックされます。 + 従って、コールバックとしてメソッド文字列を指定する場合、それより前に、 xml_set_object を呼び出しておく必要があります。 + しかし、この動作も PHP 8.4.0 以降非推奨となっているため、メソッドには適切な callable を使用することが推奨されます。 + + +'> parser @@ -5017,6 +5212,21 @@ xmlns="http://docbook.org/ns/docbook">この関数は、PECL uopz 5.0.0 '> + + 8.4.0 + + 非 callable な string を handler に渡すことは、現在非推奨となっています。 + メソッドには適切な callable を使用するか、ハンドラをリセットする場合は &null; を使用してください。 + + + + 8.4.0 + + handler が callable として有効であるかどうかは、 + 呼び出し時ではなく、ハンドラーを設定する際にチェックされるようになりました。 + +'> + 8.0.0