ctagsposix - 云端在线

程序：

您的姓名

ctags — 创建一个标签文件 (发展, 福特兰)

概要

标签 [-a] [-f 标签文件] 路径名...

ctags -x 路径名...

商品描述

这个 标签 应在支持软件开发的系统上提供实用程序
Utilities 选项，以及 C-Language Development Utilities 选项和
FORTRAN 开发实用程序选项。 在其他系统上，它是可选的。

这个 标签 实用程序应写一个 标签文件 或来自 C 语言或 FORTRAN 的对象索引
指定的源文件 路径名 操作数。 这 标签文件 应列出定位器
源文件中特定于语言的对象。 定位器由名称、路径名、
以及可用于搜索对象的搜索模式或行号
定义。 应识别的对象在扩展描述中指定
部分。

配置

这个 标签 实用程序应符合 POSIX.1-2008 的基本定义卷， 部分
12.2, 公用事业 句法 指南.

应支持以下选项：

-a 附加到 标签文件.

-f 标签文件
将目标定位器列表写入 标签文件 而不是命名的默认文件
标签 在当前目录中。

-x 生成对象名称、行号和文件名的列表，其中每个
定义，以及该行的文本，并将其写入标准
输出。 一种 标签文件 不得创建时 -x 已指定。

操作数

下列 路径名 支持操作数：

文件.c 基本名称以 .c 后缀应视为C语言
源代码。 此类文件不是有效输入 c99 生产不明
结果。

文件.h 基本名称以 .h 后缀应视为C语言
源代码。 此类文件不是有效输入 c99 生产不明
结果。

文件.f 基本名称以 .f 后缀应被视为 FORTRAN-
语言源代码。 此类文件不是有效输入 77年 生产
未指定的结果。

其他文件的处理是实现定义的。

标准输入

请参阅输入文件部分。

INPUT FILES

输入文件应为包含源代码的文本文件，其语言为
操作数文件名后缀。

环境 变数

以下环境变量会影响执行 标签:

朗 为未设置或未设置的国际化变量提供默认值
空值。 （参见 POSIX.1-2008 的基本定义卷， 部分 8.2,
国际化 变量 为国际化优先
用于确定语言环境类别值的变量。）

LC_ALL 如果设置为非空字符串值，则覆盖所有其他字符串的值
国际化变量。

LC_COLLATE
确定输出的排序顺序 -x 选项。 POSIX
语言环境决定了其中的顺序 标签文件 被写。

LC_CTYPE 确定用于解释文本数据字节序列的语言环境
作为字符（例如，单字节而不是多字节字符
参数和输入文件）。 在处理 C 语言源代码时，如果
语言环境与 ISO C 标准描述的 C 语言环境不兼容，
结果未指定。

LC_消息
确定应该用于影响格式和内容的语言环境
写入标准错误的诊断消息。

路径 确定用于处理的消息目录的位置 LC_消息.

异步 精彩活动

默认。

标准输出

生成的对象名称信息列表 -x 选项应写入标准
输出格式如下：

"%s %d %s %s", <对象名>,电话号码>,文件名>,文本>

在哪里文本> 是行的文本电话号码> 文件文件名>.

斯特德

标准错误应仅用于诊断消息。

OUTPUT FILES

当。。。的时候 -x 未指定选项，输出文件的格式应为：

"%s\t%s\t/%s/\n", <识别码>,文件名>,模式>

在哪里模式> 是一种搜索模式，编辑器可以使用它来查找定义
实例识别码> 在文件名> （哪里 定义 例 由
扩展说明中列出的声明）。

一个可选的('^') 可以作为前缀添加到模式>，以及一个可选的
可以附加到模式> 表示该模式锚定到
一行文本的开始（结束）。 任何或者中的字符模式>
前面应有一个特点。 锚定, ,
和逃跑字符不应被视为搜索模式的一部分。
搜索模式中的所有其他字符都应视为文字字符。

另一种格式是：

"%s\t%s\t?%s?\n", <识别码>,文件名>,模式>

与第一种格式相同，除了中的字符模式> 应
没有在逃避之前字符，和中的字符
<模式> 应以人物。

第二种替代格式是：

"%s\t%s\t%d\n", <识别码>,文件名>,线诺>

在哪里线诺> 是一个十进制行号，编辑器可以使用它来查找
<识别码> 在文件名>.

两种替代格式均不得由 标签 当它按照描述使用时
POSIX.1-2008，但处理标签文件的标准实用程序应该能够处理
这些格式以及第一种格式。

在这些格式中的任何一种中，文件应按标识符排序，基于排序规则
POSIX 语言环境中的序列。

EXTENDED 商品描述

如果操作数标识 C 语言源，则 标签 实用程序应尝试产生一个
以下每个对象的输出行：

* 函数定义

* 类型定义

* 带参数的宏

它还可以为以下任何对象生成输出：

* 函数原型

* 结构

* 工会

* 全局变量定义

* 枚举类型

* 没有参数的宏

* ＃定义 声明

* ＃线 声明

任何 #如果 和 #ifdef 语句不应产生任何输出。 标签 主 被特殊对待
在 C 程序中。 形成的标签应通过前缀创建 M 到文件名，
与尾随 .c, 和前导路径名组件（如果有）已删除。

在不支持 C-Language Development Utilities 选项的系统上， 标签 产生
C 语言源代码文件的未指定结果。 它应该写入标准错误 a
标识此条件并导致生成非零退出状态的消息。

如果操作数标识 FORTRAN 源，则 标签 效用应产生输出线
对于每个函数定义。 它还可以为以下任何对象生成输出：

* 子程序定义

* 常见的语句

* 参数语句

* DATA 和 BLOCK DATA 语句

* 声明编号

在不支持 FORTRAN Development Utilities 选项的系统上， 标签 产生
FORTRAN 源代码文件的未指定结果。 它应该写入标准错误 a
标识此条件并导致生成非零退出状态的消息。

它是实现定义的其他对象（包括重复的标识符）产生什么
输出。

退出 状态

应返回以下退出值：

0 成功完成。

>0 发生错误。

后果 OF 错误

默认。

这个 以下 部分 旨在 内容丰富。

申请须知 用法

输出与 -x 是一个简单的索引，可以作为脱机写出
可读的函数索引。 如果输入文件为 标签 （如 .c 文件）未创建
使用与有效时相同的语言环境 标签 -x 运行，结果可能不一样
预期。

C 语言处理的描述说“尝试”是因为 C 语言可以
非常困惑，尤其是通过使用 ＃定义s，这个实用程序是
如果运行真正的 C 预处理器来识别它们，则没有用。 输出来自 标签 也许
对于各种构造被愚弄和不正确。

示例

无。

基本原理

选项列表比历史提供的选项列表显着减少
实现。 这 -F 选项被省略为多余，因为它是默认值。 这 -B
选项被省略，因为它的用处非常有限。 这 -t 选项被省略，因为
承认 类型定义C 源文件现在需要 s。 这 -u 选项被省略
因为更新功能被判断为不仅效率低下，而且很少需要。

早期的提案包括 -w 选项来抑制警告诊断。 由于类型
无法描述此类诊断，该选项因无用而被省略。

文本为 LC_CTYPE 关于与 C 语言环境的兼容性承认 ISO C
标准对用于处理 C 源代码的语言环境提出了要求。 这很容易被
通过实现扩展的方式称为“C语言环境”的超集，或
支持不同代码集的系统的一些替代语言环境。 没有声明是
为 FORTRAN 制定，因为 ANSI X3.9-1978 标准 (FORTRAN 77) 没有（还）定义
类似的语言环境概念。 然而，本卷 POSIX.1-2008 的一般规则是，任何
语言环境不匹配的时间（为一个语言环境准备文件并在
另一个），结果令人怀疑。

标签文件的整理顺序不受 LC_COLLATE 因为它是
通常不会被人类读者使用，而只会被诸如 vi 定位标签
源文件中。 使用 POSIX 语言环境消除了一些问题
协调地区之间的 标签 文件创建者和 vi 文件阅读器。

从历史上看，标签文件仅由 ex 和 vi. 但是，格式
已发布标签文件以鼓励其他程序以新方式使用标签。 这
format 允许模式或行号找到标识符，因为
历史的 vi 要么承认。 这 标签 实用程序不会使用 line 生成格式
数字，因为它在添加或删除的任何源文件更改之后没有用
线。 记录的搜索模式与历史实践相匹配。 应该注意的是
字面引导或尾随搜索模式中的字符
仅当锚定到行首或行尾时才会正确运行
额外的或者特点。

历史实现也理解语言 Pascal 和
有时 LISP，他们理解 C 源代码输出 法 和 雅克。 该 标签
不需要实用程序来适应这些语言，尽管实现者是
鼓励这样做。

未指定以下历史选项，如 研磨 不包括在这个
POSIX.1-2008 卷：

-v 如果 -v 给出了标志，一个索引所期望的形式 研磨 生产于
标准输出。 此列表包含函数名称、文件名和页面
编号（假设 64 行页面）。 由于输出按字典顺序排序
顺序，可能需要通过运行输出 分类 -f. 样品用途：

标签 -v 档 | 分类 -f > 指数 研磨 -x 指数

标签的特殊处理 主 利用 标签 在目录中实用
不止一个程序。

未来 如何前往

无。

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