Regular API function

sim.setThreadAutomaticSwitch

Description	Allows to temporarily forbid automatic thread interruptions, i.e. preemptive threading. Explicit thread interruptions, i.e. switching, are still allowed. For complete control over thread switching, see also the other thread related functions.
C/C++ synopsis
C/C++ parameters
C/C++ return value
Lua synopsis	int autoSwitchForbidLevel=sim.setThreadAutomaticSwitch(bool allowAutoSwitch / int forbidLevel)
Lua parameters	allowAutoSwitch: if false, then the thread will not be automatically interrupted anymore (i.e. automatic thread switching will be temporarily disabled). Calling n times sim.setThreadAutomaticSwitch(false) requires to call n times sim.setThreadAutomaticSwitch(true) to restore the initial behaviour. forbidLevel: allows to set an auto switch forbid level: a level > 0 indicates that automatic thread interruption is disabled. Best is to always use following to temporarily forbid automatic thread interruptions: `local initialForbidLevel=sim.setThreadAutomaticSwitch(false) -- forbid automatic thread switches ... sim.setThreadAutomaticSwitch(initialForbidLevel) -- restore to initial state`
Lua return values	autoSwitchForbidLevel: the forbid switch level before calling the function, i.e. the forbid switch level that should be restored later on.
Python synopsis	int autoSwitchForbidLevel=sim.setThreadAutomaticSwitch(bool allowAutoSwitch / int forbidLevel)