proc_kill

proc_kill (var mode)

proc_kill(void* function)

Beendet andere Funktionen vorzeitig, die sich gerade im wait-Zustand mit einem von mode gesetzten Filter befinden. Dieser Befehl lässt sich zum Beenden bestimmter Funktionen, die die my- oder you-Entity betreffen, verwenden.

Parameter:

mode

1 beendet alle Funktionen, die von der MY-Entity aufgerufen wurden.
2 beendet alle Funktionen, die von der YOU-Entity aufgerufen wurden
4 beendet alle anderen Instanzen der aktuellen Funktion (s. wait).
5 beendet alle anderen Instanzen der aktuellen Funktion, die von der my-Entity aufgerufen wurden.
6 beendet alle anderen Instanzen der aktuellen Funktion, die von der you-Entity aufgerufen wurden.
16 beendet alle Funktionen.

function

Funktionspointer (typecast to void*) zum Beenden sämtlicher Instanzen dieser Funktion. A7.10 LC

Geschwindigkeit:

Mittel

Bemerkungen:

Funktionen, die sich nicht in einem wait-Zustand befinden, werden nicht beendet. Daher beendet proc_kill weder seine eigene Funktion noch eine, von der sie aufgerufen wurde. Ist dies gewünscht, muss proc_kill ein wait(1) vorangestellt werden. Wurde die Funktion, in der proc_kill enthalten ist von einer anderen Funktion aufgerufen, muß dem proc_kill ein wait() zur Identifikation der gegenwärtigen Funktion vorangestellt sein.
Um festzustellen welche Funktionen beendet werden sollen, durchsucht proc_kill die Liste der Funktionen nach den mit sämtlichen Funktionen gespeicherten my- oder you-Pointern und/oder nach seinen eigenen Listeneinträgen. Die beendeten Funktionen werden dann von der Liste gestrichen.

Beispiele (siehe auch vec_lerp:

function beep_any_second()
{
  while(1) { beep(); wait(-1); }
}

function main()
{
  beep_any_second();
  wait(-5);
  proc_kill((void*)beep_any_second);
}

Siehe auch:

function, wait, proc_late

► Aktuelle Version Online