class SSViewer_Scope

This tracks the current scope for an SSViewer instance. It has three goals: - Handle entering & leaving sub-scopes in loops and withs - Track Up and Top - (As a side effect) Inject data that needs to be available globally (used to live in ViewableData)

In order to handle up, rather than tracking it using a tree, which would involve constructing new objects for each step, we use indexes into the itemStack (which already has to exist).

Each item has three indexes associated with it

  • Pop. Which item should become the scope once the current scope is popped out of
  • Up. Which item is up from this item
  • Current. Which item is the first time this object has appeared in the stack

We also keep the index of the current starting point for lookups. A lookup is a sequence of obj calls - when in a loop or with tag the end result becomes the new scope, but for injections, we throw away the lookup and revert back to the original scope once we've got the value we're after

Constants

ITEM

ITEM_ITERATOR

ITEM_ITERATOR_TOTAL

POP_INDEX

UP_INDEX

CURRENT_INDEX

ITEM_OVERLAY

Methods

__construct($item, SSViewer_Scope $inheritedScope = null)

No description

object
getItem()

Returns the current "active" item

locally()

Called at the start of every lookup chain by SSTemplateParser to indicate a new lookup from local scope

resetLocalScope()

Reset the local scope - restores saved state to the "global" item stack. Typically called after a lookup chain has been completed

mixed
getObj(string $name, array $arguments = [], bool $cache = false, string $cacheName = null)

No description

$this
obj(string $name, array $arguments = [], bool $cache = false, string $cacheName = null)

No description

object
self()

Gets the current object and resets the scope.

pushScope()

Jump to the last item in the stack, called when a new item is added before a loop/with

popScope()

Jump back to "previous" item in the stack, called after a loop/with block

mixed
next()

Fast-forwards the current iterator to the next item

mixed
__call(string $name, array $arguments)

No description

Details

at line 108
__construct($item, SSViewer_Scope $inheritedScope = null)

Parameters

$item
SSViewer_Scope $inheritedScope

at line 122
object getItem()

Returns the current "active" item

Return Value

object

at line 132
SSViewer_Scope locally()

Called at the start of every lookup chain by SSTemplateParser to indicate a new lookup from local scope

Return Value

SSViewer_Scope

at line 154
resetLocalScope()

Reset the local scope - restores saved state to the "global" item stack. Typically called after a lookup chain has been completed

at line 177
mixed getObj(string $name, array $arguments = [], bool $cache = false, string $cacheName = null)

Parameters

string $name
array $arguments
bool $cache
string $cacheName

Return Value

mixed

at line 190
$this obj(string $name, array $arguments = [], bool $cache = false, string $cacheName = null)

Parameters

string $name
array $arguments
bool $cache
string $cacheName

Return Value

$this

at line 241
object self()

Gets the current object and resets the scope.

Return Value

object

at line 254
SSViewer_Scope pushScope()

Jump to the last item in the stack, called when a new item is added before a loop/with

Return Value

SSViewer_Scope

at line 276
SSViewer_Scope popScope()

Jump back to "previous" item in the stack, called after a loop/with block

Return Value

SSViewer_Scope

at line 289
mixed next()

Fast-forwards the current iterator to the next item

Return Value

mixed

at line 339
mixed __call(string $name, array $arguments)

Parameters

string $name
array $arguments

Return Value

mixed