set_operator_timeout — Setzt einen Timeout für einen Operator.
set_operator_timeout( : : OperatorName, Timeout, Mode : )
set_operator_timeout setzt den Timeout Timeout für alle
zukünftigen Aufrufe des Operators OperatorName.
Der Timeout wird in Sekunden angegeben.
Ein Wert von 0 oder 'off' löscht einen evtl. vorher
gesetzten Timeout.
Der Timeout gilt nur für den aktuellen Thread und wird nicht an andere Threads weitergegeben.
Es werden zwei Arten von Timeout unterstützt, zwischen denen mittels
Mode ausgewählt werden kann:
Bricht die Ausführung des Operators ab, nachdem der Timeout abgelaufen ist. Der Operator liefert in diesem Fall den Fehlercode H_ERR_TIMEOUT (9400) zurück. Evtl. bereits vorhandene Ergebnisse des Operators werden verworfen.
Hält die Ausführung des Operators an, nachdem der Timeout abgelaufen ist, und liefert, soweit möglich, alle bereits vorhandenen Ergebnisse zurück. Der Operator wird in diesem Fall normal beendet und liefert keinen Fehlercode zurück.
Nicht alle Operatoren unterstützen Timeouts. Wenn ein Operator Timeouts unterstützt, ist dies im Abschnitt über Ausführungsinformationen in dessen Referenzdokumentation vermerkt.
Es gibt keine Garantie über die Granularität der Timeouts. Diese kann vom Operator, dessen Eingabedaten und dem ausführenden System abhängen. Üblicherweise ist die Granularität besser als 10 ms.
OperatorName (input_control) string(-array) → (string)
Operator für den der Timeout gesetzt werden soll.
Timeout (input_control) number(-array) → (real / integer / string)
Timeout in Sekunden.
Defaultwert: 1
Wertevorschläge: 1, 0.1, 0.5, 'off', 0
Mode (input_control) string → (string)
Art des zu setzenden Timeouts.
Defaultwert: 'cancel'
Wertevorschläge: 'cancel', 'break'
Sind alle Parameterwerte korrekt, gibt set_operator_timeout
den Wert 2 (H_MSG_TRUE) zurück.
Andernfalls wird eine Fehlerbehandlung durchgeführt.
interrupt_operator,
get_current_hthread_id
Foundation