JS_InternString 编辑
Get an interned string - a JSString
that is protected from GC and automatically shared with other code that needs a JSString
with the same value.
Syntax
JSString *
JS_InternString(JSContext *cx, const char *s);
JSString *
JS_InternStringN(JSContext *cx, const char *s, size_t length);
JSString *
JS_InternUCString(JSContext *cx, const char16_t *s);
JSString *
JS_InternUCStringN(JSContext *cx, const char16_t *s, size_t length);
Name | Type | Description |
---|---|---|
cx | JSContext * | A context. Requires request. In a JS_THREADSAFE build, the caller must be in a request on this JSContext . |
s | const char * or const char16_t * | Pointer to a character array containing the data for the string. In JS_InternString and JS_InternUCString , the string must be null-terminated. |
length | size_t | (only in JS_InternStringN and JS_InternUCStringN ) The length of s in characters. |
Description
JS_InternString
and JS_InternStringN
return an interned JavaScript string with a specified value, s
. JS_InternUCString
and JS_InternUCStringN
are the Unicode versions of the function.
Each JSRuntime
keeps a table of all existing interned strings. If an interned string already exists with the desired value, these functions return the existing string. Otherwise a new string is created and added to the table. Strings created with these functions are protected from garbage collection for the lifetime of the JSRuntime
.
On success, these functions return a pointer to the interned string. Otherwise they report an error and return NULL
.
See Also
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论