Create a new JavaScript string based on a null-terminated C string.
Syntax
JSString * JS_NewStringCopyZ(JSContext *cx, const char *s); JSString * JS_NewUCStringCopyZ(JSContext *cx, const char16_t *s);
Name | Type | Description |
---|---|---|
cx |
JSContext * |
Pointer to a JS context from which to derive runtime information. 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 the character array containing the text for the JS string to create; or NULL . |
Description
JS_NewStringCopyZ
allocates space for a new JavaScript string and its underlying storage, and then copies the contents of a null-terminated character array, s
, into the new string. On success, JS_NewStringCopyZ
returns a pointer to the new JavaScript string. On error, it returns NULL
.
If s
is NULL
, an empty JavaScript string is returned.
JS_NewStringCopy(cx, s)
is equivalent to
when JS_NewStringCopyN
(cx, s, strlen(s))s
is a null-terminated string.