Developpez.com - Autres
X

Choisissez d'abord la catégorieensuite la rubrique :

Sommaire > S'initier à Perl > Les commentaires
        Comment insérer un commentaire dans le code ?
        Comment commenter des portions de code plus larges ?

        


Comment insérer un commentaire dans le code ?
auteur : 2Eurocents
En perl, il est possible, et même recommandé, d'émailler son code de lignes ou de portions de lignes de commentaires. Un commentaire commence simplement par le caractère # (dièse) et s'étend jusqu'à la fin de la ligne (retour chariot).


Comment commenter des portions de code plus larges ?
auteur : 2Eurocents
Il est vrai que le mécanisme de commentaires commençant par un dièse et se terminant à la fin de la ligne manque de souplesse, notamment dans le cas où l'on souhaite commenter de larges blocs de code. Dans ce cas, il est possible de détourner un mécanisme avancé de PERL qui est conçu pour permettre d'avoir des scripts contenant leur propre documentation : POD (pour Plain Old Documentation - Bonne Vielle Documentation - très utile par ailleurs). Ce mécanisme permet d'insérer la documentation sous la forme de larges plages de texte qui seront ignorées par l'interpréteur PERL. Rien n'empêche de substituer notre code à commenter au texte de la documentation. Schématiquement, dans un but de commentaire, cette documentation commence au marqueur =pod, rencontré en début de ligne de code, et se termine au marqueur =cut.

$i=5; # ici, ce code est interprété =pod Nous sommes ici dans une zone ignorée. $i=7; Aucun code n'est interprété et les # sont ignorés. =cut print $i."\n"; # mais l'interprétation reprend ses droits, ici même.

        

Consultez les autres F.A.Q's

Ce document issu de www.developpez.com est soumis à la licence GNU FDL traduit en français ici
Permission vous est donnée de distribuer, modifier des copies de cette page tant que cette note apparaît clairement.
Contacter le responsable de la rubrique Autres