C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- 源文件包含
- 条件包含
- 文本替换宏
- 错误指令
- 实现定义的行为控制
- 文件名和行信息
- 注释
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
实现定义的行为控制
实现定义的行为受 #pragma
指令控制。
语法
#pragma 语用形参
|
(1) | ||||||||
_Pragma ( 字符串字面量 )
|
(2) | (C++11 起) | |||||||
1) 具有由实现定义的行为方式
2) 从 字符串字面量 移除
L
前缀(若存在),外层引号,及前导/尾随空白符,将每个 \"
替换为 "
、将每个 \\
替换为 \
,然后将结果记号化(如翻译阶段 3 中一样),再如同将结果作为 (1) 中的输入来予以使用。解释
pragma 指令控制编译器的特定于实现的行为,如禁用编译器警告或更改对齐要求。忽略任何不能识别的语用。
非标准语用
ISO C++ 语言标准并不要求编译器支持任何语用。不过,多种实现都支持几种非标准的语用:
#pragma STDC
ISO C 语言标准要求 C 编译器支持下列三种语用,一些 C++ 编译器供应商在它们的 C++ 前端中以不同的程度支持它们:
#pragma STDC FENV_ACCESS 实参
|
(1) | ||||||||
#pragma STDC FP_CONTRACT 实参
|
(2) | ||||||||
#pragma STDC CX_LIMITED_RANGE 实参
|
(3) | ||||||||
其中 实参 是 ON
、OFF
和 DEFAULT
之一。
2) 允许浮点表达式的缩略(contracting)行为,即一种优化,表达式严格按书面求值时可被观察到的一些舍入错误和浮点异常将被忽略。例如,允许 (x*y) + z 使用单条融合乘加 CPU 指令实现。默认值由实现定义,通常是
ON
。3) 告知编译器,复数的乘法、除法和绝对值可以使用简化的数学公式 (x+iy)×(u+iv) = (xu-yv)+i(yu+xv) (x+iy)/(u+iv) = [(xu+yv)+i(yu-xv)]/(u2
+v2
),和 |x+iy| = √x2
+y2
,而不考虑中间溢出的可能性。换言之,程序员保证传递给这些函数的值范围是受限的。默认值为
+v2
),和 |x+iy| = √x2
+y2
,而不考虑中间溢出的可能性。换言之,程序员保证传递给这些函数的值范围是受限的。默认值为
OFF
。如果上述三种语用的任一条并非出现于所有外部声明之外,或所有显式声明或复合语句中的所有语句之前,则程序的行为未定义。
注意:不支持这些 pragma 的编译器可能提供等价的编译时选项,例如 gcc 的 -fcx-limited-range
和 -ffp-contract
。
#pragma once
#pragma once 是受到绝大多数现代编译器支持的非标准语用。当某个头文件中包含它时,指示编译器只对其分析一次,即使它在同一源文件中(直接或间接)被包含了多次也是如此。
阻止同一头文件的多次包含的标准方式是使用包含防护:
#ifndef LIBRARY_FILENAME_H #define LIBRARY_FILENAME_H // 头文件的内容 #endif /* LIBRARY_FILENAME_H */
从而在任何翻译单元中,该头文件除首次以外被包含时都被排除出编译。所有现代编译器都记录头文件使用了包含防护的事实,只要该防护仍有定义,再遇到该头文件时就不再分析它。(例子见 gcc )
使用 #pragma once 时,同一个头文件可以变为
#pragma once // 头文件的内容
不同于头文件防护,这条语用使得错误地在多个文件中使用相同的宏名变得不可能。另一方面,因为带 #pragma once 的文件是基于其文件系统层次的身份所排除的,所以若头文件在项目中有多个位置,则这不能防止包含它两次。
#pragma pack
本节未完成 |
参阅
外部链接
- Visual Studio 2015 中的 C++ pragma
- GCC 4.9.2 所接受的 Pragma
- IBM AIX XL C 13.1 中的单独 pragma 描述和标准 pragma
- Sun Studio 11 C++ 用户指南中的 Appendix B. Pragmas
- Intel C++ compiler pragmas 版本 17.0
- HP aCC A.06.25 的发行注记(包括 pragma)