JS_ContextIterator

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);
}

See Also

Document Tags and Contributors

 Contributors to this page: arai, fscholz, Jorend, h725, Slogan621, Dria, MMondor
 Last updated by: arai,