Cycles through the JS contexts associated with a particular JSRuntime.
Syntax
JSContext * JS_ContextIterator(JSRuntime *rt, JSContext **iterp);
| Name | Type | Description |
|---|---|---|
rt |
JSRuntime * |
The runtime to walk. |
iterp |
JSContext * |
In-out parameter. On input, *iterp must be NULL or point to a context in rt. On success, the value of *iterp is modified so that repeated calls cycle through all the contexts in rt. |
Description
JS_ContextIterator steps through the set of contexts associated with the runtime rt. Each call to JS_ContextIterator returns the next context in the cycle.
iterp must point to a variable of type JSContext *. If *iterp is NULL, JS_ContextIterator modifies it to point to the first JSContext in the list. Otherwise *iterp must point to an existing context in rt, and JS_ContextIterator modifies it to point to the next context in the list, if any, and NULL otherwise.
JS_ContextIterator returns the new value of *iterp.
Example
The following code snippet illustrates how to cycle through the contexts for a given runtime:
JSContext *acx;
JSContext *iterp = NULL;
int i = 0;
while ((acx = JS_ContextIterator(rt, &iterp)) != NULL) {
printf("%d ", ++i);
}