2.6. Comentaris
A l’hora de programar és important que anem documentant el nostre codi segons l’anem escrivint perquè més endavant, quan tornem a obrir el nostre codi o quan una altra persona l’obri, puguem ser capaços d’entendre ràpidament què està passant en el programa.
Per a això, podem utilitzar comentaris, línies de codi que a l’hora d’executar el programa són ignorades per complet però que ens permeten escriure text.
En Javascript/P5.js tenim dues maneres diferents per escriure comentaris, que podem alternar segons les nostres necessitats.
Comentaris d’una sola línia
Els comentaris d’una única línia els escrivim començant la línia amb //, de la manera següent:
function setup() {
// Això és un comentari d’una sola línia
createCanvas(500, 500);
}
function draw() {
// Dibuixem una el·lipse amb ellipse(x, y, width, height)
ellipse(250, 250, 100, 100);
}
Comentaris de múltiples línies
Els comentaris de múltiples els escrivim tancant el seu text entre /* */, de la manera següent:
/* Això és un comentari de múltiples línies Tot el que escrigui aquí s’ignorarà quan executem el programa */
Un altre ús comú dels comentaris és utilitzar-los per «desactivar» parts del codi sense haver-lo d’esborrar. A l’exemple següent, el codi que dibuixa l’el·lipse és ignorat i únicament es dibuixa el rectangle.
function draw() {
// ellipse(250, 250, 100, 100);
rect(100, 100, 100, 50):
}
Els comentaris són clau quan estem aprenent a programar, per la qual cosa us aconsellem que els utilitzeu en escriure el vostre codi. Segons aneu adquirint soltesa i us familiaritzeu amb les funcions i els mètodes de P5.js, podreu anar-ne prescindint en casos que resultin redundants, ja que el codi en moltes ocasions s’explica per si mateix.