Vous pouvez l'utiliser en codant une des fonctions membre suivantes dans une classe C++ :
void show_self();
virtual void show_self();
Cette fonction peut être publique, protégée ou privée mais elle ne peut pas être héritée d'une classe de base. Il ne peut pas s'agir d'une fonction incorporée ni d'une fonction purement virtuelle.
Si vous fournissez cette fonction membre, elle peut être appelée à partir du débogueur lorsque l'application en cours de débogage est interrompue. Pour l'appeler, cliquez avec le bouton droit de la souris sur un objet C++ ou un pointeur désignant un objet C++ dans la vue Moniteurs ou la vue Variables. S'il existe une fonction membre show_self dans la classe, show_self s'affichera dans le menu en incrustation. Sélectionnez cette action pour exécuter la fonction membre show_self.
Avec le moteur de débogage version 11.2 ou antérieure, l'action de menu pour show_self n'est disponible que pour les applications AIX.
Si vous avez codé une fonction membre show_self() mais que l'action show_self ne s'affiche pas pour cette classe, vérifiez que la fonction a bien été inclue dans votre application. L'éditeur de liens des applications peut avoir supprimé la fonction membre show_self() si elle n'était pas référencée dans votre code ou de manière explicite dans la commande d'éditeur de liens.
La fonction show_self permet normalement d'afficher le contenu d'un objet C++. Comme le code est exécuté dans le processus du programme à déboguer, il n'est pas limité à cette action. L'utilisation d'une fonction show_self dans une classe définie localement sur une autre fonction n'est pas prise en charge.
Les actions suivantes d'une fonction show_self provoquent l'échec de la session de débogage :
Le débogueur exécute la fonction show_self sur une unité d'exécution arbitraire dans le processus du programme à déboguer ; toutes les autres unités d'exécution sont autorisées à poursuivre. Le débogueur supprime tous les points d'arrêt et points de contrôle pendant son exécution et il ne répond pas pendant toute l'exécution de la fonction.
Pour avoir une liste des limitations de la fonction show_self(), consultez la rubrique connexe.