JS_NewDependentString 编辑

Create a new JavaScript string containing a range of characters from an existing string.

Syntax

JSString *
JS_NewDependentString(JSContext *cx, JS::HandleString str, size_t start,
                      size_t length);

Description

JS_NewDependentString creates a new string as a substring of an existing JavaScript string, str. The new string contains the same characters as if it were created with the JavaScript method str.substr(start, length).

The characters are not copied. Instead, the new string shares str's existing character storage. (Implementation note: Because of this sharing, the garbage collector will not collect str as long as the new substring is reachable.)

On success, JS_NewDependentString returns a pointer to the new string. Otherwise it returns NULL.

See Also

• MXR ID Search for JS_NewDependentString