Comentarios
P: ¿Qué hace un programador cuando necesita escribir documentación para su código?
R: La escribe en un archivo de Word.
P: ¿Qué hace un buen programador cuando necesita escribir documentación para su código?
R: Utiliza comentarios.
Vamos a convertirte en un buen programador y también a enseñarte cómo utilizar comentarios dentro de tu código. Pero primero, averigüemos qué son:
En TypeScript, existen dos tipos de comentarios:
- Podemos comentar una línea completa usando
//; - También podemos comentar un bloque de código que abarque varias líneas o un fragmento de código de una sola línea usando
/* code */.
Veamos un ejemplo donde necesitamos comentar algunas líneas y escribir comentarios allí. Repito, el compilador no ejecutará ni siquiera revisará los fragmentos de código comentados, así que podemos escribir cualquier cosa allí (excepto palabras malsonantes; mi mamá me regaña si escribo esas).
12345678console.log("Hello world!") // This code performs output of information to the screen. let word : string = 'c<>definity' console.log(`Hello ${word}!`) /*This code creates a variable of type string and uses it for output to the screen. We use this variable with the required syntax and successfully display text on the screen with the variable. */
Como se puede observar en el código anterior, hemos comentado varios fragmentos de texto. En los comentarios, se escriben explicaciones sobre lo que ocurre en el código y lo que hacen ciertas líneas. Tenga en cuenta que al comentar varias líneas, se utiliza una sintaxis de comentario diferente. (/* */)
Después de //, todo lo que se encuentra a la derecha de estos caracteres queda comentado.
También es posible comentar fragmentos de código. Por ejemplo, si se sospecha un error en una línea en particular, se puede comentar esa línea y ejecutar el código nuevamente para verificar si contiene errores.
123//var str = 'Hello World"; var num = 132; console.log(num/* - str*/);
En el ejemplo anterior, se han comentado fragmentos de código en los que se sospechan errores utilizando diferentes tipos de comentarios. Personalmente, suelo identificar áreas propensas a errores en el código mediante este método, y recomiendo hacer lo mismo. Es una habilidad útil para un buen programador.
Además, no olvide documentar su código. Es como dejar una botella de agua junto a la cama después de una noche de copas.
¡Gracias por tus comentarios!
Pregunte a AI
Pregunte a AI
Pregunte lo que quiera o pruebe una de las preguntas sugeridas para comenzar nuestra charla
Can you explain the difference between single-line and multi-line comments again?
Why is it important to use comments in code?
Can you give more examples of when to use comments?
Awesome!
Completion rate improved to 2.94
Comentarios
Desliza para mostrar el menú
P: ¿Qué hace un programador cuando necesita escribir documentación para su código?
R: La escribe en un archivo de Word.
P: ¿Qué hace un buen programador cuando necesita escribir documentación para su código?
R: Utiliza comentarios.
Vamos a convertirte en un buen programador y también a enseñarte cómo utilizar comentarios dentro de tu código. Pero primero, averigüemos qué son:
En TypeScript, existen dos tipos de comentarios:
- Podemos comentar una línea completa usando
//; - También podemos comentar un bloque de código que abarque varias líneas o un fragmento de código de una sola línea usando
/* code */.
Veamos un ejemplo donde necesitamos comentar algunas líneas y escribir comentarios allí. Repito, el compilador no ejecutará ni siquiera revisará los fragmentos de código comentados, así que podemos escribir cualquier cosa allí (excepto palabras malsonantes; mi mamá me regaña si escribo esas).
12345678console.log("Hello world!") // This code performs output of information to the screen. let word : string = 'c<>definity' console.log(`Hello ${word}!`) /*This code creates a variable of type string and uses it for output to the screen. We use this variable with the required syntax and successfully display text on the screen with the variable. */
Como se puede observar en el código anterior, hemos comentado varios fragmentos de texto. En los comentarios, se escriben explicaciones sobre lo que ocurre en el código y lo que hacen ciertas líneas. Tenga en cuenta que al comentar varias líneas, se utiliza una sintaxis de comentario diferente. (/* */)
Después de //, todo lo que se encuentra a la derecha de estos caracteres queda comentado.
También es posible comentar fragmentos de código. Por ejemplo, si se sospecha un error en una línea en particular, se puede comentar esa línea y ejecutar el código nuevamente para verificar si contiene errores.
123//var str = 'Hello World"; var num = 132; console.log(num/* - str*/);
En el ejemplo anterior, se han comentado fragmentos de código en los que se sospechan errores utilizando diferentes tipos de comentarios. Personalmente, suelo identificar áreas propensas a errores en el código mediante este método, y recomiendo hacer lo mismo. Es una habilidad útil para un buen programador.
Además, no olvide documentar su código. Es como dejar una botella de agua junto a la cama después de una noche de copas.
¡Gracias por tus comentarios!