JavaScript-1.5 Reference

JS_NewStringCopyN Function

Summary

Creates a new JS string of a specified size.

Syntax

JSString * JS_NewStringCopyN(JSContext *cx, const char *s,
    size_t n);
NameTypeDescription
cxJSContext *Pointer to a JS context from which to derive runtime information.
sconst char *Pointer to the character array containing the text for the JS string to create.
nsize_tMaximum number of characters to copy from s into the JS string.

Description

JS_NewStringCopyN allocates space for a JS string and its underlying storage, and copies as many characters from a C character array, s, as possible, up to n bytes, into the new JS string. If the number of bytes in s is greater than the number of characters specified in n, the new JS string contains a truncated version of the original string. If the number of characters in s is less than the number of bytes specified in n, the new JS string is padded with nulls to the specified length.

You can use JS_NewStringCopyN to copy binary data, which may contain ASCII 0 characters. You can also use this function when you want to copy only a certain portion of a C string into a JS string.

If the allocation is successful, JS_NewStringCopyN returns a pointer to the JS string. Otherwise it returns NULL.

See Also

Groups [ Function ]
Documents [ LXR ID Search ]
Entries [ JS_CompareStrings | JS_ConvertValue | JS_GetEmptyStringValue | JS_GetStringBytes | JS_GetStringChars | JS_GetStringLength | JS_InternString | JS_InternUCString | JS_InternUCStringN | JS_NewArrayObject | JS_NewDouble | JS_NewFunction | JS_NewObject | JS_NewString | JS_NewStringCopyZ | JS_NewUCString | JS_NewUCStringCopyN | JS_NewUCStringCopyZ | JS_ValueToString | JS_malloc ]

This page was generated by APIDOC