JS_GetStringChars

この記事はまだ日本語に翻訳されていません。MDN の翻訳はボランティアによって行われています。是非 MDN に登録し、私たちの力になって下さい。

Retrieve a pointer to the 16-bit values that make up a given string.

Syntax

jschar * JS_GetStringChars(JSString *str); Obsolete since JavaScript 1.8.5

const jschar * JS_GetStringCharsZ(JSContext *cx, JSString *str); Added in SpiderMonkey 1.8.2
Name Type Description
cx JSContext * (in JS_GetStringCharsZ only) A context.
str JSString * The string to obtain characters from.

Description

JS_GetStringChars Obsolete since JavaScript 1.8.5 returns a pointer to the first element of an array of jschars. Warnings:

  • The array is not necessarily null-terminated. To get the length of the string, use JS_GetStringLength.
  • The program must not modify the array. If it does, the behavior is undefined.
  • The content of a JS string is not guaranteed to be valid UTF-16. It may contain surrogate code units that aren't properly paired. It may also contain zeroes.

The array returned by this function remains valid as long as str is valid. (Eventually, str becomes unreachable, the garbage collector collects it, and the array is freed by the system.)

JS_GetStringCharsZ is the same except that it always returns either a null-terminated string or NULL, indicating out-of-memory.

See Also

MXR ID Search for JS_GetStringCharsZ

JS_CompareStrings

Document Tags and Contributors

Contributors to this page: Nickolay, MMondor, Jorend, Tservo, newacct, tschneidereit, MarkGiffin
最終更新者: tschneidereit,