wait

Nach oben zu Process.h - Index

Header-Datei

process.h

Kategorie

Prozesssteuerungsroutinen

Prototyp

int wait(int *statloc);

Beschreibung

Wartet auf die Beendigung eines oder mehrerer untergeordneter Prozesse.

Die Funktion wait wartet auf die Beendigung eines oder mehrerer untergeordneter Prozesse. Die untergeordneten Prozesse müssen vom aufrufenden Programm erzeugt worden sein; wait kann nicht auf Prozesse warten, die von untergeordneten Prozessen erzeugt wurden. Ist statloc ungleich NULL, zeigt dieser Parameter auf die Position, an der wait den Beendigungsstatus speichert.

Rückgabewert

Kehrt wait nach normaler Beendigung des untergeordneten Prozesses zurück, gibt die Funktion dessen Prozess-ID zurück.

Kehrt wait nach einer nicht normalen Beendigung des untergeordneten Prozesses zurück, gibt die Funktion -1 an den übergeordneten Prozess zurück und setzt errno auf EINTR.

Kehrt wait zurück, ohne dass der untergeordnete Prozess abgeschlossen wurde, gibt die Funktion -1 zurück und setzt errno auf den folgenden Wert:

Errno	Bedeutung
ECHILD	Kein untergeordneter Prozess vorhanden

Beispiel

#include <process.h>
#include <stdio.h> int spawn_and_wait(wchar_t* program)
{
  /* Anderen Prozess mit NOWAIT-Flag */
  int pid = _wspawnl(P_NOWAIT, program, NULL); int exitCode;

  /* Auf Fehler prüfen */
  if (pid == -1) return -1;

  /* Auf Beendigung der untergeordneten Prozesse warten */
  wait(&exitCode);
  return exitCode;
}

Portabilität

POSIX	Win32	ANSI C	ANSI C++
	+