Querido Ndugu,
Parece ser que decía Marcel Proust que
La sabiduría no nos viene dada, sino que debemos descubrirla por nosotros mismos, después de un viaje que nadie puede ahorrarnos o hacer por nosotros.
Creo que en gran medida tiene razón pero hay ocasiones en las que otros que han hecho ya el camino pueden indicarnos “atajos” que hayan encontrado en su duro paseo, y como “recoger la sabiduría de otros, también es de sabios”, he pensado en compartir dos trucos que mi lento transcurrir por el mundo de la programación me han dejado.
Se trata de dos usos de comentarios que no he leído/encontrado en ningún sitio, que en algún momento “inventé” o mejor “descubrí”, y que no sé hasta qué punto otros viejos programadores de C++ (o en general de lenguajes con comentarios del tipo /* ... */) tienen en su repertorio. Por si resultan no estar extendidos, los grito aquí a los cuatro vientos para que cualquier teclario que los vea pueda aprovecharse de ellos y extenderlos por el mundo.
Mientras se programa, muchas veces estamos haciendo pruebas y queremos activar y desactivar trozos de código. Cuando el código ocupa poco (una o dos líneas), es rápido comentarlas utilizando los comentarios de una única línea. Lo incómodo llega cuando la sección ocupa un número de líneas considerable; en ese caso, es mucho mejor utilizar los comentarios de bloque, /* ... */.
Sin embargo, activar y desactivar una sección de código utilizando esta técnica requiere “visitar” el principio y el final del bloque, para poner o quitar los dos símbolos, el de apertura y el de cierre del comentario.
Y aquí va mi primer “truco”. Ya he comentado anteriormente que no lo he visto en ningún sitio, aunque sí he leido algo similar en el manual de LUA. Consiste en terminar la sección de código que queremos poder activar y desactivar rápidamente con un comentario multilinea vacío, es decir, con /**/. La peculiaridad de este comentario vacío es que puedes antecederlo con otra apertura de comentario multilínea, de tal forma que quede algo como /* ... /**/. El analizador léxico ignorará la segunda apertura, por encontrarse dentro de una sección comentada.
Por tanto, gracias al sencillo paso de colocar el comentario vacío al final de la sección, nos basta con abrir el comentario al principio de la misma para desactivarla:
/*
.... sección larga de código
.... que queremos activar y
.... desactivar fácilmente
/**/
Para volver a activar la sección, basta con borrar esa primera apertura, aunque yo aconsejo a su vez comentarla con un //, ya que de esta forma se sabe en qué sección concreta estaba el programador pensando cuando colocó el /**/.
///*
.... sección larga de código
.... que queremos activar y
.... desactivar fácilmente
/**/
Considero que esta sencilla técnica por sí sola es ya lo suficientemente útil como para darla a conocer a todos aquellos que no hubieran llegado a ella por ellos mismos. Sin embargo, puede darse una vuelta de tuerca más, para obtener otro método también útil en otras circunstancias.
Se da a veces que, siguiendo con la misma idea, tenemos dos secciones de código seguidas y excluyentes con las que queremos hacer pruebas, de tal forma que unas veces queremos compilar la aplicación con la sección de arriba, y otras veces con la de abajo. Por ejemplo:
// Sección 1
CMapLoder::Init();
CMapLoader::LoadMap("mapa1.map");
/**/
/*
// Sección 2
map = new CMap();
map->addEntity(creaEntornoVacio());
/**/
Tenemos dos secciones, una que construye un mapa utilizando un cargador de disco, y otra que lo crea desde código. Una veces queremos utilizar una y otras veces la otra. En este caso, debemos “activar” una sección y “desactivar” otra en cada prueba. Siguiendo con el truco anterior, eso puede hacerse cómodamente poniendo al final de ambas secciones el ya explicado /**/, pero no deja de ser algo pesado, ya que hay que quitar y poner dos aperturas de comentario (en el ejemplo anterior, habría que poner el /* al principio de la sección 1, y quitarlo en el de la sección 2).
Para evitarlo, y este es el segundo truco que quería contar, basta con:
- Colocar un
/**/ al final de la última sección.
- Colocar un
/*/ entre las dos secciones.
De esta forma, para elegir una u otra alternativa, basta con abrir o no abrir un comentario multilínea al principio de la primera sección, aprovechando que el /*/ que aparece entre ambas secciones unas veces hace de inicio de comentario multilinea y otras veces hace de cierre.
Como ejemplo, a continuación aparece el código con la sección 1 comentada y la sección 2 activa (observar que el /*/ del centro sirve de cierre de comentario multilinea):
/*
// Sección 1
CMapLoder::Init();
CMapLoader::LoadMap("mapa1.map");
/*/
// Sección 2
map = new CMap();
map->addEntity(creaEntornoVacio());
/**/
Y para cambiarlo y activar la sección 1, basta con quitar la apertura inicial (o comentarla con un comentario de línea); en ese caso, el /*/ sirve para iniciar un comentario multilinea que se cierra al final de la sección 2:
///*
// Sección 1
CMapLoder::Init();
CMapLoader::LoadMap("mapa1.map");
/*/
// Sección 2
map = new CMap();
map->addEntity(creaEntornoVacio());
/**/
Probadlo, y veréis lo cómodo que es…
Sin embargo, siempre nos quedará la duda de qué hubiese sido de la buena de Lucía si hubiese caído en las manos de un profesor de Pascal atento y consagrado a sus alumnos como el Coronel Jessep. Quiero pensar que, de haber tenido esa suerte, Lucía no le habría cogido manía a la programación y habría acabado la carrera con un buen expediente. Hoy, Lucía se seguiría llamando Miriam y sería feliz como analista programadora en alguna empresa, o (soñar es gratis) habría decidido estudiar el doctorado y sería una teclaria más. Nunca lo sabremos.
