Credits object | actions.t[102]

Throw a 'restart' signal; the main entrypoint loop will catch this and actually perform the restart.

Note that we *could* do the VM reset (via restartGame()) here, but there's an advantage to doing it in the main loop: we won't be in the stack context of whatever command we're performing. If we did the restart here, it's possible that some useless objects would survive the VM reset just because they're referenced from within a caller's stack frame. Those objects would immediately go out of scope when we get back to the main loop, but they might survive long enough to create apparent inconsistencies. In particular, if we did a firstObj/nextObj loop, we could discover those objects and re-establish more lasting references to them, which we certainly don't want to do. By deferring the VM reset until we get back to the main loop, we'll ensure that objects won't survive the reset just because they're on the stack momentarily here.

`Credits : SystemAction`

Superclass Tree (in declaration order)

`Credits`
`SystemAction`
`IAction`
`Action`
`ReplaceRedirector`
`Redirector`
`object`

Summary of Properties

``

Inherited from `SystemAction` :
`includeInUndo isRepeatable turnsTaken`

Inherited from `IAction` :
`againRepeatsParse`

Inherited from `Action` :
`actionFailed allowAll extraMessageParams failCheckMsg isImplicit oldRoom parentAction parentAllowAll preCond redirectParent reportImplicitActions scopeList spellingPriority synthParamID unhides verifyObj wasIlluminated`

``

``

Summary of Methods

`execAction`

Inherited from `SystemAction` :
`afterAction exec execCycle getInputFile turnSequence`

Inherited from `IAction` :
`execResolvedAction resolvedObjectsInScope scoreObjects setResolvedObjects`

Inherited from `Action` :
`acknowledgeNotifyStatus addExtraScopeItems addImplicitTime advanceTime announceObject beforeAction buildImplicitActionAnnouncement buildScopeList checkAction checkActionPreconditions commandNotPresent execGroup getAll getAllUnhidden getMessageParam implicitAnnouncement reportAction setMessageParam setMessageParams spPrefix spSuffix synthMessageParam verify verifyObjRole wrapObjectsNP`

Inherited from `ReplaceRedirector` :
`redirect`

Inherited from `Redirector` :
`doInstead doNested doOtherAction`

Properties

(none)

Methods

`execAction (cmd)`OVERRIDDEN | `actions.t[105]`

no description available

Adv3Lite Library Reference Manual
Generated on 28/03/2016 from adv3Lite version 1.5