Директивы препроцессора #include

Директивы препроцессора — это инструкции, которые компилятор обрабатывает до начала компиляции кода. Эти директивы позволяют программисту подключать внешние ресурсы или определять предварительные настройки. Одна из самых часто используемых директив — #include, которая применяется для подключения библиотек, необходимых для программы.

Использование #include

Базовый синтаксис для подключения стандартной библиотеки:

#include <nazvanie_biblioteki>

Использование знаков «меньше» и «больше» (< и >) указывает препроцессору искать библиотеку в стандартных директориях компилятора. Например, чтобы подключить библиотеку iostream, которая позволяет работать с вводом и выводом данных, используется:

#include <iostream>

Особенности библиотеки iostream

Библиотека iostream содержит классы и объекты, облегчающие работу с потоками данных. Среди наиболее часто используемых элементов:

• std::cin: Используется для ввода данных с клавиатуры.
• std::cout: Позволяет выводить данные на консоль.
• std::cerr: Используется для вывода сообщений об ошибках.
• std::clog: Обеспечивает поток для регистрационных сообщений.

Простой пример с использованием std::cin и std::cout:

#include <iostream>
int main() {
    std::string imya;
    std::cout << "Vvedite vashe imya: ";
    std::cin >> imya;
    std::cout << "Privet, " << imya << "!" << std::endl;
    return 0;
}

Подключение собственных библиотек

Для подключения библиотек, разработанных программистом, используется та же директива #include, но с другим синтаксисом:

#include "nazvanie_biblioteki.h"

Использование двойных кавычек указывает препроцессору сначала искать библиотеку в текущем каталоге проекта. Если она там не найдена, поиск продолжается в стандартных директориях.

Пример пользовательской библиотеки:

// fayl "moya_biblioteka.h"
void privetstvie() {
    std::cout << "Privet iz polzovatelskoy biblioteki!" << std::endl;
}

// fayl glavnyy.cpp
#include <iostream>
#include "moya_biblioteka.h"
int main() {
    privetstvie();
    return 0;
}

Основная часть программы: функция main()

Функция main() — это точка входа для любой программы на C++. Именно здесь начинается выполнение кода, и её определение является обязательным для любой рабочей программы на этом языке.

Базовое определение main()

Самый простой способ определить main() выглядит следующим образом:

int main() {
    // Zdes' nachinaetsya programa
    return 0;
}

В этом определении:

• int: Указывает тип данных, который возвращает функция main(). В данном случае int означает, что функция должна возвращать целое число.
• return 0;: Сообщает операционной системе, что программа завершилась успешно. Это значение известно как код завершения (exit code), где 0 обычно обозначает успех, а другие значения могут сигнализировать об ошибках.

Почему тип возврата int?

Стандарт C++ требует, чтобы функция main() имела тип возврата int (целое число). Это связано с тем, что операционная система ожидает получить код возврата для определения состояния программы после её завершения. Например:

• Значение 0 указывает на успешное завершение программы.
• Значение, отличное от 0, может использоваться для обозначения конкретных ошибок.

Определение main() с другим типом возврата, например void, возможно в некоторых компиляторах, но не соответствует стандарту C++ и может вызывать проблемы с совместимостью.

Не забудьте прокомментировать код

Комментарии играют важную роль в документировании кода и упрощении его понимания. Хотя они не влияют на выполнение программы, они помогают объяснить цель или логику конкретных частей кода. Комментирование особенно важно, когда код содержит сложную логику или потребовал значительных усилий при разработке. Никогда не обманывайтесь чувством ясности при написании или чтении собственного кода; это чувство может исчезнуть уже на следующий день. Код должен быть максимально понятным и аккуратным, а комментарии должны служить необходимым руководством для сохранения этой ясности.

В C++ существует два основных типа комментариев:

• Однострочные комментарии:

  // Eto odnostrochnyy kommentariy
  

• Многострочные комментарии:

  /* Eto kommentariy
  na neskol'ko strok */
  

Что нужно делать

• Добавлять комментарии, объясняющие работу сложных алгоритмов или сложных частей программы: Это поможет будущим читателям, включая вас самих, быстро понять реализованную логику.
• Писать комментарии так, чтобы они были понятны вашим коллегам: Это особенно важно при работе в команде или над совместными проектами.

Чего следует избегать

• Использовать комментарии для объяснения очевидного: Например, не имеет смысла писать // Eta stroka skladyvayet dva chisla перед int summa = a + b;.
• Оправдывать сложный код с помощью комментариев: Хотя комментарии важны, приоритетом должна быть ясность самого кода. Понятный и хорошо структурированный код требует меньше комментариев для понимания.
• Не обновлять комментарии: При редактировании кода убедитесь, что комментарии соответствуют внесённым изменениям. Устаревшие комментарии могут привести к путанице.