From a0fa513cae032cabe80b590f09c0de2ff2d8296c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?= Date: Sun, 14 Jun 2026 18:45:48 +0900 Subject: [PATCH 1/2] =?UTF-8?q?pcntl:=20QoS=20=E9=96=A2=E6=95=B0=E3=83=89?= =?UTF-8?q?=E3=82=AD=E3=83=A5=E3=83=A1=E3=83=B3=E3=83=88=E3=81=AE=E9=87=8D?= =?UTF-8?q?=E8=A4=87=E8=A7=A3=E6=B6=88=E3=81=AB=E8=BF=BD=E5=BE=93=EF=BC=88?= =?UTF-8?q?=E3=83=8F=E3=82=A4=E3=83=95=E3=83=B3=E7=89=88=E3=82=92=E7=BF=BB?= =?UTF-8?q?=E8=A8=B3=E3=83=BB=E3=82=A2=E3=83=B3=E3=83=80=E3=83=BC=E3=82=B9?= =?UTF-8?q?=E3=82=B3=E3=82=A2=E7=89=88=E3=82=92=E5=89=8A=E9=99=A4=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit doc-en PR #5609 (28192e830f) が pcntl_getqos_class / pcntl_setqos_class の ドキュメント重複（xml:id 同一の2組共存）を解消し、ハイフン名ファイルに統合・ アンダースコア名版を削除した。これに追従する。 - pcntl-getqos-class.xml / pcntl-setqos-class.xml を新規翻訳 （既存のアンダースコア版訳を土台に、統合後の正式版との差分のみ反映） - doc-en で対応の消えたアンダースコア版 pcntl_getqos_class.xml / pcntl_setqos_class.xml を削除 pcntl モジュールが完訳になる。 --- ...etqos_class.xml => pcntl-getqos-class.xml} | 9 +- .../pcntl/functions/pcntl-setqos-class.xml | 141 +++++++++++++++++ .../pcntl/functions/pcntl_setqos_class.xml | 143 ------------------ 3 files changed, 146 insertions(+), 147 deletions(-) rename reference/pcntl/functions/{pcntl_getqos_class.xml => pcntl-getqos-class.xml} (83%) create mode 100644 reference/pcntl/functions/pcntl-setqos-class.xml delete mode 100644 reference/pcntl/functions/pcntl_setqos_class.xml diff --git a/reference/pcntl/functions/pcntl_getqos_class.xml b/reference/pcntl/functions/pcntl-getqos-class.xml similarity index 83% rename from reference/pcntl/functions/pcntl_getqos_class.xml rename to reference/pcntl/functions/pcntl-getqos-class.xml index 15684bf589..16bf800d94 100644 --- a/reference/pcntl/functions/pcntl_getqos_class.xml +++ b/reference/pcntl/functions/pcntl-getqos-class.xml @@ -1,6 +1,6 @@ - + pcntl_getqos_class @@ -14,7 +14,7 @@ - QoS クラスを取得します。 + 現在のスレッドの Quality of Service (QoS) クラスを取得します。 この関数は、Apple のプラットフォームでのみ利用可能です。 @@ -29,7 +29,8 @@ &reftitle.returnvalues; - Pcntl\QosClass を返します。 + 現在の QoS クラスを + Pcntl\QosClass として返します。 @@ -37,7 +38,7 @@ &reftitle.errors; 内部の pthread_get_qos_class_np() の呼び出しが失敗した場合、 - Error をスローします。 + Error をスローします。 diff --git a/reference/pcntl/functions/pcntl-setqos-class.xml b/reference/pcntl/functions/pcntl-setqos-class.xml new file mode 100644 index 0000000000..dd7f02c1a6 --- /dev/null +++ b/reference/pcntl/functions/pcntl-setqos-class.xml @@ -0,0 +1,141 @@ + + + + + + pcntl_setqos_class + 現在のスレッドの QoS クラスを設定する + + + + &reftitle.description; + + voidpcntl_setqos_class + Pcntl\QosClassqos_classPcntl\QosClass::Default + + + 現在のスレッドの Quality of Service (QoS) クラスを設定します。 + + + + + &reftitle.parameters; + + + qos_class + + + 現在のスレッドに割り当てる Quality of Service クラス。 + オペレーティングシステムは、これを CPU 時間の割り当て、 + I/O 優先度、電力消費をスケジューリングする際のヒントとして使用し、 + 上位のクラスは下位のクラスに割り込んで実行されます。 + 利用可能なケースについては、Pcntl\QosClass + を参照してください。 + + + + Pcntl\QosClass::UserInteractive + + + 最も高い優先度です。ユーザーインターフェイスを直接駆動する処理向けで、 + イベント処理や描画など、体感的な遅延を避けるために + ほぼ瞬時に完了する必要があるものを想定しています。 + + + + + Pcntl\QosClass::UserInitiated + + + 高い優先度で、UserInteractive のすぐ下です。 + ユーザーが明示的に開始し、結果を待っている処理向けで、 + 数秒以内に完了することが期待されるものを想定しています。 + + + + + Pcntl\QosClass::Default + + + 標準の優先度で、より具体的なクラスが該当しない場合に使用します。 + より優先度の高い処理の後に実行されますが、 + Utility や Background + よりは先に実行されます。 + + + + + Pcntl\QosClass::Utility + + + 低めの優先度です。ダウンロード、インポート、 + 一括計算など、ユーザーは認識しているものの、 + 結果を待ってはいない長時間の処理向けです。 + 省電力なスケジューリングが行われます。 + + + + + Pcntl\QosClass::Background + + + 最も低い優先度です。プリフェッチ、インデックス作成、 + メンテナンスなど、ユーザーが認識していない処理向けです。 + 電力効率を強く重視して最適化されており、 + システムが高負荷の場合は実行が後回しにされる可能性があります。 + + + + + + + + + この関数は、Apple のプラットフォームでのみ利用可能です。 + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + 内部の pthread_set_qos_class_self_np() の呼び出しが失敗した場合、 + Error をスローします。 + + + + + &reftitle.seealso; + + pcntl_getqos_class + Pcntl\QosClass + + + + + diff --git a/reference/pcntl/functions/pcntl_setqos_class.xml b/reference/pcntl/functions/pcntl_setqos_class.xml deleted file mode 100644 index 2ca65e1716..0000000000 --- a/reference/pcntl/functions/pcntl_setqos_class.xml +++ /dev/null @@ -1,143 +0,0 @@ - - - - - - pcntl_setqos_class - 現在のスレッドの QoS クラスを設定する - - - - &reftitle.description; - - voidpcntl_setqos_class - Pcntl\QosClassqos_classPcntl\QosClass::Default - - - QoS クラスを設定します。 - - - - - &reftitle.parameters; - - - qos_class - - - 現在のスレッドに割り当てる Quality of Service クラス。 - オペレーティングシステムは、これを CPU 時間の割り当て、 - I/O 優先度、電力消費をスケジューリングする際のヒントとして使用し、 - 上位のクラスは下位のクラスに割り込んで実行されます。 - 利用可能なケースについては、Pcntl\QosClass - を参照してください。 - - - - - Pcntl\QosClass::UserInteractive - - - 最も高い優先度です。ユーザーインターフェイスを直接駆動する処理向けで、 - イベント処理や描画など、体感的な遅延を避けるために - ほぼ瞬時に完了する必要があるものを想定しています。 - - - - - Pcntl\QosClass::UserInitiated - - - 高い優先度で、UserInteractive のすぐ下です。 - ユーザーが明示的に開始し、結果を待っている処理向けで、 - 数秒以内に完了することが期待されるものを想定しています。 - - - - - Pcntl\QosClass::Default - - - 標準の優先度で、より具体的なクラスが該当しない場合に使用します。 - より優先度の高い処理の後に実行されますが、 - Utility や Background - よりは先に実行されます。 - - - - - Pcntl\QosClass::Utility - - - 低めの優先度です。ダウンロード、インポート、 - 一括計算など、ユーザーは認識しているものの、 - 結果を待ってはいない長時間の処理向けです。 - 省電力なスケジューリングが行われます。 - - - - - Pcntl\QosClass::Background - - - 最も低い優先度です。プリフェッチ、インデックス作成、 - メンテナンスなど、ユーザーが認識していない処理向けです。 - 電力効率を強く重視して最適化されており、 - システムが高負荷の場合は実行が後回しにされる可能性があります。 - - - - - - - - - - この関数は、Apple のプラットフォームでのみ利用可能です。 - - - - - &reftitle.returnvalues; - - &return.void; - - - - - &reftitle.errors; - - 内部の pthread_set_qos_class_self_np() の呼び出しが失敗した場合、 - Error をスローします。 - - - - - &reftitle.seealso; - - pcntl_getqos_class - Pcntl\QosClass - - - - - From 84d9402dd80c8f8dc9b83a20548a84628b259655 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?= Date: Sun, 14 Jun 2026 18:45:58 +0900 Subject: [PATCH 2/2] =?UTF-8?q?reflection:=20hasreturntype.xml=20=E3=82=92?= =?UTF-8?q?=20doc-en=20=E3=81=A8=E5=90=8C=E6=9C=9F=EF=BC=88=E5=8F=A4?= =?UTF-8?q?=E3=81=8F=E3=81=AA=E3=81=A3=E3=81=9F=E6=AE=B5=E8=90=BD=E3=81=AE?= =?UTF-8?q?=E5=89=8A=E9=99=A4=E3=81=AB=E8=BF=BD=E5=BE=93=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit doc-en PR #5610 (c3485c8f1c) で、ビルトイン関数での利用に関する古い段落が 削除されたことに追従する。 reflection モジュールが完訳になる。 --- .../reflectionfunctionabstract/hasreturntype.xml | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/reference/reflection/reflectionfunctionabstract/hasreturntype.xml b/reference/reflection/reflectionfunctionabstract/hasreturntype.xml index 84d0b6ec65..cb38e7105e 100644 --- a/reference/reflection/reflectionfunctionabstract/hasreturntype.xml +++ b/reference/reflection/reflectionfunctionabstract/hasreturntype.xml @@ -1,6 +1,6 @@ - + @@ -41,7 +41,8 @@ - - こうなるのは、たくさんの内部関数が引数や戻り値に型を指定していないからです。 - よって、このメソッドはビルトイン関数に使わないのが最適です。 -