Директива #include (C++)

Программирование на языке C++ — это искусство создания эффективных и мощных приложений. Важным аспектом этого процесса является использование библиотек и заголовочных файлов, которые предоставляют готовые решения для различных задач. Однако, чтобы воспользоваться этой функциональностью, необходимо понимать, как включать эти ресурсы в свой код. В этой статье мы рассмотрим директиву #include в языке C++.

Описание

Директива #include предоставляет компилятору возможность включить в код другой исходный файл, имя которого указывается после этой инструкции. Имя файла может быть заключено в двойные кавычки или угловые скобки (< >). #include обычно размещается в начале любой программы на языке C/C++.

Существует два типа файлов, которые можно включить с помощью директивы #include:

Заголовочные файлы, поставляемые с компилятором. Эти заголовочные файлы предустановлены в компиляторе и находятся в стандартной системной директории файлов. Эти файлы содержат объявления функций и определения макросов из стандартной библиотеки C/C++, которые могут быть использованы в нескольких исходных файлах. Функции, такие как printf(), scanf(), cout, cin и различные другие функции стандартного ввода-вывода или другие стандартные функции, содержатся в различных предустановленных заголовочных файлах.
Пользовательские заголовочные файлы. Эти файлы напоминают заголовочные файлы, за исключением того, что они созданы и определены пользователем самостоятельно. Это позволяет пользователю избежать необходимости многократно писать одну и ту же функцию.

Подключаемые файлы также могут содержать собственные инструкции #include, что называется вложенными подключениями.

Синтаксис

С помощью кавычек

Рассмотрим пример:

#include "file.h"

Эта инструкция указывает препроцессору включить содержимое файла с именем file.h в текущее место исходного кода, где находится сама инструкция.

С помощью угловых скобок (<>)

Для включения стандартных заголовочных файлов используются угловые скобки (< >), вместо двойных кавычек.

Пример использования угловых скобок:

#include <vector>

Использование угловых скобок (< >) является рекомендуемой практикой при включении стандартных заголовочных файлов.

Если подключаемый файл указан в угловых скобках (< >), то компилятор будет искать его в стандартных каталогах, предназначенных для хранения заголовочных файлов. В случае, если файл заключен в двойные кавычки, поиск будет происходить в текущем рабочем каталоге. Если файл не найден, то поиск продолжится в стандартных каталогах.

Примеры

Подключение стандартного системного файла

Для импорта заголовка системного ввода-вывода вы можете использовать следующий код:

#include <iostream>

int main() {
    // Ваш код здесь

    return 0;
}

Заголовок предоставляет доступ к стандартным потокам ввода и вывода, таким как cin и cout, которые вы можете использовать для взаимодействия с пользователем и вывода данных на экран. Вы можете размещать свой код внутри функции main(), которая является точкой входа в программу.

Создание и импорт определяемого пользователем файла

Для создания и импорта определяемого пользователем файла в C++, вы можете выполнить следующие шаги:

Создайте пользовательский заголовочный файл. Назовем его, например, «myheader.h«. В этом файле вы можете объявить функции, переменные или другие элементы, которые хотите использовать в своей программе.

#ifndef MYHEADER_H
#define MYHEADER_H

void customFunction(); // Пример объявления пользовательской функции

#endif

Создайте файл с исходным кодом вашей программы. Например, «main.cpp«. Включите пользовательский заголовочный файл с помощью директивы #include.

// main.cpp

#include <iostream>
#include "myheader.h" // Включение пользовательского заголовочного файла

int main() {
    std::cout << "Программа начала выполнение." << std::endl;

    // Вызов пользовательской функции
    customFunction();

    std::cout << "Программа завершила выполнение." << std::endl;

    return 0;
}

Ваш пользовательский заголовочный файл «myheader.h» содержит объявление функции customFunction(). Теперь вы должны реализовать эту функцию в отдельном файле, например, «myheader.cpp«.

// myheader.cpp

#include <iostream>
#include "myheader.h"

void customFunction() {
    std::cout << "Это пользовательская функция." << std::endl;
}

Теперь вы можете скомпилировать программу, включив оба файла «main.cpp» и «myheader.cpp«, чтобы создать исполняемый файл.

Затем выполните компиляцию и запустите программу. Программа будет использовать пользовательский заголовочный файл и функции, которые вы определили в «myheader.h» и «myheader.cpp«.

Вложенное подключение

Рассмотрим пример вложенного подключения с использованием инструкции #include на языке C++:

Главный файл программы (main.cpp):

#include <iostream>

int main() {
    std::cout << "Это из главного файла программы." << std::endl;
    
    // Включаем подключаемый файл
    #include "subfile.cpp"
    
    return 0;
}

Подключаемый файл (subfile.cpp):

#include <iostream>

void subFunction() {
    std::cout << "Это из подключаемого файла." << std::endl;
}

В этом примере main.cpp является основным файлом программы, который включает в себя subfile.cpp с использованием инструкции #include. Когда программа компилируется и запускается, она будет выводить текст из обоих файлов, и вы увидите вывод как из главного файла, так и из подключаемого файла.