arguments, objet

Objet représentant la fonction en cours d'exécution, ses arguments et la fonction qui l'a appelée. Cet objet ne peut pas être construit de manière explicite.

Propriétés

arguments, objet - propriétés

Méthodes

L'objet arguments n'a pas de méthode.

Configuration requise

Version 1

Notes

Un objet arguments est instancié pour chaque fonction au moment où elle s'exécute. L'objet arguments n'est directement accessible que dans la portée de la fonction qui lui est associée.

Tous les paramètres passés à une fonction et le nombre de paramètres sont stockés dans l'objet arguments. L'objet arguments n'est pas un tableau, mais les arguments individuels sont accessibles de la même manière que les éléments de tableau, à l'aide de la notation [ ].

Il est possible d'utiliser l'objet arguments pour créer des fonctions qui peuvent accepter un nombre arbitraire d'arguments. Vous pouvez également obtenir cette fonctionnalité en utilisant la construction de tableau de paramètres lorsque vous définissez votre fonction. Pour plus d'informations, consultez la rubrique relative à l'instruction function.

Notes

L'objet arguments n'est pas disponible en mode rapide, le mode d'exécution par défaut de JScript. Pour compiler un programme à partir de la ligne de commande qui utilise l'objet arguments, vous devez désactiver l'option fast en utilisant /fast-. Il est déconseillé de désactiver l'option fast dans ASP.NET en raison des problèmes de threads qui peuvent en résulter.

Exemple

L'exemple ci-dessous illustre l'utilisation de l'objet arguments :

function argTest(a, b) : String {
   var i : int;
   var s : String = "The argTest function expected ";
   var numargs : int = arguments.length; // Get number of arguments passed.
   var expargs : int = argTest.length;   // Get number of arguments expected.
   if (expargs < 2)
      s += expargs + " argument. ";
   else
      s += expargs + " arguments. ";
   if (numargs < 2)
      s += numargs + " was passed.";
   else
      s += numargs + " were passed.";
   s += "\n"
   for (i =0 ; i < numargs; i++){        // Get argument contents.
      s += "  Arg " + i + " = " + arguments[i] + "\n";
   }
   return(s);                            // Return list of arguments.
}

print(argTest(42));
print(argTest(new Date(1999,8,7),"Sam",Math.PI));

Le résultat généré par ce programme est le suivant :

The argTest function expected 2 arguments. 1 was passed.
  Arg 0 = 42

The argTest function expected 2 arguments. 3 were passed.
  Arg 0 = Tue Sep 7 00:00:00 PDT 1999
  Arg 1 = Sam
  Arg 2 = 3.141592653589793

Voir aussi

Référence

new, opérateur

function, instruction

/fast