mozilla
Your Search Results

    JS NewStringCopyZ

    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 jschar *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 jschar * 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 JS_NewStringCopyN(cx, s, strlen(s)) when s is a null-terminated string.

    See Also

    MXR ID Search for JS_NewStringCopyZ
    MXR ID Search for JS_NewUCStringCopyZ

    JS_GetEmptyStringValue, JS_NewString, JS_NewStringCopyNJS_ValueToString

    Document Tags and Contributors

    Contributors to this page: Jorend
    Last updated by: Jorend,