gccxml - 云端在线

程序：

您的姓名

gccxml - 创建 C++ 声明的 XML 表示。

概要

gccxml [选项] -fxml=

商品描述

GCC-XML 解析编译器在构建时看到的 C++ 源文件。 一个简单的-
转储类、函数和命名空间声明的解析 XML 表示
到指定的文件。 完整的 C 预处理将文件转换为 C++ 翻译单元
如编译器所见。 这意味着 GCC-XML 应该使用相同的标准
库和其他头文件作为编译器。 GCC-XML 可以配置为模拟任何
几个流行的编译器。

配置

以下选项可用于运行 GCC-XML：

- 版权
打印 GCC-XML 版权并退出。

-调试
打印额外的调试信息。 此选项会导致 GCC-XML 打印
用于执行修补的 GCC C++ 的可执行文件名称和命令行参数
解析器。 这在尝试模拟不受支持的编译器时很有用。

-fxml=
指定 XML 输出文件。 这个选项直接传递给打过补丁的 GCC
C++ 解析器。 它启用 XML 转储并指定输出文件名。

-fxml-开始= [，...]
指定开始声明的列表。 此选项直接传递给
修补 GCC C++ 解析器。 仅当还指定了 -fxml= 时才有意义。 这个
指定以逗号分隔的命名起始声明列表。 GCC-XML 将转储
只有可访问的翻译单元中声明的子集
通过来自指定起始位置之一的一系列源引用
声明。

--gccxml-编译器
将 GCCXML_COMPILER 设置为“xxx”。

--gccxml-cxxflags
将 GCCXML_CXXFLAGS 设置为“xxx”。

--gccxml-可执行文件
将 GCCXML_EXECUTABLE 设置为“xxx”。

--gccxml-cpp
将 GCCXML_CPP 设置为“xxx”。

--gccxml-配置
将 GCCXML_CONFIG 设置为“xxx”。

--gccxml-根
将 GCCXML_ROOT 设置为“xxx”。

--gccxml-gcc-选项
从文件“xxx”中读取 GCC 选项。 此选项指定要从中读取的文件
传递给修补过的 GCC C++ 解析器的选项。 这对于指定一个
包含目录的长列表。 文件中的每一行都成为一个选项。 空的
以“#”开头的行和行将被忽略。

- 帮帮我 打印完整的帮助并退出。 完整帮助显示了由
UNIX 手册页。 它是为在非 UNIX 平台上使用而提供的，但也适用于
如果没有安装手册页很方便。

--帮助-html
以 HTML 格式打印完整的帮助。 GCC-XML 作者使用此选项来帮助
制作网页。

- 男人 打印 UNIX 手册页并退出。 这个选项被 GCC-XML 作者用来生成
UNIX 手册页。

- 打印
打印配置设置并退出。 GCC-XML 有许多配置选项
帮助它模拟另一个编译器。 使用这个选项会导致 GCC-XML
将自身配置为好像要解析 C++ 源代码，但停止并打印
找到的配置。 这对于检查配置很有用。

--预处理
预处理输入和退出。 GCC-XML 模拟另一个处理器
编译器。 使用此选项将导致 GCC-XML 将自身配置为
将解析 C++ 源代码，但在预处理后停止。 这对
调试与模拟其他编译器相关的问题。

-E --preprocess 的别名。

- 版
显示程序名称/版本横幅并退出。

其他标志，例如 -I 和 -D，将传递给修补后的 GCC C++ 解析器可执行文件。

设置

GCC-XML 旨在在读取 C++ 源代码时模拟编译器的解析器。 一些
需要配置设置来确定如何模拟特定的编译器
用户的选择。 以下设置可用于配置 GCC-XML：

GCCXML_COMPILER
要模拟的 C++ 编译器。 GCC-XML 将尝试自动确定
如何模拟此设置指定的编译器。 指定编译器
通过其可执行名称（例如“g++”）。 对于 Visual Studio，编译器是
由“msvc6”、“msvc7”、“msvc71”或“msvc8”指定（如果给出“cl”，GCC-XML
试图猜测使用哪个 VS）。

GCCXML_CXXFLAGS
要模拟的 C++ 编译器的标志。 大多数编译器的行为可以
通过在命令行上指定标志来调整。 当 GCC-XML 试图
自动确定如何模拟编译器，这些标志被考虑在内
考虑。

GCCXML_配置
通用设置的配置文件。 当非默认设置经常出现时
使用，编写包含它们的单个文件很方便。 当这样的文件是
指定，它将被读取以配置任何未知的设置。 每个
文件的一行包含一个 KEY="VALUE" 形式的赋值（例如，
GCCXML_COMPILER="g++")。

GCCXML_EXECUTABLE
指定修补的 GCC C++ 解析器可执行文件。 所见的 GCC-XML 程序
用户实际上是一个前端，它确定配置所需的标志
修补 GCC C++ 解析器以模拟另一个编译器。 此设置指定
一旦确定了标志，真正的可执行文件就会运行。 用户应该很少
需要更改此值的默认值。

GCCXML_CPP
指定 GCC C 预处理器可执行文件。 用户看到的 GCC-XML 程序
实际上是一个前端，它确定配置修补程序所需的标志
GCC C++ 解析器来模拟另一个编译器。 此设置指定
预处理器使用已确定的调试标志运行
目的。 用户应该很少需要更改此值的默认值。

GCCXML_ROOT
GCC-XML 支持库目录。 由于 GCC-XML 只是一个 C++ 解析器，它
不能完全复制它试图模拟的每个编译器的功能。
一些编译器提供了 GCC-XML 不能直接使用的代码的标准头文件
处理。 为了解决这个限制，为每个提供了一个支持库
编译器。 它由一组头文件组成，用于代替
编译器的系统头文件。 这些文件包含轻微的调整，然后包括
对应的真实标题。 包含这些支持的目录树的根
库头文件由此设置指定。 用户应该很少需要更改
这个值来自它的默认值。

GCCXML_FLAGS
用于模拟其他编译器的标志。 当 GCC-XML 运行修补过的 GCC C++
解析器，这些标志被传递给程序来告诉它如何模拟一个
特定的编译器。 此设置通常会从其他设置中自动检测到
设置，但可以由高级用户直接指定。 大多数用户应该
不要尝试从自动配置更改此值。

GCCXML_USER_FLAGS
用于编译器模拟的附加用户标志。 当 GCC-XML 运行修补的 GCC 时
C++ 解析器，除了由 GCCXML_FLAGS 指定的标志外，还传递这些标志。
这允许高级用户在仍然使用
GCCXML_FLAGS 的自动配置。 用户应该很少需要改变这个
其默认值。

可通过多种方式配置这些设置。 它们列在此处
优先顺序（从高到低）：

命令行 附加选项
可以通过相应的选项指定设置。 当一个设置的
提供了相应的命令行选项，它优先于任何其他命令行选项使用
配置手段。 如果在命令行上设置了 GCCXML_CONFIG，则设置为
从文件中读取的优先级略低于其他命令行
选项​​。

环境 变量
设置是按环境中的名称配置的。 每个设置未知
从具有其名称的环境变量中读取。 如果 GCCXML_CONFIG 由
环境，设置从文件中读取，优先级略低
与其他环境变量相比。

配置 档
执行对 GCCXML_CONFIG 的搜索。 如果 GCCXML_CONFIG 尚未设置，则
尝试自动查找配置文件。 首先，如果文件
$HOME/.gccxml/config 存在，它将被使用。 二、如果正在执行GCC-XML
从其构建目录中，将使用该目录中的配置文件。 最后，
如果在安装的支持库目录中找到配置文件，它将
使用。 找到后，将从配置文件中读取任何未知设置。

揣测
猜测是根据其他设置进行的。 一旦设置了 GCCXML_COMPILER，它就是
用于自动查找 GCCXML_FLAGS 的设置。 如果未设置，则
检查“CXX”环境变量作为查找编译器设置的最后手段
并确定 GCCXML_FLAGS。

大多数用户不必调整这些设置的默认值。 有一个默认
安装后在支持库目录中提供了 GCCXML_CONFIG 文件。 它
配置 GCC-XML 以模拟用于构建它的编译器。

编译器

GCC-XML 可以模拟以下任何一种编译器：

GCC 版本 4.2、4.1、4.0、3.4、3.3、3.2、2.95.x

视觉 C + +中
版本 8、7.1、7.0 和 6 (sp5)

博兰德， 英特尔， SGI公司
以前支持但不再测试

提供了以下额外的 C 预处理器定义：

-D__GCCXML__=MMmmpp
MM、mm 和 pp 是 GCC-XML 的主要、次要和补丁版本。 这个
预处理器符号在预处理时将 ​​GCC-XML 标识为源代码。
它可用于启用特定于 GCC-XML 的信息。

-D__GCCXML_GNUC__=M
定义为内部 GCC 解析器主要版本。

-D__GCCXML_GNUC_MINOR__=m
定义为内部 GCC 解析器次要版本。

-D__GCCXML_GNUC_PATCHLEVEL__=p
定义为内部 GCC 解析器补丁级别。

高级用户可以通过手动配置 GCCXML_FLAGS 来模拟其他编译器
环境。 联系邮件列表寻求帮助。

元信息

GCC-XML 向合法的 C/C++ 属性集添加了一个新属性。 属性是
用于将元信息附加到 C/C++ 源代码，然后将出现在 XML 中
输出。 声明属性的语法如下：

__attribute((gccxml( , , ...）））
这里是一个带引号的字符串。 必须至少有一个论据
'gccxml' 属性，但参数总数没有上限。
每个参数都被验证为一个字符串 - 如果找到一个非字符串参数，则
属性被忽略。

然后，带有属性标记的代码元素的 XML 输出将包含
执行以下操作：

属性=“ ... gccxml( , , ...） ...
'attributes' XML 属性包含应用于代码元素的所有属性。
打印属性的每个参数时不带引号，因此如果
参数包含 ',' 字符，该参数将显示为多个
参数。

'gccxml' 属性可以应用于任何声明，包括结构、类、
字段、参数、方法、函数、变量和类型定义。 唯一的例外是
GCC 对“__attribute”语言元素的处理目前已被破坏
具有内联主体的枚举和构造函数。 可以使用“gccxml”属性
给定声明的任意次数。

作为如何使用此属性将元信息附加到 C++ 的示例
声明，请考虑以下宏：

＃定义 _出去_ __attribute((gccxml("out")))
这里 '_out_' 被定义为 gccxml 属性，其中第一个参数
是字符串“out”。 建议将第一个参数用作唯一的
开始应用元信息类型的字符串名称。

现在方法声明可以写成如下：

无效 获取整数（_out_ 输入& 一世）;
这将导致 XML 输出包含“_out_”的元信息
属性，形式为“gccxml(out)”。

使用“gccxml”属性可以将元信息直接包含在 C++ 中
源代码，无需自定义解析器来提取元信息。 这
提供“gccxml”属性只是为了方便 - 不能保证将来
GCC 的版本将以无错误的方式接受“__attribute”语言元素。

版权

GCC-XML - GCC 的 XML 输出

版权所有 2002-2012 Kitware, Inc., Insight Consortium

以源代码和二进制形式重新分发和使用，无论是否修改，都是
在满足以下条件的情况下允许：

* 源代码的重新分发必须保留上述版权声明，此列表
条件和以下免责声明。

* 以二进制形式重新分发必须复制上述版权声明，此列表
文件中的条件和以下免责声明和/或其他
随分发提供的材料。

* Kitware, Inc.、Insight Software Consortium 的名称或
他们的贡献者的一部分可用于认可或推广由此衍生的产品
未经事先书面许可的软件。

本软件由版权所有者和贡献者“按原样”提供，以及任何
明示或暗示的保证，包括但不限于对
不符合特定目的的适销性和适用性。 在任何情况下都不得
版权持有人或贡献者应对任何直接、间接、附带、特殊、
惩戒性或后果性损害（包括但不限于采购
替代品或服务； 使用、数据或利润的损失； 或业务中断）
无论是由何种原因引起的，基于任何责任理论，无论是在合同中、严格责任中，还是
因使用本软件而以任何方式引起的侵权行为（包括疏忽或其他）
软件，即使已告知可能发生此类损坏。

-------------------------------------------------- ----------

gccxml_cc1plus - 针对翻译单元的 XML 转储修补的 GCC 解析器

版权所有 2002-2012 Kitware, Inc., Insight Consortium

该程序是免费软件； 您可以根据以下条款重新分发和/或修改它
由自由软件基金会发布的 GNU 通用公共许可证； 任何一个
许可的第2版，或（由您选择）任何更高版本。

分发此程序是希望它有用，但不作任何保证；
甚至没有对适销性或针对特定目的的适用性的暗示保证。
有关更多详细信息，请参阅 GNU 通用公共许可证。

您应该已经收到一份 GNU 通用公共许可证以及该程序；
如果没有，请写信给
自由软件基金会有限公司
富兰克林街 51 号，五楼
马萨诸塞州波士顿 02110-1301 美国

邮寄 清单

有关使用 gccxml 的帮助和讨论，可在以下位置提供邮件列表
[电子邮件保护]. 请首先阅读完整的文档 http://www.gccxml.org
在将问题发布到列表之前。

使用 onworks.net 服务在线使用 gccxml