Package | mx.utils |
Classe | public class ObjectUtil |
Héritage | ObjectUtil Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
ObjectUtil.isSimple()
.
Méthode | Défini par | ||
---|---|---|---|
[statique]
Copie l’objet spécifié et renvoie une référence à la copie. | ObjectUtil | ||
[statique]
Compare les objets et renvoie une valeur entière indiquant si le premier élément est inférieur, supérieur ou égal au deuxième élément. | ObjectUtil | ||
[statique]
Copie l’objet spécifié et renvoie une référence à la copie. | ObjectUtil | ||
[statique]
Compare les deux objets Date et renvoie une valeur entière indiquant si le premier objet Date est antérieur, égal à ou postérieur au second élément. | ObjectUtil | ||
[statique]
Renvoie des informations relatives à la classe et les propriétés de la classe, pour l’objet spécifié. | ObjectUtil | ||
hasMetadata(obj:Object, propName:String, metadataName:String, excludes:Array = null, options:Object = null):Boolean [statique]
Utilise la classe getClassInfo et examine les informations de métadonnées pour déterminer si une propriété d’un objet donné possède les métadonnées spécifiées. | ObjectUtil | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
[statique]
Renvoie la valeur true si l’objet est une instance d’une classe dynamique. | ObjectUtil | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
[statique]
Renvoie la valeur true si la référence d’objet spécifiée est un type de données simple. | ObjectUtil | ||
[statique]
Compare deux valeurs numériques. | ObjectUtil | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
[statique]
Compare deux valeurs de chaîne. | ObjectUtil | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[statique]
Effectue le formatage de l’objet spécifié en chaîne. | ObjectUtil | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
clone | () | méthode |
public static function clone(value:Object):Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Copie l’objet spécifié et renvoie une référence à la copie. Cette copie est effectuée à l’aide d’une technique de sérialisation native. Cela signifie que la sérialisation personnalisée est respectée lors de la copie. clone() Diffère de copy() en ce que la propriété uid de chaque instance d’objet est conservée.
Cette méthode est conçue pour copier des objets de données, tels que les éléments d’un ensemble. Elle n’est pas conçue pour copier un objet UIComponent, tel qu’un contrôle TextInput. Si vous souhaitez dupliquer des objets UIComponent, vous pouvez créer une sous-classe du composant et implémenter une méthode clone()
.
Paramètres
value:Object — Objet qui doit être copié.
|
Object — Clone de l’objet spécifié.
|
compare | () | méthode |
public static function compare(a:Object, b:Object, depth:int = -1):int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Compare les objets et renvoie une valeur entière indiquant si le premier élément est inférieur, supérieur ou égal au deuxième élément. Cette méthode compare, de manière récursive, les propriétés des objets imbriqués et effectue un renvoi dès qu’un résultat différent de zéro est trouvé. Par défaut, cette méthode est exécutée de manière récursive sur le niveau le plus profond des propriétés. Pour modifier la profondeur à des fins comparatives, spécifiez une valeur non négative pour le paramètre depth
.
Paramètres
a:Object — Objet.
| |
b:Object — Object.
| |
depth:int (default = -1 ) — Indique le nombre de niveaux à récurser lors de la comparaison. Définissez cette valeur sur 0 pour une comparaison simple de la représentation primitive de chaque propriété uniquement. Par exemple :var a:Object = {name:"Bob", info:[1,2,3]}; var b:Object = {name:"Alice", info:[5,6,7]}; var c:int = ObjectUtil.compare(a, b, 0); Dans l’exemple ci-dessus, les propriétés complexes de |
int — Renvoie 0 si a et b sont null, NaN, ou égaux. Renvoie 1 si a est null ou supérieur à b. Renvoie -1 si b est null ou supérieure à a.
|
copy | () | méthode |
public static function copy(value:Object):Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Copie l’objet spécifié et renvoie une référence à la copie. Cette copie est effectuée à l’aide d’une technique de sérialisation native. Cela signifie que la sérialisation personnalisée est respectée lors de la copie.
Cette méthode est conçue pour copier des objets de données, tels que les éléments d’un ensemble. Elle n’est pas conçue pour copier un objet UIComponent, tel qu’un contrôle TextInput. Si vous souhaitez créer des copies de certains objets UIComponent, vous pouvez créer une sous-classe du composant et implémenter la méthode clone()
ou une autre méthode pour effectuer la copie.
Paramètres
value:Object — Objet qui doit être copié.
|
Object — Copie de l’objet spécifié.
|
dateCompare | () | méthode |
public static function dateCompare(a:Date, b:Date):int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Compare les deux objets Date et renvoie une valeur entière indiquant si le premier objet Date est antérieur, égal à ou postérieur au second élément.
Paramètres
a:Date — Objet Date.
| |
b:Date — Objet Date.
|
int — 0 si a et b sont égaux (ou s’ils sont null ) ; -1 si a est antérieur à b (ou b est null ) ; 1 si a est postérieur à b (ou a est null ).
|
getClassInfo | () | méthode |
public static function getClassInfo(obj:Object, excludes:Array = null, options:Object = null):Object
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie des informations relatives à la classe et les propriétés de la classe, pour l’objet spécifié.
Paramètres
obj:Object — Objet à inspecter.
| |
excludes:Array (default = null ) — Tableau de chaînes spécifiant les noms de propriété devant être exclus du résultat obtenu. Par exemple, vous pouvez spécifier ["currentTarget","target"] pour un objet Event, car ces propriétés peuvent renvoyer des résultats trop larges.
| |
options:Object (default = null ) — Objet contenant une ou plusieurs propriétés qui contrôlent les informations renvoyées par cette méthode. Ces propriétés sont les suivantes :
|
Object — Objet contenant les propriétés suivantes :
|
hasMetadata | () | méthode |
public static function hasMetadata(obj:Object, propName:String, metadataName:String, excludes:Array = null, options:Object = null):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Utilise la classe getClassInfo
et examine les informations de métadonnées pour déterminer si une propriété d’un objet donné possède les métadonnées spécifiées.
Paramètres
obj:Object — Objet contenant la propriété.
| |
propName:String — Propriété dans laquelle rechercher les métadonnées.
| |
metadataName:String — Nom des métadonnées à rechercher dans la propriété.
| |
excludes:Array (default = null ) — Indique si des propriétés doivent être exclues lors de la génération des informations de classe. (Facultatif)
| |
options:Object (default = null ) — Spécifie si des indicateurs d’options doivent être modifiés lors de la génération des informations de classe. (Facultatif)
|
Boolean — true si la propriété possède les métadonnées spécifiées.
|
isDynamicObject | () | méthode |
public static function isDynamicObject(obj:Object):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie la valeur true
si l’objet est l’instance d’une classe dynamique.
Paramètres
obj:Object — Objet.
|
Boolean — Renvoie la valeur true si l’objet est l’instance d’une classe dynamique.
|
isSimple | () | méthode |
public static function isSimple(value:Object):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie true
si la référence d’objet spécifiée est un type de données simple. Les types de données simples sont les suivants :
String
Number
uint
int
Boolean
Date
Array
Paramètres
value:Object — Objet inspecté.
|
Boolean — true si l’objet spécifié est de l’un des types ci-dessus, false dans le cas contraire.
|
numericCompare | () | méthode |
public static function numericCompare(a:Number, b:Number):int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Compare deux valeurs numériques.
Paramètres
a:Number — Premier nombre.
| |
b:Number — Deuxième nombre.
|
int — 0 indique que les deux nombres sont NaN. 1 si seulement a est NaN. -1 si seulement b est NaN. -1 si a est inférieur à b . 1 si a est supérieur à b .
|
stringCompare | () | méthode |
public static function stringCompare(a:String, b:String, caseInsensitive:Boolean = false):int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Compare deux valeurs de chaîne.
Paramètres
a:String — Première valeur de chaîne.
| |
b:String — Deuxième valeur de chaîne.
| |
caseInsensitive:Boolean (default = false ) — Indique d’effectuer une comparaison de la non-sensibilité à la casse, true , ou pas, false .
|
int — 0 indique que les deux chaînes sont null. 1 si seulement a est null. -1 si seulement b est null. -1 si a précède b . 1 si b précède a .
|
toString | () | méthode |
public static function toString(value:Object, namespaceURIs:Array = null, exclude:Array = null):String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Formate l’objet spécifié en chaîne. Toutes les propriétés sont classées selon leur ordre alpha. Un ID sera affecté à chaque objet pendant l’impression ; cette valeur s’affiche en regard du jeton de type d’objet précédée d’un ’#’, par exemple :
(mx.messaging.messages::AsyncMessage)#2.
Cet ID est utilisé pour indiquer la modification d’une référence circulaire. Les propriétés d’un objet de type Class
s’affichent uniquement en tant que type affecté. Par exemple, une définition personnalisée comme suit :
public class MyCustomClass { public var clazz:Class; }
La propriété clazz
affectée à Date
s’affiche comme indiqué ci-dessous :
(somepackage::MyCustomClass)#0 clazz = (Date)
Paramètres
value:Object — Objet à formater.
| |
namespaceURIs:Array (default = null ) — Tableau d’URI d’espace de noms pour les propriétés qui doivent être incluses à la sortie. Par défaut, seules les propriétés de l’espace de noms public sont incluses à la sortie. Pour obtenir toutes les propriétés indépendamment de l’espace de noms, transmettez un tableau avec un seul élément ".
| |
exclude:Array (default = null ) — Tableau des noms de propriété qui doivent être exclus de la sortie. Utilisez-le pour supprimer les données de la chaîne formatée.
|
String — Chaîne contenant la version formatée de l’objet spécifié.
|
Exemple
Comment utiliser cet exemple
// example 1 var obj:AsyncMessage = new AsyncMessage(); obj.body = []; obj.body.push(new AsyncMessage()); obj.headers["1"] = { name: "myName", num: 15.3}; obj.headers["2"] = { name: "myName", num: 15.3}; obj.headers["10"] = { name: "myName", num: 15.3}; obj.headers["11"] = { name: "myName", num: 15.3}; trace(ObjectUtil.toString(obj)); // will output to flashlog.txt (mx.messaging.messages::AsyncMessage)#0 body = (Array)#1 [0] (mx.messaging.messages::AsyncMessage)#2 body = (Object)#3 clientId = (Null) correlationId = "" destination = "" headers = (Object)#4 messageId = "378CE96A-68DB-BC1B-BCF7FFFFFFFFB525" sequenceId = (Null) sequencePosition = 0 sequenceSize = 0 timeToLive = 0 timestamp = 0 clientId = (Null) correlationId = "" destination = "" headers = (Object)#5 1 = (Object)#6 name = "myName" num = 15.3 10 = (Object)#7 name = "myName" num = 15.3 11 = (Object)#8 name = "myName" num = 15.3 2 = (Object)#9 name = "myName" num = 15.3 messageId = "1D3E6E96-AC2D-BD11-6A39FFFFFFFF517E" sequenceId = (Null) sequencePosition = 0 sequenceSize = 0 timeToLive = 0 timestamp = 0 // example 2 with circular references obj = {}; obj.prop1 = new Date(); obj.prop2 = []; obj.prop2.push(15.2); obj.prop2.push("testing"); obj.prop2.push(true); obj.prop3 = {}; obj.prop3.circular = obj; obj.prop3.deeper = new ErrorMessage(); obj.prop3.deeper.rootCause = obj.prop3.deeper; obj.prop3.deeper2 = {}; obj.prop3.deeper2.deeperStill = {}; obj.prop3.deeper2.deeperStill.yetDeeper = obj; trace(ObjectUtil.toString(obj)); // will output to flashlog.txt (Object)#0 prop1 = Tue Apr 26 13:59:17 GMT-0700 2005 prop2 = (Array)#1 [0] 15.2 [1] "testing" [2] true prop3 = (Object)#2 circular = (Object)#0 deeper = (mx.messaging.messages::ErrorMessage)#3 body = (Object)#4 clientId = (Null) code = (Null) correlationId = "" destination = "" details = (Null) headers = (Object)#5 level = (Null) message = (Null) messageId = "14039376-2BBA-0D0E-22A3FFFFFFFF140A" rootCause = (mx.messaging.messages::ErrorMessage)#3 sequenceId = (Null) sequencePosition = 0 sequenceSize = 0 timeToLive = 0 timestamp = 0 deeper2 = (Object)#6 deeperStill = (Object)#7 yetDeeper = (Object)#0 // example 3 with Dictionary var point:Point = new Point(100, 100); var point2:Point = new Point(100, 100); var obj:Dictionary = new Dictionary(); obj[point] = "point"; obj[point2] = "point2"; obj["1"] = { name: "one", num: 1}; obj["two"] = { name: "2", num: 2}; obj[3] = 3; trace(ObjectUtil.toString(obj)); // will output to flashlog.txt (flash.utils::Dictionary)#0 {(flash.geom::Point)#1 length = 141.4213562373095 x = 100 y = 100} = "point2" {(flash.geom::Point)#2 length = 141.4213562373095 x = 100 y = 100} = "point" {1} = (Object)#3 name = "one" num = 1 {3} = 3 {"two"} = (Object)#4 name = "2" num = 2
Tue Jun 12 2018, 09:30 AM Z