New signal

Home

4D v19.8

New signal


New signal {( description )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
description	Text	Beschreibung des Signals
Funktionsergebnis	Objekt	Native Objekt mit dem Signal

Beschreibung

Der Befehl New signal erstellt ein Objekt signal.

Ein Signal ist ein shared object, das als Parameter eines Workers oder Prozesses an einen anderen übergeben werden kann, so dass:

der aufgerufene Worker/Prozess das Objekt Signal aktualisiert, wenn eine spezifische Bearbeitung abgeschlossen ist
der aufrufende Worker/Prozess die Ausführung stoppt und wartet, bis das Signal aktualisiert ist, ohne Verbrauch einer CPU Resssource.

Optional können Sie im Parameter description einen eigenen Text zum Beschreiben des Signals eingeben. Dieser Text lässt sich auch nach dem Erstellen des Signals definieren.

Da das Objekt signal ein shared object ist (siehe Shared Objects und Shared Collections), kann es über Use...End use auch für eigene Eigenschaften, sowie die Eigenschaft signal.description verwendet werden.

Zurückgegebener Wert

Das Objekt signal enthält folgende Eigenschaften:

Eigenschaft	Typ	Beschreibung
signal.signaled	Boolean	(read-only Eigenschaft) falsch beim Erstellen des Signals. Wird wahr beim Aufrufen der Methode signal.trigger( ).
signal.description	Text	Eigene Beschreibung des Signals, wenn vorhanden

Methode	Beschreibung
signal.wait( )	Methode	Warten auf das Signal (Aufrufen von Prozess/Worker)
signal.trigger( )	Methode	Auslösen des Signals (Aufgerufener Prozess/Worker)

Beispiel

Hier sehen Sie ein typisches Beispiel eines Workers, der ein Signal setzt:

 C_OBJECT($signal)

 $signal:=New signal("Dies ist mein erstes Signal")

 CALL WORKER("myworker";"doSomething";$signal)

 $signaled:=$signal.wait(1) //max. 1 Sekunde warten

 If($signaled)

    ALERT("myworker hat die Arbeit beendet. Ergebnis: "+$signal.myresult)

 Else

    ALERT("myworker hat nicht unter 1 sek. beendet")

 End if

Die Methode "doSomething" könnte lauten:

 C_OBJECT($1)

  //Bearbeitung

  //...

 Use($1)

    $1.myresult:=$processingResult  //Ergebnis zurückgeben

 End use

 $1.trigger() // Die Arbeit ist beendet

Siehe auch

signal.description
signal.signaled
signal.trigger( )
signal.wait( )