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 + + + 標準の優先度で、より具体的なクラスが該当しない場合に使用します。 + より優先度の高い処理の後に実行されますが、 + UtilityBackground + よりは先に実行されます。 + + + + + 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 - - - 標準の優先度で、より具体的なクラスが該当しない場合に使用します。 - より優先度の高い処理の後に実行されますが、 - UtilityBackground - よりは先に実行されます。 - - - - - 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/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 @@ - - こうなるのは、たくさんの内部関数が引数や戻り値に型を指定していないからです。 - よって、このメソッドはビルトイン関数に使わないのが最適です。 -