Ctags

複数のタグファイルフォーマットがある。その一部を以下で説明する。説明中の<\x##>は16進数でバイトを表している。

オリジナルのctagsフォーマットとExuberant Ctagsフォーマットはファイルフォーマットが似ている^[2]。

エディター「vi」系用のフォーマット。タグファイルは通常は tags という名前である。

タグファイルは行単位でフォーマットされている。

{タグ名}<Tab>{タグファイル}<Tab>{タグアドレス}

各フィールドは以下のように定義される。

タグファイルの検索を高速にするためタグファイルは {タグ名} のフィールドでソートされる。

Vim用のフォーマット。後方互換性のため出力フォーマットとしてオリジナルのctagsフォーマットと拡張フォーマットを選択できる。

各フィールドは以下のように定義される。

{タグ名}<Tab>{タグファイル}<Tab>{タグアドレス}[;"<Tab>{タグフィールド}...]

{タグアドレス}までのフィールドは上記のctagsと同じである。

拡張フィールド

• ;" – セミコロンとダブルコーテーション。vi のコメントと同じ表記により{タグアドレス}を終了させる。
• {タグフィールド}

拡張フォーマットでは ex コマンドの後ろに ex コメントを続ける形でオリジナルの vi の実装との下位互換性を維持したままで{タグアドレス}フィールドを拡張できる。これらの拡張フィールドはタブで区切られたキー・バリューのペアである。詳細はctagsのマニュアルを参照のこと。

Emacs用の etags のフォーマット。タグファイルは通常は TAGS という名前である。

etags のファイルは複数のセクションで構成されている。入力ソースファイル毎に1つのセクションを持つ。各セクションはプレーンなテキストファイルであるが、特別な制御用にアスキー外の文字を使用する。以下の説明においてこれらの文字は<>で囲まれた16進数のコードで表す。

セクションは2行のヘッダで始まる。1行目は<\x0c>一文字のみを含む。2行目は次のようになる。

{ソースファイル<},{タグ定義データのバイト数}

ヘッダの後にはタグの定義が続く。各定義毎に1行。フォーマットは以下の通り。

{タグ定義テキスト}<\x7f>{タグ名}<\x01>{行番号},{バイトオフセット}

タグ定義よりタグの名称が導き出せる場合は{タグ名} とその後ろの \x01 が無視される。

ソースコードとして次のような1行だけのtest.cを読み込ませた場合、

#define CCC(x)

TAGS ファイルは次のようになる。

<\x0c>
test.c,21
#define CCC(<\x7f>CCC<\x01>1,0

1. ↑ “Vim documentation: version6”. 2022年7月27日閲覧。
2. ↑ “Proposal for extended Vi tags file format”. 2022年7月27日閲覧。

• Exuberant ctagsのホームページ
• VMS用のCtags
• Emacsのvtags.elモジュールのソースコード