Classe System::Object

Object class

Classe de base qui permet d’utiliser les méthodes disponibles pour la classe System.Object en C#. Toutes les classes non triviales utilisées avec l’environnement traduit doivent en hériter.

class Object

Méthodes

MéthodeDescription
virtual Equals(ptr)Compare les objets en utilisant la sémantique C# Object.Equals.
static Equals(T1 const&, T2 const&)Compare les objets de type référence dans le style C#.
static Equals(T1 const&, T2 const&)Compare les objets de type valeur dans le style C#.
static Equals(float const&, float const&)Émule la comparaison en virgule flottante de style C# où deux NaN sont considérés égaux même si, selon IEC 60559:1989, NaN n’est égal à aucune valeur, y compris NaN.
static Equals(double const&, double const&)Émule la comparaison en virgule flottante de style C# où deux NaN sont considérés égaux même si, selon IEC 60559:1989, NaN n’est égal à aucune valeur, y compris NaN.
virtual FastCast(const Details::FastRttiBase&, void **) constÀ usage interne uniquement.
GetCounter()Obtient la structure de données du compteur de références associée à l’objet.
virtual GetHashCode() constAnalogue de la méthode C# Object.GetHashCode(). Permet le hachage d’objets personnalisés.
virtual GetType() constObtient le type réel de l’objet. Analogue de l’appel C# System.Object.GetType().
virtual Is(const TypeInfo&) constVérifie si l’objet représente une instance du type décrit par targetType. Analogue de l’opérateur C# ‘is’.
Lock()Implémente le verrouillage de l’instruction C# lock(). Appelez directement ou utilisez l’objet sentinelle LockContext.
virtual MemberwiseClone() constAnalogue de la méthode C# Object.MemberwiseClone(). Permet le clonage de types personnalisés.
Object()Crée l’objet. Initialise toutes les structures de données internes.
Object(Object const&)Constructeur de copie. Ne copie en fait rien, il initialise simplement un nouvel objet et permet la construction par copie des sous‑classes.
operator=(Object const&)Opérateur d’affectation. Ne copie en fait rien, il initialise simplement un nouvel objet et permet la construction par copie des sous‑classes.
static ReferenceEquals(ptr const&, ptr const&)Compare les objets par référence.
static ReferenceEquals(T const&, T const&)Compare les objets par référence.
static ReferenceEquals(T const&, std::nullptr_t)Compare par référence un objet de type valeur avec nullptr.
ReferenceEquals(String const&, std::nullptr_t)Spécialisation de Object::ReferenceEquals pour le cas d’une chaîne et nullptr.
ReferenceEquals(String const&, String const&)Spécialisation de Object::ReferenceEquals pour le cas de chaînes.
RemovedSharedRefs(int)Diminue le compteur de références partagées de la valeur spécifiée.
virtual SetTemplateWeakPtr(uint32_t)Définir le n-ième argument de modèle comme un pointeur faible (plutôt que partagé). Permet de basculer les pointeurs dans les conteneurs en mode faible.
SharedCount() constObtient la valeur actuelle du compteur de références partagées.
SharedRefAdded()Incrémente le compteur de références partagées. Ne doit pas être appelé directement ; utilisez plutôt les pointeurs intelligents ou ThisProtector.
SharedRefRemovedSafe()Décrémente et renvoie le compteur de références partagées. Ne doit pas être appelé directement ; utilisez plutôt les pointeurs intelligents ou ThisProtector.
virtual ToString() constAnalogue de la méthode C# Object.ToString(). Permet de convertir des objets personnalisés en chaîne.
static Type()Implémente le construct C# typeof(System.Object).
Unlock()Implémente le déverrouillage de l’instruction C# lock(). Appelez directement ou utilisez l’objet sentinelle LockContext.
WeakRefAdded()Incrémente le compteur de références faibles. Ne doit pas être appelé directement ; utilisez plutôt les pointeurs intelligents ou ThisProtector.
WeakRefRemoved()Décrémente le compteur de références faibles. Ne doit pas être appelé directement ; utilisez plutôt les pointeurs intelligents ou ThisProtector.
virtual ~Object()Détruit l’objet. Libère toutes les structures de données internes.

Typedefs

TypedefDescription
ptrAlias pour le type de pointeur intelligent.

Remarques

En plus des méthodes disponibles dans la classe C# System.Object, il permet également la prise en charge de certains concepts spécifiques à l’environnement de code traduit. Cela inclut le comptage de références utilisé par les classes de pointeurs intelligents (System::SmartPtr, System::WeakPtr, System::DynamicWeakPtr) et d’autres services liés à la gestion de la mémoire, au débogage, etc.

Chaque Object possède deux compteurs de références : le compteur de références partagé et le compteur de références faible. Le compteur de références faible est toujours stocké dans une structure de données détachée plutôt que dans le Object lui‑même, ce qui permet aux pointeurs faibles de survivre à l’objet référencé. Le compteur de références intelligent est stocké soit dans l’objet lui‑même, soit dans la même structure détachée, selon l’état de la macro ENABLE_EXTERNAL_REFCOUNT. Par défaut, il est activé dans les builds de débogage et désactivé dans les builds de version. Si le compteur de pointeur intelligent est stocké dans l’objet lui‑même, la structure de données détachée n’est créée que si des pointeurs faibles vers l’objet existent. Sinon, elle est créée en même temps que l’objet.

Tous les pointeurs intelligents utilisent ces deux compteurs de références et contribuent au même groupe de possession unique.

Si une sous‑classe de Object est créée sur la pile, aucun pointeur intelligent ne peut être créé vers celle‑ci, sinon il y a un problème de suppression de la pile.

Ce type peut être alloué soit sur la pile en tant que type valeur, soit sur le tas en utilisant la fonction System::MakeObject(). Une fois l’objet alloué, ne mélangez jamais ces deux cas d’utilisation : avoir des pointeurs SmartPtr vers des objets alloués sur la pile est strictement interdit.

Voir aussi

Classe System::NullableUtils Classe System::ObjectExt