PHP-Handbuch: Ändert die Priorität des aktuellen Prozesses

Beschreibung

bool proc_nice ( int $increment )

proc_nice ändert die Priorität des aktuellen Prozesses um den in increment angegebenen Betrag. Ein positives increment vermindert die Priorität des aktuellen Prozesses, während ein negatives increment die Priorität erhöht.

proc_nice ist in keinster Weise verwandt mit proc_open und der dazugehörigen Funktionen.

Parameter-Liste

increment

Der neue Prioritätswert; dieser Wert ist plattformabhängig.

Unter Unix bedeutet ein niedriger Wert, wie beispielsweise -20, eine hohe Priorität, wohingegen ein positiver Wert eine niedrigere Priorität hat.

Unter Windows hat der increment-Parameter die folgende Bedeutung:

Prioritätsklasse	Mögliche Werte
Hoch	`increment` < -9
Höher als normal	`increment` < -4
Normal	`increment` < 5 & `increment` > -5
Niedriger als normal	`increment` > 5
Niedrig	`increment` > 9

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben. Wenn ein Fehler auftritt, zum Beispiel weil der User keine Berechtigung hat, die Priorität eines Prozesses zu ändern, wird ein Fehler der Stufe E_WARNING erzeugt.

Beispiele

Beispiel #1 Verwendung von proc_open um die Prozesspriorität auf hoch zu setzen


<?php
// höchste Priorität
proc_nice(-20)
?>

Changelog

Version	Beschreibung
7.2.0	Diese Funktion steht nun unter Windows zur Verfügung.

Anmerkungen

Hinweis: Verfügbarkeit

proc_nice existiert nur, wenn Ihr System mit 'nice' umgehen kann. 'nice' ist verfügbar unter: SVr4, SVID EXT, AT&T, X/OPEN, BSD 4.3.

Hinweis: Nur für Windows

proc_nice ändert die aktuelle Prozesspriorität, selbst wenn PHP mit Threadsicherheit kompiliert wurde.