include

计算机专业术语

include是一个计算机专业术语，一指C/C++中包含头文件命令，用于将指定头文件嵌入源文件中。二指include 指令，在JSP中包含一个静态的文件，同时解析这个文件中的JSP语句。三指PHP语句。

命令

引言

做C/C++编程的对#include指令都不会陌生，绝大多数人也都知道如何使用，但我相信仍有人对此是一知半解:

C++:

表示包含C/C++标准输入输出头文件。包含指令不仅仅限于.h头文件，可以包含任何编译器能识别的C/C++代码文件，包括.c、.hpp、.cpp、.hxx、.cxx等，甚至.txt、.abc等等都可以。

预处理器发现 #include 指令后，就会寻找指令后面<>中的文件名，并把这个文件的内容包含到当前文件中。被包含文件中的文本将替换源代码文件中的#include 指令，就像你把被包含文件中的全部内容键入到源文件中的这个位置一样。

名词解释

preprocess

预处理：为方便编译器处理而设置的一种机制，包括一些常用预处理指令和语句，我们统称为预处理系统。

如#include #define #if...#else...#endif #pragma等

这些指令的实现是由编译器来决定的（implementation specified）

提到预处理指令，顺便说一下头文件防止重复包含的2种方法

a.保护宏

#ifndef _ABCDE_H

#define _ABCDE_H

代码部分

#endif

在被包含过一次之后，宏_ABCDE_H已经有了，下次再碰到就会略过从#define _ABCDE_H开始到#endif之间的代码

还有一种特定编译器支持的指令：

b.#pragma once

能保证该文件（物理上的）只被编译一次，也能起到防止重复包含的作用

但这2种方式是有区别的：

a.Macro guard可移植性好，绝大多数编译器都支持，而且万一不小心拷贝了几分相同的代码也不会出问题，但你得确保这个宏名不会与其他的宏冲突，否则等编译器报出一大堆错误的时候你可能会觉得莫名其妙；

b.#pragma once指令简单，它能保证该文件（物理上的）只被编译一次，不用去费劲的想不同的宏名，但如果有几份该文件的拷贝，显然起不到作用。

declaration

声明：指将一个名称引入当前编译单元，或者重新声明一个前面已经声明过的名称，声明指定了如何解释一个名称和该名称具有的属性；

例如：

definition

定义：除了以下情况，声明就是定义

a.声明函数但不包括函数体;

b.声明包含extern链接限定符，例如：extern int a;

c.声明既没有初始化语法，也没有函数体;

d.类声明中声明静态数据成员；

e.类名字声明；

f.typedef声明；

g.using声明或者using指令；

以上情况适用于C具有的特征，C++则完全适用，一般来说定义要为其对象分配或预留存储空间，而声明则不用。

translation unit

编译单元：一个源文件，.c .cpp等和它所包含的文件一起，在经过预处理之后形成一个源码文件，标准称之为translation unit（编译单元）包括一系列的声明和定义；一个program（程序）由一个或多个编译单元组成。编译器将各个编译单元编译为目标代码（.obj），通过连接器（linker）将这些编译后的编译单元（即目标代码）连接成完整的指令序列（可执行文件、静态库、动态库等）。

one definition rule

一次定义规则：是指定义在所有进入连接的编译单元中只能有一次。

观点、例子

A：头文件只放声明

example_a.h

B.被包含的文件可以使用任意扩展名：

只要是用符合标准的代码编写的文本文件，就可以使用#include来进行包含，包括.cpp .c等常见的源文件扩展名；

example_b_1.b

example_b_2.b

example_b_22.cpp:

上面的例子中，example_b_21.cpp仅被包含在example_b_22.cpp中，不再被其他的文件包含，而且不加入工程中；

C.标准头文件的使用

最新的C++标准库中的一切内容都被放在名字空间std中（名字空间中的内容对外是不可见的），但是带来了一个新问题，无数现有的C++代码都依赖于使用了多年的伪标准库中的功能，如声明在；等头文件中的功能，使用std包装标准库导致现有代码的不可用，为了兼容这种情况，标准委员会为包装了std的那部分标准库创建了新的头文件，新的头文件的文件名与旧的一样，只是没有.h这个后缀，如；就变成了；。对于C头文件，采用同样的方法，但还在每个头文件名前加了字符c，如；就变成了；，；变成了；。最好使用新的文件头，使用新的文件头的C++程序，需要使用using namespace std或者using namespace std::指定的类名，等方法来使需要的类对于我们的代码可视。

用法

文件目录中查找。

总结

既然是经常使用的东西，我们就应该明白它的原理，减少编程时的困惑，提高编程的效率。

JSP命令

指令

Include 指令

在JSP中包含一个静态的文件，同时解析这个文件中的JSP语句.

JSP 语法

例子

include.jsp:

An Include Test

The current date and time are

date.jsp:

java.util

<%= (new java.util.Date()).toLocaleString() %>

Displays in the page:

The current date and time are

Aug 30,1999 2:38:40

描述

<%@include %>；指命将会在JSP编译时插入一个包含文本或代码的文件，当你使用<%@ include %>；指命时，这个包含的过程就当是静态的。静态的包含就是指这个被包含的文件将会被插入到JSP文件中去，这个包含的文件可以是JSP文件，HTML文件，文本文件。如果包含的是JSP文件，这个包含的JSP的文件中代码将会被执行。

如果你仅仅只是用include 来包含一个静态文件。那么这个包含的文件所执行的结果将会插入到JSP文件中放<% @ include %>；的地方。一旦包含文件被执行，那么主JSP文件的过程将会被恢复，继续执行下一行.

这个被包含文件可以是html文件，jsp文件，文本文件，或者只是一段Java代码，但是你得注意在这个包含文件中不能使用,,,；标记，因为这将会影响在原JSP文件中同样的标记，这样做有时会导致错误.

有一些<%@ include %>；指命的行为是以特殊的JSP编译条件为基础，比如：

这个被包含的文件必须对所有客户都有开放且必须f有效，或者它有安全限制

如果这个包含文件被改变，包含此文件的JSP文件将被重新编译

属性：

这个包含文件的路径名一般来说是指相对路径，不需要什么端口，协议，和域名，如下：

php语句

include()语句包含并运行指定文件。

以下文档也适用于require()。这两种结构除了在如何处理失败之外完全一样。include()产生一个警告而require()则导致一个致命错误。换句话说，如果想在遇到丢失文件时停止处理页面就用require()。include()就不是这样，脚本会继续运行。同时也要确认设置了合适的 include_path。注意在 php 4.3.5 之前，包含文件中的语法错误不会导致程序停止，但从此版本之后会。

寻找包含文件的顺序先是在当前工作目录的相对的 include_path 下寻找，然后是当前运行脚本

当一个文件被包含时，其中所包含的代码继承了 include 所在行的变量范围。从该处开始，调用文件在该行处可用的任何变量在被调用的文件中也都可用。不过所有在包含文件中定义的函数和类都具有全局作用域。

例子 16-5. 基本的include()例子

vars.phptest.php 如果 include 出现于调用文件中的一个函数里，则被调用的文件中所包含的所有代码将表现得如同它们是在该函数内部定义的一样。所以它将遵循该函数的变量范围。

例子 16-6. 函数中的包含

例子 16-7. 通过 HTTP 进行的include()

相关信息参见使用远程文件，fopen()和file()。

因为include()和require()是特殊的语言结构，在条件语句中使用必须将其放在语句组中（花括号中）。

例子 16-8. include() 与条件语句组

处理返回值：可以在被包括的文件中使用return()语句来终止该文件中程序的执行并返回调用它的脚本。同样也可以从被包含的文件中返回值。可以像普通函数一样获得 include 调用的返回值。不过这在包含远程文件时却不行，除非远程文件的输出具有合法的 php 开始和结束标记（如同任何本地文件一样）。可以在标记内定义所需的变量，该变量在文件被包含的位置之后就可用了。

因为include()是一个特殊的语言结构，其参数不需要括号。在比较其返回值时要注意。

例子 16-9. 比较 include 的返回值

注:在 php 3 中，除非是在函数中调用否则被包含的文件中不能出现 return。在此情况下return()作用于该函数而不是整个文件。

例子 16-10.include()和return()语句

return.phpnoreturn.phptestreturns.php 的值为 1 是因为 include 成功运行了。注意以上例子中的区别。第一个在被包含的文件中用了return()而另一个没有。如果文件不能被包含，则返回FALSE并发出一个 E_WARNING 警告。

如果在包含文件中定义有函数，这些函数可以独立于是否在return()之前还是之后在主文件中使用。如果文件被包含两次，php 5 发出致命错误因为函数已经被定义，但是 php 在return()之后不会抱怨函数已定义。推荐使用include_once()而不是检查文件是否已包含并在包含文件中有条件返回。

另一个将 php 文件“包含”到一个变量中的方法是用输出控制函数结合include()来捕获其输出，例如：

例子 16-11. 使用输出缓冲来将 php 文件包含入一个字符串

要在脚本中自动包含文件，参见 php.ini 中的 auto_prepend_file 和 auto_append_file 配置选项。

注:由于这是一个语言结构而非函数，因此它无法被变量函数调用。

全国各地天气预报查询

上海市

市辖区

云南省

临沧市

云南省

丽江市

云南省