Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/preprocessor/include"

From cppreference.com
m (Shorten template names. Use {{lc}} where appropriate.)
Line 5: Line 5:
 
===Syntax===
 
===Syntax===
  
{{sdcl list begin}}
+
{{sdsc begin}}
{{sdcl list item | num=1 | {{ttb|#include <}}{{sparam|filename}}{{ttb|>}} }}
+
{{sdsc | num=1 | {{ttb|#include <}}{{spar|filename}}{{ttb|>}} }}
{{sdcl list item | num=2 | {{ttb|#include "}}{{sparam|filename}}{{ttb|"}} }}
+
{{sdsc | num=2 | {{ttb|#include "}}{{spar|filename}}{{ttb|"}} }}
{{sdcl list end}}
+
{{sdsc end}}
  
 
===Explanation===
 
===Explanation===
  
Includes source file, identified by {{sparam|filename}} into the current source file at the line immediately after the directive.
+
Includes source file, identified by {{spar|filename}} into the current source file at the line immediately after the directive.
  
 
The first version of the directive searches only standard include directories. The standard C++ library, as well as standard C library, is implicitly included in standard include directories. The standard include directories can be controlled by the user through compiler options.  
 
The first version of the directive searches only standard include directories. The standard C++ library, as well as standard C library, is implicitly included in standard include directories. The standard include directories can be controlled by the user through compiler options.  

Revision as of 19:51, 31 May 2013

 
 
C++ language
General topics
Flow control
Conditional execution statements
if
Iteration statements (loops)
for
range-for (C++11)
Jump statements
Functions
Function declaration
Lambda function expression
inline specifier
Dynamic exception specifications (until C++17*)
noexcept specifier (C++11)
Exceptions
Namespaces
Types
Specifiers
const/volatile
decltype (C++11)
auto (C++11)
constexpr (C++11)
consteval (C++20)
constinit (C++20)
Storage duration specifiers
Initialization
Expressions
Alternative representations
Literals
Boolean - Integer - Floating-point
Character - String - nullptr (C++11)
User-defined (C++11)
Utilities
Attributes (C++11)
Types
typedef declaration
Type alias declaration (C++11)
Casts
Memory allocation
Classes
Class-specific function properties
explicit (C++11)
static

Special member functions
Templates
Miscellaneous
 
 

Includes other source file into current source file at the line immediately after the directive .

Syntax

#include <filename> (1)
#include "filename" (2)

Explanation

Includes source file, identified by filename into the current source file at the line immediately after the directive.

The first version of the directive searches only standard include directories. The standard C++ library, as well as standard C library, is implicitly included in standard include directories. The standard include directories can be controlled by the user through compiler options.

The second version firstly searches the directory where the current file resides and, only if the file is not found, searches the standard include directories.

In the case the file is not found, program is ill-formed.