diff options
Diffstat (limited to 'files/fr/référence_de_jsapi/js_callfunction/index.html')
| -rw-r--r-- | files/fr/référence_de_jsapi/js_callfunction/index.html | 138 |
1 files changed, 0 insertions, 138 deletions
diff --git a/files/fr/référence_de_jsapi/js_callfunction/index.html b/files/fr/référence_de_jsapi/js_callfunction/index.html deleted file mode 100644 index d39247ec78..0000000000 --- a/files/fr/référence_de_jsapi/js_callfunction/index.html +++ /dev/null @@ -1,138 +0,0 @@ ---- -title: JS_CallFunction -slug: Référence_de_JSAPI/JS_CallFunction -tags: - - JSAPI Reference - - SpiderMonkey -translation_of: Mozilla/Projects/SpiderMonkey/JSAPI_reference/JS_CallFunction ---- -<div>{{SpiderMonkeySidebar("JSAPI")}}</div> - -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Appelle une fonction</span> <span class="hps">JS</span> <span class="hps">spécifié.</span></span></p> - -<h2 id="Syntax" name="Syntax">Syntax</h2> - -<pre class="brush: cpp">/* <span class="short_text" id="result_box" lang="fr"><span class="hps">Ajouté dans</span></span> SpiderMonkey 31 */ -bool -JS_CallFunction(JSContext *cx, JS::HandleObject obj, JS::HandleFunction fun, - const JS::HandleValueArray& args, - JS::MutableHandleValue rval); - -bool -JS_CallFunctionName(JSContext *cx, JS::HandleObject obj, const char *name, - const JS::HandleValueArray& args, JS::MutableHandleValue rval); - -bool -JS_CallFunctionValue(JSContext *cx, JS::HandleObject obj, JS::HandleValue fval, - const JS::HandleValueArray& args, JS::MutableHandleValue rval); - -/* <span class="short_text" id="result_box" lang="fr"><span class="hps">Obsolète</span></span> depuis JSAPI 30 */ - -bool -JS_CallFunction(JSContext *cx, JSObject *obj, JSFunction *fun, unsigned argc, - jsval *argv, jsval *rval); - -bool -JS_CallFunctionName(JSContext *cx, JSObject *obj, const char *name, unsigned argc, - jsval *argv, jsval *rval); - -bool -JS_CallFunctionValue(JSContext *cx, JSObject *obj, jsval fval, unsigned argc, - jsval *argv, jsval *rval); -</pre> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th>Nom</th> - <th>Type</th> - <th>Description</th> - </tr> - <tr> - <td><code>cx</code></td> - <td>{{jsapixref("JSRuntime", "JSContext *")}}</td> - <td><span id="result_box" lang="fr"><span class="hps">Pointeur</span> <span class="hps">à un contexte</span> <span class="hps">JS</span> <span class="hps">à partir duquel </span><span class="hps">obtenir des informations</span> <span class="hps">d'exécution</span></span>. {{ Jsapi-requires-request() }}</td> - </tr> - <tr> - <td><code>obj</code></td> - <td>{{jsapixref("JSObject", "JS::HandleObject")}}</td> - <td><span id="result_box" lang="fr"><span class="hps">L'objet</span> <span class="hps">«courant»</span> <span class="hps">sur lequel la fonction</span> <span class="hps">opère</span><span>;</span> <span class="hps">l'objet spécifié</span> <span class="atn hps">ici est "</span><span>this</span><span>"</span> <span class="hps">lorsque la fonction</span> <span class="hps">est exécutée.</span></span></td> - </tr> - <tr> - <td><code>fun</code></td> - <td>{{jsapixref("JSFunction", "JS::HandleFunction")}}</td> - <td> - <p><span id="result_box" lang="fr"><span class="hps">Pointeur vers la</span> <span class="hps">fonction à appeler</span><span>.</span> </span><strong><code>fun</code></strong><span lang="fr"> <strong><span class="hps">devrait être une</span> <span class="hps">fonction native</span> <span class="hps">ou la fonction</span> <span class="hps">JSAPI</span><span class="atn">-</span><span>compilé</span></strong><span>.</span> <span class="hps">Voir ci-dessous.</span></span></p> - </td> - </tr> - <tr> - <td><code>name</code></td> - <td><code>const char *</code></td> - <td><span class="short_text" id="result_box" lang="fr"><span class="hps">Pointeur sur</span> <span class="hps">le nom de</span> <span class="hps">la fonction à appeler</span><span>.</span></span></td> - </tr> - <tr> - <td><code>fval</code></td> - <td>{{jsapixref("JS::Value", "JS::HandleValue")}}</td> - <td><span class="short_text" id="result_box" lang="fr"><span class="hps">Pointeur</span> <span class="hps">à la valeur</span> <span class="hps">de</span> <span class="hps">la fonction à appeler</span><span>.</span></span></td> - </tr> - <tr> - <td><code>args</code></td> - <td>{{jsapixref("JS::HandleValueArray", "const JS::HandleValueArray &")}}</td> - <td><span id="result_box" lang="fr"><span class="hps">Référence</span> <span class="atn hps">à tableau</span><span>l de</span> <span class="hps">valeurs d'arguments</span> <span class="hps">à passer à</span> <span class="hps">la fonction</span></span>. {{ Jsapi_minversion_inline("31") }}</td> - </tr> - <tr> - <td><code>argc</code></td> - <td><code>unsigned</code></td> - <td><span class="short_text" id="result_box" lang="fr"><span class="hps">Nombre d'arguments</span> <span class="hps">que vous</span> <span class="hps">passez à</span> <span class="hps">la fonction</span></span>. {{ obsolete_inline("jsapi30") }}</td> - </tr> - <tr> - <td><code>argv</code></td> - <td>{{jsapixref("Jsval", "jsval *")}}</td> - <td><span id="result_box" lang="fr"><span class="hps">Pointeur vers le tableau</span> <span class="hps">de</span> <span class="hps">valeurs d'arguments</span> <span class="hps">à passer à</span> <span class="hps">la fonction</span></span>. {{ obsolete_inline("jsapi30") }}</td> - </tr> - <tr> - <td><code>rval</code></td> - <td>{{jsapixref("JS::Value", "JS::MutableHandleValue")}}</td> - <td> - <p>Out parameter<span lang="fr"><span>.</span> <span class="hps">En cas de succès</span><span>,</span> </span><code>*rval</code><span lang="fr"> <span class="hps">reçoit la</span> <span class="hps">valeur de retour de</span> <span class="hps">l'appel de la fonction</span><span>.</span></span></p> - </td> - </tr> - </tbody> -</table> - -<h2 id="Description" name="Description">Description</h2> - -<p><code>JS_CallFunction </code><span lang="fr"> <span class="hps">appelle une fonction</span> <span class="hps">spécifiée</span><span>,</span> </span><code>fun</code><span lang="fr"><span>,</span> <span class="hps">sur un objet</span><span>,</span> </span><code>obj</code><span lang="fr"><span>.</span> <span class="hps">En termes d'exécution</span> <span class="hps">de la fonction</span><span>,</span> <span class="atn hps">l'</span><span>objet est traité comme</span> tel<span class="hps">.</span></span></p> - -<p><code>JS_CallFunctionName</code><span lang="fr"> <span class="hps">appelle une fonction</span> <span class="hps">avec un nom spécifique</span><span>, le nom</span> <span class="hps">sur un</span> <span class="hps">objet </span></span><code>obj</code><span lang="fr"><span>.</span> <span class="hps">Si le moteur</span> <span class="hps">JS</span> <span class="hps">parvient pas à obtenir</span> <span class="hps">la fonction</span><span>,</span> <span class="hps">il retourne </span></span><code>false.</code></p> - -<p><code>JS_CallFunctionValue</code> <span lang="fr"><span class="hps">appelle une fonction</span> <span class="hps">spécifiée</span></span>, <code>fval</code> <span lang="fr"><span class="hps">sur un objet</span></span> <code>obj</code>. <code>JS_CallFunctionValue(cx, obj, fval, args, rval)</code> <span class="short_text" id="result_box" lang="fr"><span class="hps">est</span> <span class="hps">analogue à</span> <span class="hps">la déclaration</span> <span class="hps">JavaScript</span></span> <code>rval = fval.apply(obj, args);</code>.</p> - -<p><span id="result_box" lang="fr"><span class="hps">Dans </span></span><code>args</code><span lang="fr"><span>,</span> <span class="hps">passer</span> <span class="hps">une référence aux</span> <span class="hps">valeurs des arguments</span> <span class="hps">réels</span> <span class="hps">à utiliser.</span> <span class="hps">Il devrait y avoir</span> <span class="hps">une valeur pour chaque</span> <span class="hps">argument que vous</span> <span class="hps">passez</span> <span class="hps">à la fonction</span><span>;</span> <span class="hps">le nombre d'arguments</span> <span class="hps">que vous passez</span> <span class="hps">peut</span> <span class="hps">être différent du</span> <span class="atn hps">nombre d'</span><span>arguments définis pour</span> <span class="hps">la fonction</span><span>.</span></span></p> - -<div class="note"> -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Obsolète</span> <span class="hps">depuis</span> <span class="hps">JSAPI</span> <span class="hps">30</span></span>.</p> - -<p>Dans <code>argc</code>, <span id="result_box" lang="fr"><span class="hps">indiquer le nombre</span> <span class="hps">d'arguments passés à</span> <span class="hps">la fonction</span></span>. Dans <code>argv</code>, <span id="result_box" lang="fr"><span class="hps">passer</span> <span class="hps">un pointeur vers</span> <span class="hps">les</span> <span class="hps">valeurs d'arguments</span> <span class="hps">réels</span> <span class="hps">à utiliser.</span></span></p> -</div> - -<p><code>rval</code><span id="result_box" lang="fr"><span class="hps"> est</span> <span class="hps">un pointeur vers une</span> <span class="hps">variable qui contiendra</span> <span class="hps">la valeur de retour</span> <span class="hps">de</span> <span class="hps">la fonction</span><span>, le cas échéant</span><span>,</span> <span class="hps">sur l'exécution</span> <span class="hps">de la fonction</span> <span class="hps">réussie</span><span>.</span></span></p> - -<p><span class="short_text" id="result_box" lang="fr"><span class="hps">Si</span> <span class="hps">la fonction appelée</span> <span class="hps">s'exécute</span> <span class="hps">avec succès</span></span>, <code>JS_CallFunction</code> retourne <code>true</code>. Sinon il retourne <code>false</code>, et <code>rval</code> est ind<span id="result_box" lang="fr"><span>é</span></span>finit.</p> - -<p></p><div class="warning"><span class="short_text" id="result_box" lang="fr"><span class="hps">L' appel de </span></span><code>JS_CallFunction</code> <span id="result_box" lang="fr"><span class="hps">est sûr</span> <span class="hps">que si</span> <span class="hps">l'argument</span> </span><var>fun</var><span lang="fr"> <span class="hps">pourrait</span> <span class="hps">être passée à</span></span> <code>JS_GetFunctionObject</code> <span class="short_text" id="result_box" lang="fr"><span class="hps">sans encombre</span></span>: <span id="result_box" lang="fr"><span class="hps">autrement dit, il</span> <span class="hps">est une fonction</span> <span class="hps">mise en oeuvre par</span> <span class="hps">un</span></span><span class="lang lang-en"> <code>JSNative</code> ou <code>JSFastNative</code> ou </span><span class="short_text" id="result_box" lang="fr"><span class="hps">le</span> <span class="hps">résultat d'un appel</span> <span class="hps">à</span></span><span class="lang lang-en"> <code>JS_CompileFunction</code>, <code>JS_CompileUCFunction</code>, <code>JS_CompileFunctionForPrincipals</code>, ou <code>JS_CompileUCFunctionForPrincipals</code></span>. <span id="result_box" lang="fr"><span class="hps">Passant</span> <span class="hps">toute autre fonction</span> <span class="hps">pointeur</span> <span class="hps">JS</span> <span class="hps">peut conduire à</span> <span class="hps">un crash </span><span class="hps">ou pour pire</span></span>.</div><p></p> - -<h2 id="See_also" name="See_also"><span class="short_text" id="result_box" lang="fr"><span class="hps">Voir aussi</span></span></h2> - -<ul> - <li>{{ LXRSearch("ident", "i", "JS_CallFunction") }}</li> - <li>{{ LXRSearch("ident", "i", "JS_CallFunctionName") }}</li> - <li>{{ LXRSearch("ident", "i", "JS_CallFunctionValue") }}</li> - <li>{{jsapixref("JS_CompileFunction")}}</li> - <li>{{jsapixref("JS_DefineFunction")}}</li> - <li>{{jsapixref("JS_DefineFunctions")}}</li> - <li>{{jsapixref("JS_GetFunctionObject")}}</li> - <li>{{jsapixref("JS_NewFunction")}}</li> - <li>{{jsapixref("JS_ValueToFunction")}}</li> - <li>{{bug(965830)}}</li> -</ul> |
