JS CompileScript

スクリプトを実行するためにコンパイルします。

構文

JSScript * JS_CompileScript(JSContext *cx, JSObject *obj,
    const char *bytes, size_t length, const char *filename,
    uintN lineno);

JSScript * JS_CompileUCScript(JSContext *cx, JSObject *obj,
    const jschar *chars, size_t length, const char *filename,
    uintN lineno);

解説

JS_CompileScript は、スクリプト文字列 source をコンパイルする関数です。JS_CompileUCScript はスクリプト文字列にUnicodeを引数に取る関数です。 <code>JS_CompileScript</code> compiles a script, <code>source</code>, for execution. <code>JS_CompileUCScript</code> is the Unicode version of the function.

スクリプトは JavaScript オブジェクトobjと関連付けられます。引数 bytes はスクリプト文字列、length は文字列長をそれぞれ取ります。 The script is associated with a JS object. <code>bytes</code> is the string containing the text of the script. <code>length</code> indicates the size of the text version of the script in bytes.

filename はスクリプトのファイル名あるいは URL を引数として取ります。ここで指定した情報は、コンパイルエラーが発生したときのエラーメッセージに利用されます。lineno も同様にエラーメッセージとして出力される行番号として利用されます。 スクリプトが巨大なファイルの一部でない場合は、lineno を 1 に設定すればよいでしょう(基本的にファイルの先頭行は 0 でなく1で示します)。 <code>filename</code> is the name of the file (or URL) containing the script. This information is included in error messages if an error occurs during compilation. Similarly, <code>lineno</code> is used to report the line number of the script or file where an error occurred during compilation. If the script is not part of a larger document, <code>lineno</code> should be <code>1</code> (as the first line of a file is universally considered to be line <code>1</code>, not line <code>0</code>).

コンパイルが成功したとき、JS_CompileScript および JS_CompileUCScript はコンパイルされたスクリプトへのポインタを返します。失敗したときはエラーメッセージを出力し、NULL を値として返します。 On success, <code>JS_CompileScript</code> and <code>JS_CompileUCScript</code> return a pointer to the newly compiled script. Otherwise, they report an error and return <code>NULL</code>.

スクリプト文字列を引数として与えるのではなく、外部ファイルから読み込ませる場合には JS_CompileFile を代わりに用いてください。 To compile a script from an external file source rather than passing the actual script as an argument, use <code>JS_CompileFile</code> instead of <code>JS_CompileScript</code>.

利用例

/* Sample program - execute a script repeatedly until an error occurs. */
JSScript *script;
JSObject *srcobj;

script = JS_CompileFile(cx, global, filename);
if (script == NULL)
    return JS_FALSE;

scrobj = JS_NewScriptObject(cx, script);
if (scrobj == NULL
    || !JS_AddNamedRoot(cx, &scrobj, "scrobj"))
    return JS_FALSE;

for (;;) {
    jsval result;

    if (!JS_ExecuteScript(cx, global, script, &result))
        break;
    JS_GC(cx);
}

JS_RemoveRoot(cx, &scrobj);

関連項目

• MXR ID で JS_CompileScript を
• MXR ID で JS_CompileUCScript を
• JS_CompileFile, JS_DecompileScript, JS_DestroyScript, JS_EvaluateScript, JS_ExecuteScript