В чем разница между #include <filename> и #include "filename"?

На практике разница заключается в том, где препроцессор ищет включенный файл.

Для #include <filename> препроцессор выполняет поиск в зависимости от реализации, обычно в каталогах поиска, предварительно назначенных компилятором / IDE. Этот метод обычно используется для включения файлов заголовков стандартной библиотеки.

Для #include "filename" препроцессор сначала выполняет поиск в том же каталоге, что и файл, содержащий директиву, а затем следует пути поиска, используемому для формы #include <filename>. Этот метод обычно используется для включения файлов заголовков, определенных программистом.

Более полное описание доступно в GCC документация по путям поиска.

<file> include указывает препроцессору искать в каталогах -I и в предварительно определенных каталогах первый, а затем в каталоге файла .c. "file" include сообщает препроцессору, что нужно выполнить поиск в каталоге первый исходного файла, а затем вернуться к -I и предопределенному. Все равно ищутся все направления, отличается только порядок поиска.

Стандарт 2011 года в основном обсуждает включаемые файлы в «16.2 Включение исходного файла».

2 A preprocessing directive of the form

# include <h-char-sequence> new-line

searches a sequence of implementation-defined places for a header identified uniquely by the specified sequence between the < and > delimiters, and causes the replacement of that directive by the entire contents of the header. How the places are specified or the header identified is implementation-defined.

3 A preprocessing directive of the form

# include "q-char-sequence" new-line

causes the replacement of that directive by the entire contents of the source file identified by the specified sequence between the " delimiters. The named source file is searched for in an implementation-defined manner. If this search is not supported, or if the search fails, the directive is reprocessed as if it read

# include <h-char-sequence> new-line

with the identical contained sequence (including > characters, if any) from the original directive.

Обратите внимание, что форма "xxx" ухудшается до формы <xxx>, если файл не найден. Остальное определяется реализацией.

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

Если используется форма #include "file", реализация сначала ищет файл с заданным именем, если он поддерживается. Если не (поддерживается) или поиск завершается неудачно, реализация ведет себя так, как если бы использовалась другая (#include <file>) форма.

Кроме того, существует третья форма, которая используется, когда директива #include не соответствует ни одной из форм выше. В этой форме некоторая базовая предварительная обработка (такая как расширение макроса) выполняется для «операндов» директивы #include, и ожидается, что результат будет соответствовать одной из двух других форм.

Единственный способ узнать это - прочитать документацию по вашей реализации.

В пунктах 2–4 раздела 6.10.2 стандарт C говорится:

• A preprocessing directive of the form

  #include <h-char-sequence> new-line
  

  searches a sequence of implementation-defined places for a header identified uniquely by the specified sequence between the < and > delimiters, and causes the replacement of that directive by the entire contents of the header. How the places are specified or the header identified is implementation-defined.

• A preprocessing directive of the form

  #include "q-char-sequence" new-line
  

  causes the replacement of that directive by the entire contents of the source file identified by the specified sequence between the " delimiters. The named source file is searched for in an implementation-defined manner. If this search is not supported, or if the search fails, the directive is reprocessed as if it read

  #include <h-char-sequence> new-line
  

  with the identical contained sequence (including > characters, if any) from the original directive.

• A preprocessing directive of the form

  #include pp-tokens new-line
  

  (that does not match one of the two previous forms) is permitted. The preprocessing tokens after include in the directive are processed just as in normal text. (Each identifier currently defined as a macro name is replaced by its replacement list of preprocessing tokens.) The directive resulting after all replacements shall match one of the two previous forms. The method by which a sequence of preprocessing tokens between a < and a > preprocessing token pair or a pair of " characters is combined into a single header name preprocessing token is implementation-defined.

Definitions:

• h-char: any member of the source character set except the new-line character and >

• q-char: any member of the source character set except the new-line character and "

Оно делает:

"mypath/myfile" is short for ./mypath/myfile

где . является либо каталогом файла, в котором содержится #include, и / или текущим рабочим каталогом компилятора, и / или default_include_paths

и

<mypath/myfile> is short for <defaultincludepaths>/mypath/myfile

Если ./ находится в <default_include_paths>, это не имеет значения.

Если mypath/myfile находится в другом подключаемом каталоге, поведение не определено.

Для #include "" компилятор обычно выполняет поиск в папке файла, который содержит это include, а затем в других папках. Для #include <> компилятор не выполняет поиск в папке текущего файла.

#Include с угловыми скобками будет искать файл, который нужно включить, в «зависящем от реализации списке мест» (что является очень сложным способом сказать «системные заголовки»).

#Include с кавычками будет просто искать файл (и «в зависимости от реализации», bleh). Это означает, что на обычном английском языке он попытается применить путь / имя файла, которые вы ему укажете, и не будет добавлять системный путь в начале или вмешиваться в него в противном случае.

Кроме того, если #include "" не удается, он перечитывается как #include по стандарту.

документация gcc имеет (специфичное для компилятора) описание, которое, хотя и относится к gcc, а не к стандарту, намного проще для понимания, чем разговоры адвоката о стандартах ISO.

#include "filename" // User defined header
#include <filename> // Standard library header.

Пример:

Имя файла здесь Seller.h:

#ifndef SELLER_H     // Header guard
#define SELLER_H     // Header guard

#include <string>
#include <iostream>
#include <iomanip>

class Seller
{
    private:
        char name[31];
        double sales_total;

    public:
        Seller();
        Seller(char[], double);
        char*getName();

#endif

В реализации класса (например, Seller.cpp и в других файлах, которые будут использовать файл Seller.h) теперь должен быть включен заголовок, определенный пользователем, как показано ниже:

#include "Seller.h"

По крайней мере, для версии GCC

Поэтому, если вы хотите сгенерировать правила зависимостей (например, используя опцию GCC -M), вы должны использовать цитируемую форму для файлов, которые должны быть включены в дерево зависимостей.

(См. http://gcc.gnu.org/onlinedocs/cpp/Invocation.html)

Некоторые хорошие ответы здесь содержат ссылки на стандарт C, но забыли стандарт POSIX, особенно конкретное поведение команды c99 (например, компилятор C).

Согласно Базовые спецификации Open Group, выпуск 7,

-Idirectory

Change the algorithm for searching for headers whose names are not absolute pathnames to look in the directory named by the directory pathname before looking in the usual places. Thus, headers whose names are enclosed in double-quotes ( "" ) shall be searched for first in the directory of the file with the #include line, then in directories named in -I options, and last in the usual places. For headers whose names are enclosed in angle brackets ( "<>" ), the header shall be searched for only in directories named in -I options and then in the usual places. Directories named in -I options shall be searched in the order specified. Implementations shall support at least ten instances of this option in a single c99 command invocation.

Таким образом, в POSIX-совместимой среде с POSIX-совместимым компилятором C #include "file.h", вероятно, сначала будет искать ./file.h, где . - это каталог, в котором находится файл с оператором #include, а #include <file.h>, скорее всего, сначала будет искать /usr/include/file.h. , где /usr/include - это обычные места, определенный вашей системой для заголовков (похоже, не определен в POSIX).

• #include <> предназначен для предопределенных файлов заголовков

Если файл заголовка предопределен, вы просто должны написать имя файла заголовка в угловых скобках, и это будет выглядеть так (при условии, что у нас есть предопределенное имя файла заголовка iostream):

#include <iostream>

• #include " " предназначен для файлов заголовков, определяемых программистом.

Если бы вы (программист) написали свой собственный файл заголовка, вы бы написали имя файла заголовка в кавычках. Итак, предположим, вы написали заголовочный файл с именем myfile.h, тогда это пример того, как вы могли бы использовать директиву include для включения этого файла:

#include "myfile.h"

Простое общее правило - использовать угловые скобки для включения файлов заголовков, поставляемых с компилятором. Используйте двойные кавычки для включения любых других файлов заголовков. Большинство компиляторов делают это именно так.

1.9 - Заголовочные файлы объясняет более подробно директивы препроцессора. Если вы начинающий программист, эта страница должна помочь вам во всем этом разобраться. Я узнал об этом отсюда и слежу за этим на работе.

Многие ответы здесь сосредоточены на путях, которые компилятор будет искать, чтобы найти файл. Хотя это то, что делают большинство компиляторов, соответствующий компилятор может быть предварительно запрограммирован с использованием эффектов стандартных заголовков и обрабатывать, скажем, #include <list> как переключатель, и он вовсе не обязательно должен существовать как файл.

Это не чисто гипотетическое. По крайней мере, один компилятор работает таким образом. Рекомендуется использовать #include <xxx> только со стандартными заголовками.

#include <filename> используется при обращении к системному файлу. Это файл заголовка, который можно найти в системных местоположениях по умолчанию, таких как /usr/include или /usr/local/include. Для ваших собственных файлов, которые необходимо включить в другую программу, вы должны использовать синтаксис #include "filename".

Спасибо за отличные ответы, особенно. Адам Стельмашчик и piCookie, и аиб.

Как и многие программисты, я использовал неформальное соглашение об использовании формы "myApp.hpp" для конкретных файлов приложения и формы <libHeader.hpp> для системных файлов библиотеки и компилятора, то есть файлов, указанных в /I и переменной среды INCLUDE, в течение многих лет считая, что это стандарт.

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

#include "../../MyProgDir/SourceDir1/someFile.hpp"

В более старых версиях MSVS требовалась двойная обратная косая черта (\\), но теперь это не требуется. Не знаю, когда это изменилось. Просто используйте косую черту для совместимости с 'nix (Windows примет это).

Если вас это беспокоит В самом деле, используйте "./myHeader.h" для включаемого файла в том же каталоге, что и исходный код (в моем текущем, очень большом проекте есть несколько повторяющихся имен включаемых файлов, разбросанных по сторонам - на самом деле проблема управления конфигурацией).

Вот Объяснение MSDN, скопированный сюда для вашего удобства).

Quoted form

The preprocessor searches for include files in this order:

1. In the same directory as the file that contains the #include statement.
2. In the directories of the currently opened include files, in the reverse order in which
   they were opened. The search begins in the directory of the parent include file and
   continues upward through the directories of any grandparent include files.
3. Along the path that's specified by each /I compiler option.
4. Along the paths that are specified by the INCLUDE environment variable.

Angle-bracket form

The preprocessor searches for include files in this order:

1. Along the path that's specified by each /I compiler option.
2. When compiling occurs on the command line, along the paths that are specified by the INCLUDE environment variable.

#include <filename>

используется, когда вы хотите использовать файл заголовка системы C / C++ или библиотек компилятора. Эти библиотеки могут быть stdio.h, string.h, math.h и т. д.

используется, когда вы хотите использовать свой собственный файл заголовка, который находится в папке вашего проекта или где-то еще.

Для получения дополнительной информации о препроцессорах и заголовке. Прочтите C - Препроцессоры.

По стандарту - да, разные:

• A preprocessing directive of the form

  #include <h-char-sequence> new-line
  

  searches a sequence of implementation-defined places for a header identified uniquely by the specified sequence between the < and > delimiters, and causes the replacement of that directive by the entire contents of the header. How the places are specified or the header identified is implementation-defined.

• A preprocessing directive of the form

  #include "q-char-sequence" new-line
  

  causes the replacement of that directive by the entire contents of the source file identified by the specified sequence between the " delimiters. The named source file is searched for in an implementation-defined manner. If this search is not supported, or if the search fails, the directive is reprocessed as if it read

  #include <h-char-sequence> new-line
  

  with the identical contained sequence (including > characters, if any) from the original directive.

• A preprocessing directive of the form

  #include pp-tokens new-line
  

  (that does not match one of the two previous forms) is permitted. The preprocessing tokens after include in the directive are processed just as in normal text. (Each identifier currently defined as a macro name is replaced by its replacement list of preprocessing tokens.) The directive resulting after all replacements shall match one of the two previous forms. The method by which a sequence of preprocessing tokens between a < and a > preprocessing token pair or a pair of " characters is combined into a single header name preprocessing token is implementation-defined.

Definitions:

• h-char: any member of the source character set except the new-line character and >

• q-char: any member of the source character set except the new-line character and "

Обратите внимание, что в стандарте не говорится о какой-либо связи между способами, определяемыми реализацией. Первая форма выполняет поиск одним способом, определяемым реализацией, а другая (возможно, другим) способом, определяемым реализацией. Стандарт также указывает, что должны присутствовать определенные включаемые файлы (например, <stdio.h>).

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

В C++ включить файл можно двумя способами:

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

И второй тип - это #include «filename», который сообщает препроцессору, что сначала нужно искать файл в текущем каталоге, а затем искать его в заранее определенных местах, которые пользователь установил.

В документации GCC говорится следующее о разнице между ними:

Both user and system header files are included using the preprocessing directive ‘#include’. It has two variants:

#include <file>

This variant is used for system header files. It searches for a file named file in a standard list of system directories. You can prepend directories to this list with the -I option (see Invocation).

#include "file"

This variant is used for header files of your own program. It searches for a file named file first in the directory containing the current file, then in the quote directories and then the same directories used for <file>. You can prepend directories to the list of quote directories with the -iquote option. The argument of ‘#include’, whether delimited with quote marks or angle brackets, behaves like a string constant in that comments are not recognized, and macro names are not expanded. Thus, #include <x/*y> specifies inclusion of a system header file named x/*y.

However, if backslashes occur within file, they are considered ordinary text characters, not escape characters. None of the character escape sequences appropriate to string constants in C are processed. Thus,#include "x\n\y"specifies a filename containing three backslashes. (Some systems interpret ‘\’ as a pathname separator. All of these also interpret ‘/’ the same way. It is most portable to use only ‘/’.)

It is an error if there is anything (other than comments) on the line after the file name.

#include <abc.h>

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

#include "xyz.h"

скажет компилятору включить определяемые пользователем файлы заголовков. Таким образом, компилятор проверит эти файлы заголовков в текущей папке или в папках, определенных -I.

#include <file.h> сообщает компилятору, что нужно искать заголовок в его «включаемом» каталоге, например для MinGW компилятор будет искать file.h в C: \ MinGW \ include \ или там, где установлен ваш компилятор.

#include "file" сообщает компилятору, что нужно искать file в текущем каталоге (т.е. в каталоге, в котором находится исходный файл).

Вы можете использовать флаг -I для GCC, чтобы сообщить ему, что, когда он встречает включение с угловыми скобками, он также должен искать заголовки в каталоге после -I. GCC будет обрабатывать каталог после флага, как если бы это был каталог includes.

Например, если у вас есть файл с именем myheader.h в вашем собственном каталоге, вы можете сказать #include <myheader.h>, если вы вызвали GCC с флагом -I . (что означает, что он должен искать включения в текущем каталоге).

Без флага -I вам придется использовать #include "myheader.h" для включения файла или переместить myheader.h в каталог include вашего компилятора.

the " < filename > " searches in standard C library locations

whereas "filename" searches in the current directory as well.

В идеале вы должны использовать <...>для стандартных библиотек C и "..." для библиотек, которые вы пишете и присутствуют в текущем каталоге.

Когда вы используете #include , препроцессор ищет файл в каталоге файлов заголовков C \ C++ (stdio.h \ cstdio, string, vector и т. д.). Но, когда вы используете #include «filename»: сначала препроцессор ищет файл в текущем каталоге, а если его здесь нет - он ищет его в каталоге файлов заголовков C \ C++.

Форма 1 - #include

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

Форма 2 - #include "xxx"

Это проверяет наличие заголовочного файла в текущем каталоге, из которого вызывается директива.

Точный список каталогов поиска зависит от целевой системы, от того, как настроен GCC и где он установлен. Вы можете найти список каталогов поиска вашего компилятора GCC, запустив его с параметром -v.

Вы можете добавить дополнительные каталоги к пути поиска, используя - Iреж, который заставляет искать каталог после текущего каталога (для формы цитаты директивы) и перед стандартными системными каталогами.

По сути, форма «xxx» - это не что иное, как поиск в текущем каталоге; если не найдено, откатить форму

Есть два способа написать инструкцию #include:

#include"filename"
#include<filename>

Значение каждой формы

#include"mylib.h"

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

#include<mylib.h>

Эта команда будет искать файл mylib.h только в указанном списке каталогов.

Путь поиска include - это не что иное, как список каталогов, в которых будет производиться поиск включаемого файла. Различные компиляторы C позволяют задавать путь поиска по-разному.

Чтобы увидеть порядок поиска в вашей системе с помощью gcc, в зависимости от текущей конфигурации, вы можете выполнить следующую команду. Вы можете найти более подробную информацию об этой команде здесь

cpp -v /dev/null -o /dev/null

Apple LLVM version 10.0.0 (clang-1000.10.44.2)
Target: x86_64-apple-darwin18.0.0
Thread model: posix InstalledDir: Library/Developer/CommandLineTools/usr/bin
"/Library/Developer/CommandLineTools/usr/bin/clang" -cc1 -triple x86_64-apple-macosx10.14.0 -Wdeprecated-objc-isa-usage -Werror=deprecated-objc-isa-usage -E -disable-free -disable-llvm-verifier -discard-value-names -main-file-name null -mrelocation-model pic -pic-level 2 -mthread-model posix -mdisable-fp-elim -fno-strict-return -masm-verbose -munwind-tables -target-cpu penryn -dwarf-column-info -debugger-tuning=lldb -target-linker-version 409.12 -v -resource-dir /Library/Developer/CommandLineTools/usr/lib/clang/10.0.0 -isysroot /Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk -I/usr/local/include -fdebug-compilation-dir /Users/hogstrom -ferror-limit 19 -fmessage-length 80 -stack-protector 1 -fblocks -fencode-extended-block-signature -fobjc-runtime=macosx-10.14.0 -fmax-type-align=16 -fdiagnostics-show-option -fcolor-diagnostics -traditional-cpp -o - -x c /dev/null
clang -cc1 version 10.0.0 (clang-1000.10.44.2) default target x86_64-apple-darwin18.0.0 ignoring nonexistent directory "/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/usr/local/include" ignoring nonexistent directory "/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/Library/Frameworks"
#include "..." search starts here:
#include <...> search starts here:
/usr/local/include
/Library/Developer/CommandLineTools/usr/lib/clang/10.0.0/include
/Library/Developer/CommandLineTools/usr/include
/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/usr/include
/Library/Developer/CommandLineTools/SDKs/MacOSX10.14.sdk/System/Library/Frameworks (framework directory)
End of search list.

#include <filename>

• Препроцессор выполняет поиск в зависимости от реализации. Он сообщает компилятору искать каталог, в котором хранятся файлы системных заголовков.
• Этот метод обычно используется для поиска стандартных файлов заголовков.

#include "filename"

• Это указывает компилятору искать файлы заголовков, в которых выполняется программа. Если это не удалось, он ведет себя как #include <filename> и выполняет поиск в этом заголовочном файле там, где хранятся системные заголовочные файлы.
• Этот метод обычно используется для идентификации определяемых пользователем файлов заголовков (файлов заголовков, которые создаются пользователем). Не используйте это, если вы хотите вызвать стандартную библиотеку, потому что она требует больше времени на компиляцию, чем #include <filename>.

#include <file> 

Включает файл, в котором используется каталог включения по умолчанию.

#include "file" 

Включает файл в текущий каталог, в котором он был скомпилирован.

В общем, разница в том, где препроцессор ищет файл заголовка:

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

1. #include используется для включения файла заголовка системной библиотеки в программу, означает, что препроцессор C / C++ будет искать имя файла, в котором хранятся файлы библиотеки C или хранятся файлы предопределенных системных заголовков.
2. #include "filename" is used to include user defined header file in the program, means the C/C++ preprocessor will search for the filename in the current directory the program is in and then follows the search path used for the #include

Проверьте документы gcc gcc включают файлы

"" будет искать ./ в первую очередь. затем найдите путь включения по умолчанию. вы можете использовать такую ​​команду, чтобы распечатать путь включения по умолчанию:

 gcc -v -o a a.c

вот несколько примеров, чтобы прояснить ситуацию: код a.c работает

// a.c
#include "stdio.h"
int main() {
        int a = 3;
        printf("a = %d\n", a);
        return 0;

}

код b.c тоже работает

\ b.c
#include <stdio.h>
int main() {
        int a = 3;
        printf("a = %d\n", a);
        return 0;

}

но когда я создаю новый файл с именем stdio.h в текущем каталоге

// stdio.h
inline int foo()
{
        return 10;
}

a.c вызовет ошибку компиляции, но b.c все еще работает

и "" могут использоваться вместе с одним и тем же именем файла. поскольку приоритет пути поиска другой. так что d.c тоже работает

// d.c
#include <stdio.h>
#include "stdio.h"
int main()
{
        int a = 0;

        a = foo();

        printf("a=%d\n", a);

        return 0;
}

~