Directivas de preprocesado #include

Las directivas de preprocesado son instrucciones que el compilador procesa antes de compilar el código. Estas directivas permiten al programador incluir recursos externos o definir configuraciones previas. Una de las directivas más utilizadas es #include, que se emplea para incluir bibliotecas necesarias para el programa.

Uso de #include

La sintaxis básica para incluir una biblioteca estándar es:

    #include <nombre_biblioteca>
    

El uso de los signos de menor que y mayor que (< y >) indica al preprocesador que busque la biblioteca en los directorios estándar del compilador. Por ejemplo, para incluir la biblioteca iostream, que permite manejar la entrada y salida de datos, se utiliza:

    #include <iostream>
    

Características de iostream

La biblioteca iostream contiene clases y objetos que facilitan la manipulación de flujos de datos. Entre los elementos más comunes se encuentran:

• std::cin: Se utiliza para la entrada de datos desde el teclado.
• std::cout: Permite la salida de datos a la consola.
• std::cerr: Se usa para mostrar mensajes de error.
• std::clog: Proporciona un flujo para mensajes de registro.

Ejemplo básico utilizando std::cin y std::cout:

    #include <iostream>
    int main() {
        std::string nombre;
        std::cout << "Ingrese su nombre: ";
        std::cin >> nombre;
        std::cout << "Hola, " << nombre << "!" << std::endl;
        return 0;
    }
    

Inclusión de bibliotecas propias

Para incluir bibliotecas diseñadas por el programador, se utiliza la misma directiva #include, pero con una sintaxis diferente:

    #include "nombre_biblioteca.h"
    

El uso de comillas dobles indica al preprocesador que busque la biblioteca primero en el directorio del proyecto actual. Si no la encuentra, se buscará en los directorios estándar.

Ejemplo de una biblioteca personalizada:

    // archivo "mi_biblioteca.h"
    void saludar() {
        std::cout << "Hola desde una biblioteca personalizada!" << std::endl;
    }
    

    // archivo principal.cpp
    #include <iostream>
    #include "mi_biblioteca.h"
    int main() {
        saludar();
        return 0;
    }
    

El cuerpo del programa: la función main()

La función main() es el punto de entrada de cualquier programa en C++. Es donde comienza la ejecución del código, y su definición es esencial para cualquier programa funcional en este lenguaje.

Definición básica de main()

La forma más sencilla de definir main() es:

    int main() {
        // Aquí es donde se escribe el programa
        return 0;
    }
    

En esta definición:

• int: Especifica el tipo de dato que la función main() devuelve. En este caso, int significa que la función debe devolver un número entero.
• return 0;: Indica al sistema operativo que el programa terminó correctamente. Este valor se conoce como código de salida (exit code), donde 0 usualmente representa éxito, y otros valores pueden señalar errores.

¿Por qué int como tipo de retorno?

El estándar de C++ especifica que la función main() debe tener un tipo de retorno int (entero). Esto se debe a que el sistema operativo necesita un valor de retorno para determinar el estado del programa una vez finalizado. Por ejemplo:

• Un valor 0 indica que el programa terminó correctamente.
• Un valor diferente a 0 puede usarse para señalar errores específicos.

Definir main() con un tipo de retorno diferente, como void, es posible en algunos compiladores, pero no cumple con el estándar de C++ y puede causar problemas de compatibilidad.

No olvides comentar tu código

Los comentarios son esenciales para documentar el código y facilitar su comprensión. Aunque no afectan la ejecución del programa, son útiles para explicar el propósito o la lógica detrás de secciones específicas del código. Comentar es especialmente importante cuando el código tiene una lógica compleja o ha requerido un intenso trabajo de diseño. Nunca debemos dejarnos engañar por la sensación de tener claridad en el momento de escribir o leer nuestro propio código; esa claridad puede desaparecer por completo al día siguiente. La escritura de nuestro código debe ser lo más clara y limpia posible, y los comentarios deben ser la guía necesaria para preservar esta claridad.

En C++ existen dos tipos principales de comentarios:

• Comentarios de una línea:

  // Esto es un comentario de una sola línea
  

• Comentarios de múltiples líneas:

  /* Esto es un comentario
  que se puede desarrollar 
  en varias líneas */
  

Cosas que debemos hacer

• Agregar comentarios explicando el funcionamiento de algoritmos complicados o partes complejas del programa: Esto ayuda a futuros lectores, incluyendo tú mismo, a entender rápidamente la lógica implementada.
• Redactar los comentarios de una forma que sean fáciles de entender para tus compañeros: Este aspecto es esencial cuando trabajas en equipo o en proyectos colaborativos.

Cosas que debemos evitar

• Usar comentarios para explicar o repetir lo obvio: Por ejemplo, no es útil escribir // Esta línea suma dos números justo encima de int suma = a + b;.
• Justificar código oscuro con comentarios: Aunque los comentarios son importantes, la claridad del código debe ser siempre la prioridad. Un código legible y bien estructurado necesita menos comentarios para ser entendido.
• No actualizar los comentarios: Cuando edites el código, asegúrate de que los comentarios reflejen los cambios realizados. Los comentarios desactualizados pueden causar confusión.