📄 once-only-headers.html
字号:
<html lang="en">
<head>
<title>The C Preprocessor</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="The C Preprocessor">
<meta name="generator" content="makeinfo 4.3">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home">
<!--
Copyright © 1987, 1989, 1991, 1992, 1993, 1994, 1995, 1996,
1997, 1998, 1999, 2000, 2001, 2002, 2003
Free Software Foundation, Inc.
<p>Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation. A copy of
the license is included in the
section entitled "GNU Free Documentation License".
<p>This manual contains no Invariant Sections. The Front-Cover Texts are
(a) (see below), and the Back-Cover Texts are (b) (see below).
<p>(a) The FSF's Front-Cover Text is:
<p>A GNU Manual
<p>(b) The FSF's Back-Cover Text is:
<p>You have freedom to copy and modify this GNU Manual, like GNU
software. Copies published by the Free Software Foundation raise
funds for GNU development.
-->
</head>
<body>
<div class="node">
<p>
Node:<a name="Once-Only%20Headers">Once-Only Headers</a>,
Next:<a rel="next" accesskey="n" href="Computed-Includes.html#Computed%20Includes">Computed Includes</a>,
Previous:<a rel="previous" accesskey="p" href="Search-Path.html#Search%20Path">Search Path</a>,
Up:<a rel="up" accesskey="u" href="Header-Files.html#Header%20Files">Header Files</a>
<hr><br>
</div>
<h3 class="section">Once-Only Headers</h3>
<p>If a header file happens to be included twice, the compiler will process
its contents twice. This is very likely to cause an error, e.g. when the
compiler sees the same structure definition twice. Even if it does not,
it will certainly waste time.
<p>The standard way to prevent this is to enclose the entire real contents
of the file in a conditional, like this:
<pre class="example"> /* File foo. */
#ifndef FILE_FOO_SEEN
#define FILE_FOO_SEEN
<var>the entire file</var>
#endif /* !FILE_FOO_SEEN */
</pre>
<p>This construct is commonly known as a <dfn>wrapper #ifndef</dfn>.
When the header is included again, the conditional will be false,
because <code>FILE_FOO_SEEN</code> is defined. The preprocessor will skip
over the entire contents of the file, and the compiler will not see it
twice.
<p>CPP optimizes even further. It remembers when a header file has a
wrapper <code>#ifndef</code>. If a subsequent <code>#include</code> specifies that
header, and the macro in the <code>#ifndef</code> is still defined, it does
not bother to rescan the file at all.
<p>You can put comments outside the wrapper. They will not interfere with
this optimization.
<p>The macro <code>FILE_FOO_SEEN</code> is called the <dfn>controlling macro</dfn> or
<dfn>guard macro</dfn>. In a user header file, the macro name should not
begin with <code>_</code>. In a system header file, it should begin with
<code>__</code> to avoid conflicts with user programs. In any kind of header
file, the macro name should contain the name of the file and some
additional text, to avoid conflicts with other header files.
</body></html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -