valueOf (méthode Object.valueOf)

Renvoie la valeur primitive de l'objet spécifié. Si l'objet n'a pas de valeur primitive, il est renvoyé.

Valeur renvoyée

Exemple

L'exemple suivant affiche la valeur renvoyée de valueOf() pour un objet générique (qui n'a pas de valeur primitive) et la compare à la valeur renvoyée par toString(). Créez tout d'abord un objet générique. Dans une deuxième étape, créez un nouvel objet date défini sur le 1er février 2004, 8:15. La méthode toString() renvoie l'heure actuelle en clair. La méthode valueOf() renvoie la valeur primitive en millisecondes. Dans une troisième étape, créez un nouvel objet tableau contenant deux éléments simples. toString() et valueOf() renvoient tous les deux la même valeur : one,two :

// Crée un objet générique.
var myObject:Object = new Object();
trace(myObject.valueOf()); // Renvoie : [object Object]
trace(myObject.toString()); // Renvoie : [object Object]

Les exemples suivants affichent les valeurs renvoyées pour les classes intégrées Date et Array, et les comparent aux valeurs renvoyées de Object.toString():

// Crée un objet Date défini sur le 1er février 2004, 8h15 AM
// La méthode toString() renvoie l'heure sous une forme compréhensible par 
// une personne
// La méthode valueOf() renvoie la valeur primitive en millisecondes.
var myDate:Date = new Date(2004,01,01,8,15);
trace(myDate.toString()); // Renvoie : Dim Fév 1 08:15:00 GMT-0800 2004
trace(myDate.valueOf()); // Renvoie : 1075652100000

// Crée un nouvel objet Array contenant deux éléments simples
// Dans ce cas toString() et valueOf() renvoient la même valeur : one,two
var myArray:Array = new Array("one", "two");
trace(myArray.toString()); // Renvoie : one,two
trace(myArray.valueOf()); // Renvoie : one,two

Voir l'exemple relatif à Object.toString() pour obtenir un exemple de la valeur renvoyée par Object.valueOf() pour une classe personnalisée remplaçant toString().

valueOf (méthode Object.valueOf)

Valeur renvoyée

Exemple

Voir aussi