Comentario
Mejora la legibilidad del código para otros programadores, así como para usted mismo, lo que le permite proporcionar información sobre cómo se manejan las cosas complejas en el programa para una comprensión y mantenimiento más profundas. Exploraremos los diferentes tipos de comentarios que apoyan DART en este artículo."
Diferente tipo de comentario en un dardo en Ubuntu 20.04?
En Dart, puede hacer comentarios de varias maneras de la siguiente manera:
Comentarios de una sola línea.
sintaxis: // comentario de una sola línea.Comentarios de múltiples líneas.
sintaxis: /* comentario de una sola línea.*/Comentarios de documentación de una sola línea.
sintaxis: /// comentario de una sola línea.Comentarios de documentación de múltiples líneas.
Sintaxis: /** Comentario de una sola línea.*\Cómo usar el comentario en el dardo en Ubuntu 20.04?
Entre las declaraciones de DART, puede agregar comentarios donde sea del programa. El compilador/intérprete simplemente descarta los comentarios en nuestro código, lo que no da a ningún cambio en la salida final del programa. En pocas palabras, los comentarios sirven como una explicación breve y comprensible para un código específico. Tenga en cuenta que los comentarios no deben usarse para explicar el código mal escrito. Siempre intente producir un código claro y legible antes de agregar comentarios. Tenemos diferentes tipos de comentarios utilizados en el script de DART de la siguiente manera:
Ejemplo # 1: Uso del comentario de una sola línea en un dardo en Ubuntu 20.04
Un comentario de una sola línea se expresa con el doble llave hacia adelante (//) y contribuye sustancialmente al carácter de Newline. Se usa un comentario de una sola línea en Dart para comentar en una línea hasta que se rompa.
Tenemos nuestro primer comentario de una sola línea utilizada en la sección principal de dardos del código. El comentario de una sola línea tiene la fórmula "área", que hemos utilizado en la variable "área."Para limpiar a los lectores, hemos utilizado la fórmula del área aquí. Luego, nuevamente usamos un comentario de una sola línea para demostrar lo que sucede a continuación en la función de impresión.
Puede notar que el texto de comentarios de una sola línea es ignorado aquí por el compilador DART; Solo se muestra el "área", que hemos pasado dentro de la función de impresión.
Ejemplo # 2: Uso del comentario de múltiples líneas en un dardo en Ubuntu 20.04
Los comentarios de varias líneas pueden emplearse cuando necesite agregar comentarios a muchas líneas. Los comentarios de Dart Multiline se utilizan para comentar secciones completas de código. Comienza y termina un comentario múltiple con "/*" y "*/" respectivamente. Entre la sección de comentario multiline " / * y * /", el compilador ignora todo. Por otro lado, no se puede envolver un comentario de varias líneas dentro de otro comentario de múltiples líneas.
Ahora, tenemos una representación del comentario multiline en el método principal del programa DART anterior. Hemos utilizado el comentario multiline para dar los detalles que vamos a crear una lista de enteros con la sintaxis de la lista en dardo. Luego, hemos construido una variable "lista" que contiene el número de listas con la representación de la lista de dardos. Nuevamente, hemos utilizado comentarios multilínea para detallar la función de impresión. La lista se imprimirá en la pantalla utilizando la función de impresión.
Tras la interpretación, solo tenemos una lista como salida. El texto de comentarios multiline no se muestra en la pantalla. El compilador lo elimina por defecto.
Ejemplo # 3: Uso del comentario de una línea única en Doc en un dardo en Ubuntu 20.04
Los comentarios de documentación son un tipo de comentario que normalmente se usa para producir documentación o un recurso para una tarea o producto de software. Un comentario de documentación es un comentario de línea única o múltiples con los caracteres /// o /* al principio.
Puede usar un comentario de una línea de DOC en líneas sucesivas, que es lo mismo que un comentario de múltiples líneas. El intérprete Dart excluye estas líneas, excepto las que se colocan dentro de los soportes rizados. Triple Slash o Triple Forward Slash se puede usar en un comentario de Doc de una sola línea.
Después de crear el método principal, hemos utilizado tres cortes de avance para el comentario de una línea de documentación. El comentario de una línea de DOC se utiliza para la declaración de la variable. Esta es la propiedad del comentario de una línea de DOC utilizada antes de las variables, la función o la definición de clase del código. Se declara la variable "String1", inicializando el valor de la cadena. Luego, tenemos seis líneas del comentario de una línea de documentación antes de la función de impresión. Podemos usar tantos comentarios de una sola línea en el código. Pero tenemos que usar los comentarios de una sola línea para la información válida en el código para que la claridad del código no esté comprometida.
Solo se muestra la declaración dentro de la función de impresión en la pantalla. Los comentarios de una línea de una línea se muestran en el shell.
Ejemplo # 4: Uso del comentario de línea multiline DOC en un dardo en Ubuntu 20.04
Estos personajes "**/** ...*/**" se utilizan para hacer comentarios de DOC de múltiples líneas. A continuación se muestra un comentario de DOC de múltiples líneas. El siguiente ejemplo explica el uso de la documentación Multiline Comentarios en el código de dardo.
Dentro del método principal, los comentarios de DOC Multiline se usan con el carácter de barra invertida "/" y el personaje de doble astreisco "**."Hemos usado el personaje de ventaja de avance solo una vez. Esto significa que ingresamos a la sección de comentarios y usamos el asterisco para crear DOC más comentarios múltiples. Luego, los comentarios de DOC Multiline terminaron con un personaje de asterisco y el personaje de ventaja hacia adelante "/."Después de eso, tenemos una declaración en la función de impresión que se muestra solo en la pantalla.
Los comentarios de DOC Multiline no se utilizan para fines de ejecución. Son ignorados por el compilador, como se muestra en la pantalla de shell.
Conclusión
Aunque nos consideramos programadores, la mayor parte del texto en un código fuente está diseñado para la lectura humana. Unos pocos segundos de escribir un comentario simple y preciso puede salvar a una de las muchas horas de la persona. Cada lenguaje de programación admite comentarios en el código específico para la conveniencia de su lector. Aunque, el lenguaje de Dart tiene numerosas formas de crear comentarios en el código. Tenemos una representación general de los comentarios de Dart con los cuatro ejemplos.