proc_nice
(PHP 5, PHP 7)
proc_nice — 現在のプロセスの優先度を変更する
説明
proc_nice
( int $increment
) : bool
proc_nice() は、現在のプロセスの優先度を
increment
で指定された値に変更します。
increment
が正数の場合、
現在のプロセスの優先度をより低くし、increment
が負数の場合は優先度が上がります。
proc_nice() は、proc_open() やそれに関連する関数とは関係ありません。
パラメータ
increment
新しい優先度の値。この値はプラットフォームによっては異なるかもしれません。
Unix 上では、
-20
のように低い値が高い優先度である一方で、 正の値は低い優先度として扱われます。Windows では、
increment
パラメータは次のような意味があります:優先度クラス 取りうる値 優先度高 increment
< -9
通常より高い優先度 increment
< -4
通常の優先度 increment
< 5
&increment
> -5
通常より低い優先度 increment
> 5
アイドルな優先度 increment
> 9
返り値
成功した場合に true
を、失敗した場合に false
を返します。
ユーザーが優先度を変更する権限を持っていないなど、
エラーが発生した場合は E_WARNING
レベルのエラーも発行されます。
例
例1 proc_nice() 関数を使い、プロセスの優先度を高に設定する
<?php// Highest priorityproc_nice(-20);?>
変更履歴
バージョン | 説明 |
---|---|
7.2.0 | この関数は、Windows で利用できるようになりました。 |
注意
注意:
可用性
proc_nice() は、使用しているシステムが 'nice' の機能を持っている場合のみ利用可能です。 'nice' は次のシステムに準拠しています: SVr4, SVID EXT, AT&T, X/OPEN, BSD 4.3 。
注意:
Windows のみ
proc_nice() 関数は、 PHP がたとえスレッドセーフを有効にしてコンパイルされていたとしても、 現在の プロセスの優先度を変更します。