## SmartPtr class


Classe de pointeur pour encapsuler les types alloués sur le tas. Utilisez‑la pour gérer la mémoire des classes héritant de [Object](../object/). Ce type de pointeur suit la sémantique des pointeurs intrusifs. Le compteur de références est stocké soit dans [Object](../object/) lui‑même, soit dans une structure de compteur liée étroitement à l’instance de [Object](../object/). Dans tous les cas, toutes les instances de [SmartPtr](./) forment un groupe de possession unique, quel que soit leur mode de création, ce qui diffère du comportement de la classe std::shared_ptr. Convertir un pointeur brut en [SmartPtr](./) est sûr tant qu’il existe d’autres instances de [SmartPtr](./) détenant des références partagées au même objet. Une instance de la classe [SmartPtr](./) peut être dans l’un des deux états : pointeur partagé et pointeur faible. Pour garder l’objet vivant, le nombre de références partagées doit rester positif. Les pointeurs faibles et partagés peuvent être utilisés pour accéder à l’objet pointé (appeler des méthodes, lire ou écrire des champs, etc.), mais les pointeurs faibles ne participent pas au comptage des références du pointeur partagé. [Object](../object/) est supprimé lorsque le dernier pointeur 'shared' [SmartPtr](./) qui le référence est détruit. Ainsi, assurez‑vous que cela ne se produise pas lorsqu’aucun autre pointeur partagé [SmartPtr](./) n’existe, par ex. pendant la construction ou la destruction de l’objet. Utilisez les objets sentinelles System::Object::ThisProtector (dans le code C++) ou les attributs CppCTORSelfReference ou CppSelfReference (dans le code C# traduit) pour corriger ce problème. De même, assurez‑vous de rompre les références cycliques en utilisant la classe de pointeur [System::WeakPtr](../weakptr/) ou le mode de pointeur [System::SmartPtrMode::Weak](../smartptrmode/) (dans le code C++) ou l’attribut CppWeakPtr (dans le code C# traduit). Si deux objets ou plus se référencent mutuellement à l’aide de pointeurs 'shared', ils ne seront jamais supprimés. Si le type de pointeur (faible ou partagé) doit être changé à l’exécution, utilisez la méthode [System::SmartPtr<T>::set_Mode()](./set_mode/) ou la classe [System::DynamicWeakPtr](../dynamicweakptr/). La classe [SmartPtr](./) ne contient aucune méthode virtuelle. Vous ne devez l’hériter que si vous créez votre propre stratégie de gestion de mémoire. Ce type est un pointeur pour gérer la suppression d’un autre objet. Il doit être alloué sur la pile et passé aux fonctions soit par valeur, soit par référence constante.

```cpp
template<class T>class SmartPtr
```


| Paramètre | Description |
| --- | --- |
| T | Type de l’objet pointé. Doit être soit [System::Object](../object/), soit une sous‑classe de celui‑ci. |
## Méthodes

| Méthode | Description |
| --- | --- |
| [begin](./begin/)() | Accesseur de la méthode [begin()](./begin/) d’une collection sous‑jacente. Ne compile que si [SmartPtr_](./smartptr_/) est un type spécialisé possédant la méthode [begin()](./begin/). |
| [begin](./begin/)() const | Accesseur de la méthode [begin()](./begin/) d’une collection sous‑jacente. Ne compile que si [SmartPtr_](./smartptr_/) est un type spécialisé possédant la méthode [begin()](./begin/). |
| [Cast](./cast/)() const | Convertit le pointeur en son propre type. |
| [Cast](./cast/)() const | Convertit le pointeur en type de base en utilisant static_cast. |
| [Cast](./cast/)() const | Convertit le pointeur en type dérivé en utilisant dynamic_cast. |
| [Cast](./cast/)() const | Convertit le pointeur en type dérivé en utilisant dynamic_cast. |
| [cbegin](./cbegin/)() const | Accesseur de la méthode [cbegin()](./cbegin/) d’une collection sous‑jacente. Ne compile que si [SmartPtr_](./smartptr_/) est un type spécialisé possédant la méthode [cbegin()](./cbegin/). |
| [cend](./cend/)() const | Accesseur de la méthode [cend()](./cend/) d’une collection sous‑jacente. Ne compile que si [SmartPtr_](./smartptr_/) est un type spécialisé possédant la méthode [cend()](./cend/). |
| [const_pointer_cast](./const_pointer_cast/)() const | Convertit le pointeur en un type différent en utilisant const_cast sur l’objet pointé. |
| [dynamic_pointer_cast](./dynamic_pointer_cast/)() const | Convertit le pointeur en un type différent en utilisant dynamic_cast sur l’objet pointé. |
| [end](./end/)() | Accesseur de la méthode [end()](./end/) d’une collection sous‑jacente. Ne compile que si [SmartPtr_](./smartptr_/) est un type spécialisé possédant la méthode [end()](./end/). |
| [end](./end/)() const | Accesseur de la méthode [end()](./end/) d’une collection sous‑jacente. Ne compile que si [SmartPtr_](./smartptr_/) est un type spécialisé possédant la méthode [end()](./end/). |
| [get](./get/)() const | Obtient l’objet pointé. |
| [get_Mode](./get_mode/)() const | Obtient le mode du pointeur. |
| [get_shared](./get_shared/)() const | Obtient l'objet pointé, mais affirme que le pointeur est en mode partagé. |
| [get_shared_count](./get_shared_count/)() const | Obtient le nombre de pointeurs partagés existants vers l'objet référencé, y compris le pointeur actuel. Affirme que le pointeur actuel est en mode partagé. |
| [GetHashCode](./gethashcode/)() const | Appelle [GetHashCode()](./gethashcode/) sur l'objet pointé. |
| [GetObjectNotNull](./getobjectnotnull/)() const | Obtient l'objet actuellement référencé (le cas échéant) ou lève une exception. |
| [GetObjectOrNull](./getobjectornull/)() const | Obtient l'objet pointé (le cas échéant) ou nullptr. Identique à [get()](./get/). |
| [GetObjectOwner](./getobjectowner/)() const | Obtient l'objet référencé. |
| [GetPointer](./getpointer/)() const | Obtient l'objet pointé (le cas échéant) ou nullptr. Identique à [get()](./get/). |
| [Is](./is/)(const System::TypeInfo\&) const | Vérifie si l'objet pointé est d'un type spécifique ou d'un type dérivé. Suit la sémantique 'is' de C#. |
| [IsAliasingPtr](./isaliasingptr/)() const | Vérifie si le pointeur pointe vers un autre objet que celui possédé (créé par un constructeur d'alias). |
| [IsShared](./isshared/)() const | Vérifie si le pointeur est en mode partagé. |
| [IsWeak](./isweak/)() const | Vérifie si le pointeur est en mode faible. |
| explicit [operator bool](./operatorbool/)() const | Vérifie si le pointeur n'est pas nul. |
| [operator!](./operator!/)() const | Vérifie si le pointeur est nul. |
| [operator*](./operator_/)() const | Obtient une référence à l'objet pointé. Affirme que le pointeur n'est pas nul. |
| [operator->](./operator-_/)() const | Permet d'accéder aux membres de l'objet référencé. |
| [operator<](./operator_/)(Y *) const | Fournit une sémantique de comparaison inférieure pour la classe [SmartPtr](./). |
| [operator<](./operator_/)(SmartPtr\<Y\> const\&) const | Fournit une sémantique de comparaison inférieure pour la classe [SmartPtr](./). |
| [operator=](./operator=/)(SmartPtr_\&&) | Effectue une assignation par déplacement de l'objet [SmartPtr](./). x devient inutilisable. |
| [operator=](./operator=/)(const SmartPtr_\&) | Effectue une assignation par copie de l'objet [SmartPtr](./). |
| [operator=](./operator=/)(const SmartPtr\<Q\>\&) | Effectue une assignation par copie de l'objet [SmartPtr](./). Effectue les conversions de type requises. |
| [operator=](./operator=/)(Pointee_ *) | Assigne un pointeur brut à l'objet [SmartPtr](./). |
| [operator=](./operator=/)(std::nullptr_t) | Définit la valeur du pointeur à nullptr. |
| [operator==](./operator==/)(std::nullptr_t) const | Vérifie si le pointeur pointe vers nullptr. |
| [operator[]](./operator[]/)(IdxType) const | Accesseur pour les éléments de tableau. Ne compile que si [SmartPtr_](./smartptr_/) est une spécialisation de [System::Array](../array/). |
| [RemoveAliasing](./removealiasing/)() const | Supprime l'alias (créé par un constructeur d'alias) du pointeur, s'assure qu'il gère (si partagé) ou suit (si faible) le même objet vers lequel il pointe. |
| [reset](./reset/)(Pointee_ *) | Définit l'objet pointé. |
| [reset](./reset/)() | Fait pointer le pointeur vers nullptr. |
| [set_Mode](./set_mode/)(SmartPtrMode) | Définit le mode du pointeur. Peut modifier les compteurs de références de l'objet référencé. |
| [SetContainedTemplateWeakPtr](./setcontainedtemplateweakptr/)(uint32_t) const | Appelle la méthode SetTemplateWeakPtr() sur l'objet pointé (le cas échéant). |
| [SmartPtr](./smartptr/)(SmartPtrMode) | Crée un objet [SmartPtr](./) du mode requis. |
| [SmartPtr](./smartptr/)(std::nullptr_t, SmartPtrMode) | Crée un objet [SmartPtr](./) nul du mode requis. |
| [SmartPtr](./smartptr/)(Pointee_ *, SmartPtrMode) | Crée un [SmartPtr](./) pointant vers l'objet spécifié, ou convertit un pointeur brut en [SmartPtr](./). |
| [SmartPtr](./smartptr/)(const SmartPtr_\&, SmartPtrMode) | Construit par copie un objet [SmartPtr](./). Les deux pointeurs pointent ensuite vers le même objet. |
| [SmartPtr](./smartptr/)(const SmartPtr\<Q\>\&, SmartPtrMode) | Construit par copie un objet [SmartPtr](./). Les deux pointeurs pointent ensuite vers le même objet. Effectue une conversion de type si autorisée. |
| [SmartPtr](./smartptr/)(SmartPtr_\&&, SmartPtrMode) | Construit par déplacement un objet [SmartPtr](./). Effectivement, échange deux pointeurs s'ils sont tous deux du même mode. x peut devenir inutilisable après l'appel. |
| explicit [SmartPtr](./smartptr/)(const SmartPtr\<Array\<Y\>\>\&, SmartPtrMode) | Convertit le type du tableau référencé en créant un nouveau tableau d'un type différent. Utile si, en C#, il existe un transtypage de tableau qui n'est pas pris en charge en C++. |
| explicit [SmartPtr](./smartptr/)(const Y\&) | Initialise un tableau vide. Utilisé pour traduire certaines constructions de code C#. |
| [SmartPtr](./smartptr/)(const SmartPtr\<P\>\&, Pointee_ *, SmartPtrMode) | Construit un [SmartPtr](./) qui partage les informations de propriété avec la valeur initiale de ptr, mais détient un pointeur p non lié et non géré. |
| [static_pointer_cast](./static_pointer_cast/)() const | Convertit le pointeur en un type différent en utilisant static_cast sur l'objet pointé. |
| [ToObjectPtr](./toobjectptr/)() const | Convertit tout type de pointeur en pointeur vers [Object](../object/). Ne nécessite pas que le type [Pointee_](./pointee_/) soit complet. |
| static [Type](./type/)() | Raccourci pour obtenir l'objet [System::TypeInfo](../typeinfo/) du type [Pointee_](./pointee_/). |
| [~SmartPtr](./~smartptr/)() | Détruit l'objet [SmartPtr](./). Si nécessaire, diminue le compteur de références de l'objet pointé et supprime l'objet. |
## Typedefs

| Typedef | Description |
| --- | --- |
| [ArrayType](./arraytype/) | Identique à [Pointee_](./pointee_/), s'il s'agit d'une spécialisation de [System::Array](../array/), et void sinon. |
| [Pointee_](./pointee_/) | Type pointé. |
| [SmartPtr_](./smartptr_/) | Type de pointeur intelligent spécialisé. |
| [ValueType](./valuetype/) | Type de stockage du tableau pointé. Significatif uniquement si T est une spécialisation de [System::Array](../array/). |

## Voir aussi

* Namespace [System](../)
* Library [Aspose.Page for C++](../../)