Añadir un bloque de comentarios al principio de un método es útil para añadir una nota sobre lo que hace un método, así como una lista de parámetros de entrada/salida. Y tener unas pocas líneas de texto legible dentro de una sección complicada de código puede ser conveniente para ayudarle a usted y a otros a recordar el propósito de esta sección particular de código. A partir de 4D v18, su experiencia de programación se ha mejorado con la adición de bloques de comentarios.
Los comentarios son texto (notas, descripciones, recordatorios, etc.) en el código fuente, designados con caracteres especiales para que sean ignorados por el compilador durante la ejecución del código. Los comentarios pueden estar en una sola línea de comentario o en varias líneas. Ahora, en lugar de tener muchas líneas prefijadas con //, puedes usar simplemente /* al principio de un comentario y */ al final para comentar un bloque entero. También puedes contraerlos y expandirlos. Y eso no es todo, puedes añadir comentarios a cualquier parte de una línea, incluso dentro de una condición if o un bucle:
Por qué son importantes los comentarios
- En un equipo con múltiples desarrolladores trabajando en el mismo proyecto, el código bien comentado es útil para los demás que trabajan en él, de manera que puedan entender mejor el código y facilitar el proceso de revisión/depuración del mismo.
- Somos humanos y olvidar cosas es completamente normal. Si ves o editas tu código más tarde, los comentarios pueden ayudarte a recordar la lógica que utilizaste al escribir ese código. Incluso si escribes un código realmente simple, intenta leerlo meses o años después. ¿Seguirá pareciendo sencillo, o desearás haber añadido comentarios?