¿Cómo funcionan y para qué sirven los comentarios? - Curso de C++ - Capítulo 4

Curso de c++ desde cero

En este capítulo vas a ver para qué son los comentarios y cuales son las formas de crearlos. Un tema muy simple pero importante en cualquier lenguaje de programación.

Los comentarios en C++

Algo indispensable en cualquier lenguaje de programación son los comentarios. Estos son para anular trozos de código que no queremos borrar por si necesitamos más tarde, para ir anotando para qué sirve cada parte del código, para dar consejos, pequeñas sugerencias, advertencias, etc. de esta forma, sabremos en el futuro de un vistazo para qué sirve cada parte y lo sabrán otros desarrolladores que lean nuestro código.
C++ tiene dos tipos de comentarios, los de una sola línea // y los multilínea /* */.

Comentarios de una línea de C++

Para escribir un comentario de una sola línea, debemos escribir al comienzo dos barras //.

En el siguiente ejemplo, puedes ver unos cuantos comentarios. Estos están describiendo cada parte del código. Así, es más fácil ver las diferentes secciones.

Los comentarios no afectan en absoluto a la ejecución del código, ya que son ignorados por completo.

Código C++

// Importaciones
#include <windows.h>
#include <iostream>
using namespace std;

// main
int main()
{
	// Cambia la codificación de caracteres de la salida en consola
	SetConsoleOutputCP(1252);

	// Imprimir mensajes en la consola
	cout << "Hola mundo." << endl;
	cout << "Esta es otra línea.";
}

Además de dedicar línea enteras para cada comentario, podemos ponerlos junto con alguna línea de código a su derecha, ya que si lo hacemos a la izquierda, anularemos dicha línea, ya que como he dicho, los comentarios son ignorados, por esto, va a tomar toda la línea de código como si fuera un comentario.

Código C++

// Importaciones
#include <windows.h>
#include <iostream>
using namespace std;

// main
int main()
{
	// Cambia la codificación de caracteres de la salida en consola
	SetConsoleOutputCP(1252);

	// Imprimir mensajes en la consola
	cout << "Hola mundo." << endl; // Esta línea tiene un salto de línea.
	cout << "Esta es otra línea.";
}

Los comentarios multilínea en C++

Los comentarios multilínea de C++ sirven para lo mismo que los otros, solo que en este caso, si el comentario ocupa más de una línea, en lugar de usar varios de una sola línea, podemos utilizar uno multilínea. Aquí un ejemplo:

Código C++

/* Este programa es muy sencillo. Tiene lo justo
para imprimir mensajes en la consola.
Además, se ha añadido un cambio en la codificación
por defecto para poder visualizar correctamente los
acentos y las ñ en la consola, ya que está escrito
en español.*/

// Importaciones
#include <windows.h>
#include <iostream>
using namespace std;

// main
int main()
{
	// Cambia la codificación de caracteres de la salida en consola
	SetConsoleOutputCP(1252);

	// Imprimir mensajes en la consola
	cout << "Hola mundo." << endl; // Esta línea tiene un salto de línea.
	cout << "Esta es otra línea.";
}

Anular código con comentarios en C++

Podemos anular líneas de código con los comentarios:

Código C++


#include <windows.h>
#include <iostream>
using namespace std;

int main()
{
	SetConsoleOutputCP(1252);
	//cout << "Hola mundo." << endl;
	cout << "Esta es otra línea.";
}

terminal Resultado en la consola terminal

Si lo ejecutamos, nos aparece únicamente la línea que no está comentada. La otra se ha anulado.

Esta es otra línea.

Para anular trozos de código de más de una línea, emplea el comentario multilinea.

Código C++


#include <windows.h>
#include <iostream>
using namespace std;

int main()
{
	SetConsoleOutputCP(1252);
	/*
	cout << "Hola mundo." << endl;
	cout << "Esta es otra línea.";
	*/
}

terminal Resultado en la consola terminal

Si lo ejecutamos, no aparece ninguna línea en la consola, ya que se han anulado las dos.