
Un comentario en programación es la línea de texto en nuestro código fuente que el compilador ignora.
Sabemos que nuestro código fuente está compuesto de instrucciones, y el compilador traduce esas instrucciones del lenguaje de programación que estamos usando a lenguaje máquina.
Cuando el compilador se encuentra con un comentario, esa línea, o varias de ellas, no las traduce, y continúa buscando en la instrucción siguiente.
Los comentarios en programación se utilizan para poner aclaraciones del código, y así es más fácil de entender lo que hace, aunque también se utilizan para anular parte de un código.
Aunque con un sistema de control de versiones como GIT no sería necesario hacer eso.
En algunos lenguajes, como Java, se utilizan los comentarios con un formato específico para crear documentación aparte (llamado JavaDoc).
Ejemplos de comentarios
La mayoría de lenguajes de programación usan la sintaxis del comentario en C, que es la siguiente:
/* Esto es un comentario */
Con la sintaxis /*
*/
, podemos escribir en varias líneas
/* Esto
es
un
comentario */
En algunos lenguajes como en Java puedes usar los comentarios para crear documentación para tus clases, o una variable o un método.
De esta manera, usaríamos javadoc para generar ficheros de ayuda en HTML y servirían para describir el elemento declarado:
/** Comentario de documentación
* puede
* tener
* varias líneas
*/
C++ también añadió la opción de hacer un comentario en una línea:
//Comentario de tipo C++
Aunque recordemos que Java, C++, C, PHP y muchos lenguajes aceptan los dos tipos de comentario.
En otros lenguajes, los comentarios se hacen de otra forma. Veamos algunos de ellos
Comentario en Visual Basic
Todas las versiones de Visual Basic usan el símbolo '
'Comentario en
'visual basic
Comentario en Pascal
En Pascal, y también Delphi, para escribir comentario usamos (*
*)
(* Comentario en Pascal *)
Comentario en Python
En Python usamos #
como símbolo para iniciar un comentario en línea.
También podemos escribir comentarios multilíneas, escribimos la comilla doble 3 veces, así:
"""Comentario multilinea.
Segunda línea del comentario """
Comentario en HTML
En HTML, podemos escribir un comentario de esta manera:
<!-- Comentario HTML -->