<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
#include [C++ Reference]
</title>
<meta name="generator" content="DokuWiki Release 2009-12-25c "Lemming"" />
<meta name="robots" content="index,follow" />
<meta name="date" content="2008-10-14T15:42:05-0700" />
<meta name="keywords" content="preprocessor,include" />
<link rel="search" type="application/opensearchdescription+xml" href="/wiki/lib/exe/opensearch.php" title="C++ Reference" />
<link rel="start" href="/wiki/" />
<link rel="contents" href="/wiki/preprocessor/include?do=index" title="Index" />
<link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/wiki/feed.php" />
<link rel="alternate" type="application/rss+xml" title="Current Namespace" href="/wiki/feed.php?mode=list&ns=preprocessor" />
<link rel="edit" title="Edit this page" href="/wiki/preprocessor/include?do=edit" />
<link rel="alternate" type="text/html" title="Plain HTML" href="/wiki/_export/xhtml/preprocessor/include" />
<link rel="alternate" type="text/plain" title="Wiki Markup" href="/wiki/_export/raw/preprocessor/include" />
<link rel="canonical" href="http://www.cppreference.com/wiki/preprocessor/include" />
<link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/exe/css.php?s=all&t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="screen" type="text/css" href="/wiki/lib/exe/css.php?t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="print" type="text/css" href="/wiki/lib/exe/css.php?s=print&t=custom1&tseed=1272971091" />
<script type="text/javascript" charset="utf-8" ><!--//--><![CDATA[//><!--
var NS='preprocessor';var JSINFO = {"id":"preprocessor:include","namespace":"preprocessor"};
//--><!]]></script>
<script type="text/javascript" charset="utf-8" src="/wiki/lib/exe/js.php?tseed=1272971091" ></script>
<link rel="shortcut icon" href="/wiki/lib/tpl/custom1/images/favicon.png" />
</head>
<body>
<div class="dokuwiki">
<div class="stylehead">
<div class="breadcrumbs">
<span class="bchead">You are here: </span><a href="../start.html" title="start">C++ Reference</a> » <a href="../preprocessor/start.html" title="preprocessor:start">Preprocessor Commands</a> » <a href="../preprocessor/include.html" title="preprocessor:include">#include</a> </div>
</div>
<div class="page">
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-2828341-1";
urchinTracker();
</script>
<!-- wikipage start -->
<h2><a name="include" id="include">#include</a></h2>
<div class="level2">
<p>
Syntax:
</p>
<pre class="c code c++" style="font-family:monospace;"> <span class="co2">#include <filename></span>
<span class="co2">#include "filename"</span></pre>
<p>
This command slurps in a file and inserts it at the current location. The main
difference between the syntax of the two items is that if filename is enclosed
in angled brackets, then the compiler searches for it somehow. If it is
enclosed in quotes, then the compiler doesn't search very hard for the file.
</p>
<p>
While the behavior of these two searches is up to the compiler, usually the
angled brackets means to search through the standard library directories, while
the quotes indicate a search in the current directory. The spiffy new C++
#include commands don't need to map directly to filenames, at least not for the
standard libraries. That's why you can get away with
</p>
<pre class="c code c++" style="font-family:monospace;"> <span class="co2">#include <iostream></span></pre>
<p>
…and not have the compiler choke on you.
</p>
</div>
<!-- wikipage stop -->
</div>
<div class="clearer"> </div>
<div class="stylefoot">
<div class="meta">
<div class="user">
</div>
<!--
<div class="doc">
preprocessor/include.txt · Last modified: 10/14/2008 15:42 (external edit) </div>
-->
</div>
</div></div></body>
</html>