Guide d'utilisation en ligne


Piste: Commentaires
 
 

Commentaires

Il existe deux formes de commentaires soutenues en Abstrasy:


Commentaires uni-lignes

Il s'agit de commentaire qui commence par le caractère sharp “#” et s'arrête à la fin de la ligne courante.

# Ceci est un commentaire uni-ligne...
(display "est évalué...")
# (display "n'est pas évalué")
(display "évalué") # (display "pas évalué")


Blocs de commentaires

Il s'agit de commentaires délimité par les séquences “#|” et “|#”. Ainsi, tout ce qui est compris entre “#|” et “|#” est considéré comme un commentaire et n'est pas évalué.

#|
   Ceci ne sera pas évalué...
|#
(display "est évalué")

Il est donc possible de délimiter des commentaires qui occupent de nombreuses lignes.

On peut aussi améliorer très facilement le style d'un commentaire qui s'étend sur plusieurs lignes. En effet, comme un bloc de commentaires commence lorsqu'on trouve la séquence de caractères “#|” et qu'il se termine dès lors que la séquence de caractères “|#” est trouvée, on peut commencer un commentaire de plusieurs lignes par une ligne qui contient “#|#” et le terminer de la même manière. Le rendu du commentaire peut de cette manière être plus symétrique et donc plus agréable.

#|#
 
   Ceci ne sera pas évalué...
 
   Comme vous pouvez le constater, le style de ce bloc de commentaires composé de
   plusieurs lignes est d'un style plus agréable.
 
   Il s'agit cependant d'un choix de style laissé totalement à l'appréciation du
   programmeur.
 
#|#
(display "Ceci est évalué")

Bien entendu, vous êtes libre d'utiliser le style que vous préférez. Cette considération est totalement subjective.

On retiendra cependant qu'un bloc de commentaires peut s'insérer n'importe où dans le code source d'un programme.

Par exemple:

(define 'x #| x est la variable |# 10 #| et 10 la valeur |#)
scripting/abstrasy/x1/syntaxe/commentaires.txt · Dernière modification: 2020/12/26 16:19 par admin