Aide:Call.txt

Document original V3.3.6.1 :

###Function###
Call

###Description###
Calls a user-defined function contained in a string parameter.


###Syntax###
Call ( "function" [, param1 [, param2 [, param<i>N</i> ]]] )


###Parameters###
@@ParamTable@@
function
	The name of the user function to call.
param
	Arguments that will be passed to the function being invoked.
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns the return value of the called function.  Both @error and @extended may contain values if the called function set them.
Failure:	Sets @error to 0xDEAD and @extended to 0xBEEF if the function does not exist or invalid number of parameters.
@@End@@


###Remarks###
The <i>function</i> cannot be a built-in AutoIt function or plug-in function.
The function can pass arguments to functions, however, ByRef parameters are not supported; there is no way to retrieve the ByRef parameter.
A special array can be passed in lieu of individual parameters.  This array must have it's first element set to "CallArgArray" and elements 1 - <i>n</i> will be passed as seperate arguments to the function.  If using this special array, no other arguments can be passed to Call().  See example for a demonstration.
Both Call() itself can set @error or the called function can set @error.  If Call() sets @error the value will be 0xDEAD and @extended will also be set to 0xBEEF.  See the example for a demonstration of testing for a function that was not found.

###Related###
Execute


###Example###
@@IncludeExample@@

Document traduit V3.3.6.1 :

###Function###
Call

###Description###
Appelle une fonction utilisateur contenue dans une chaîne passée en paramètre.


###Syntax###
Call ( "function" [, param1 [, param2 [, param<i>N</i> ]]] )


###Parameters###
@@ParamTable@@
function
	Le nom de la fonction utilisateur à appeler.
param
	Les arguments qui seront passés à la fonction invoquée.
@@End@@


###ReturnValue###
@@ReturnTable@@
Succès : Retourne la valeur de retours de la fonction appelée. De même @error et @extended peuvent 

contenir des valeurs si la fonction appelée les renseigne.
Echec : Assigne @error à 0XDEAD et @extended à 0XBEEF si la fonction n'existe pas ou si le nombre 

d'arguments n'est pas correct.
@@End@@


###Remarks###
La <i>fonction</i> ne peut pas être une fonction interne à Autoit ou une fonction plug-in.
Cette fonction peut passer des arguments à des fonctions, cependant, les paramètres "Byref" ne sont 

pas supportés; il n'y a aucun moyen de retrouver la valeur de l'argument "Byref".  
Un tableau spécial peut être passé au lieu des paramètres individuels. Ce tableau doit avoir comme 

premier élément la valeur "CallArgArray" et les élément 1 - <i>n</i> seront passé à la fonction comme 

des arguments séparés. Si vous utilisez ce tableau spécial, aucun autre argument ne peut être 

utilisé. Voir l'exemple pour une démonstration. 
Call() ou la fonction appelée peuvent assigner @error. Si Call() assigne @error, alors la valeur sera 

0xDEAD et @extended sera fixé à 0xBEEF. Voir l'exemple pour une démonstration de test dans le cas 

d'une fonction non trouvée. 


###Related###
<a href="Execute.htm">Execute</a>


###Example###
@@IncludeExample@@

Traducteur : sylvanie

Contributeurs (pour les modifications avant le Wiki) : Tlem