{"id":354,"date":"2022-10-04T12:52:28","date_gmt":"2022-10-04T10:52:28","guid":{"rendered":"http:\/\/quadern-programacio.recursos.uoc.edu\/?page_id=354"},"modified":"2022-10-07T12:50:50","modified_gmt":"2022-10-07T10:50:50","slug":"2-6-comentarios","status":"publish","type":"page","link":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/2-6-comentarios\/","title":{"rendered":"2.6. Comentarios"},"content":{"rendered":"<p>A la hora de programar es importante que vayamos documentando nuestro c\u00f3digo seg\u00fan lo vamos escribiendo para que m\u00e1s adelante, cuando volvamos a abrir nuestro c\u00f3digo o cuando otra persona lo abra, podamos ser capaces de entender r\u00e1pidamente qu\u00e9 est\u00e1 ocurriendo en el programa.<\/p>\n<p>Para ello, podemos utilizar <strong>comentarios<\/strong>, l\u00edneas de c\u00f3digo que a la hora de ejecutar el programa son ignoradas por completo pero que nos permiten escribir texto.<\/p>\n<p>En Javascript\/P5.js tenemos dos maneras distintas para escribir comentarios, que podemos alternar seg\u00fan nuestras necesidades.<\/p>\n<h3>Comentarios de una sola l\u00ednea<\/h3>\n<p>Los comentarios de una \u00fanica l\u00ednea los escribimos comenzando la l\u00ednea con <span class=\"courier\">\/\/<\/span>, de la siguiente manera:<\/p>\n<pre>function setup() {\r\n   \/\/ Eso es un comentario de una sola l\u00ednea\r\n   createCanvas(500, 500);\r\n}\r\n\r\nfunction draw() {\r\n   \/\/ Dibujamos una elipse con ellipse(x, y, width, height)\r\n   ellipse(250, 250, 100, 100);\r\n}<\/pre>\n<h3>Comentarios de m\u00faltiples l\u00edneas<\/h3>\n<p>Los comentarios de m\u00faltiples los escribimos encerrando su texto entre <span class=\"courier\">\/* *\/<\/span>, de la siguiente manera:<\/p>\n<pre>\/*\r\nEsto es un comentario de m\u00faltiples l\u00edneas\r\nTodo lo que escriba aqu\u00ed se ignorar\u00e1 cuando\r\nejecutemos el programa\r\n*\/<\/pre>\n<p>Otro uso com\u00fan de los comentarios es utilizarlos para \u00abdesactivar\u00bb partes del c\u00f3digo sin tener que borrarlo. En el siguiente ejemplo el c\u00f3digo que dibuja la elipse es ignorado y \u00fanicamente se dibuja el rect\u00e1ngulo.<\/p>\n<pre>function draw() {\r\n   \/\/ ellipse(250, 250, 100, 100);\r\n   rect(100, 100, 100, 50):\r\n}<\/pre>\n<p>Los comentarios son clave cuando estamos aprendiendo a programar, por lo que os aconsejamos que los utilic\u00e9is al escribir vuestro c\u00f3digo. Seg\u00fan vay\u00e1is adquiriendo soltura y os familiaric\u00e9is con las funciones y los m\u00e9todos de P5.js, podr\u00e9is ir prescindiendo de estos en casos que resulten redundantes, ya que el c\u00f3digo en muchas ocasiones se explica por s\u00ed mismo.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A la hora de programar es importante que vayamos documentando nuestro c\u00f3digo seg\u00fan lo vamos escribiendo para que m\u00e1s adelante, cuando volvamos a abrir nuestro c\u00f3digo o cuando otra persona lo abra, podamos ser capaces de entender r\u00e1pidamente qu\u00e9 est\u00e1 ocurriendo en el programa. Para ello, podemos utilizar comentarios, l\u00edneas de c\u00f3digo que a la [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"acf":[],"_links":{"self":[{"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/pages\/354"}],"collection":[{"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/comments?post=354"}],"version-history":[{"count":2,"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/pages\/354\/revisions"}],"predecessor-version":[{"id":556,"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/pages\/354\/revisions\/556"}],"wp:attachment":[{"href":"http:\/\/quadern-programacio.recursos.uoc.edu\/es\/wp-json\/wp\/v2\/media?parent=354"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}