Qore Programming Language Reference Manual: Qore::Thread::AutoGate Class Reference (original) (raw)

A helper class for the Gate class for exception-safe Gate handling.

Restrictions:

Qore::PO_NO_THREAD_CLASSES

AutoGate objects, when used along with a Gate object, allow Qore programmers to safely enter and exit a Gate lock, even if exceptions are thrown or return statements are executed in the block where the AutoGate object is created.

AutoGate objects enter the gate lock for the lifetime of the AutoGate object. For this reason, it is only appropriate to assign an AutoGate object to a local variable, so when the local variable goes out of scope, the AutoGate object will be deleted and the gate automatically exited.

For example:

our Gate gate();

sub check_error(error) {

AutoGate ag(gate);

if (error)

throw "ERROR", "sorry, an error happened";

return "OK";

}

Note

This class is not available with the PO_NO_THREAD_CLASSES parse option.