Man page - column(1)

Packages contains this manual

Package:  bsdextrautils
apt-get install bsdextrautils

Manuals in package:
• colcrt(1)
• column(1)
• ul(1)
• hd(1)
• col(1)
• colrm(1)
• look(1)
• hexdump(1)
Documentations in package:
• bsdextrautils

Available languages:

en ja uk ro

Manual

COLUMN

名 前
書 式
読 者 へ の ご 注 意
説 明
オ プ シ ョ ン
環 境 変 数
用 例
バ グ
関 連 項 目
履 歴
入 手 方 法

---

名 前

column - 入 力 を 複 数 列 に 整 形 す る

書 式

column [options] [ file ...]

読 者 へ の ご 注 意

こ れ は 、 util-linux 版 の column コ マ ン ド の マ ニ ュ ア ル で あ る 。 column コ マ ン ド の 実 装 に は 、 い く つ か の 系 統 が あ る 。 御 使 用 の デ ィ ス ト リ ビ ュ ー シ ョ ン が util-linux 版 以 外 の column コ マ ン ド を 採 用 し て い る 場 合 は 、 動 作 や オ プ シ ョ ン が こ こ で 説 明 し て い る も の と か な り 違 っ て い る か も し れ な い 。 そ う い う と き は 、 英 語 版 し か な い か も し れ な い が 、 お 手 元 の column コ マ ン ド に 付 属 す る マ ニ ュ ア ル に 当 た っ て み て い た だ き た い 。

説 明

column ユ ー テ ィ リ テ ィ は 入 力 を 複 数 列 形 式 に 整 形 す る 。 こ の ユ ー テ ィ リ テ ィ は 3 つ の モ ー ド を サ ポ ー ト し て い る 。
行 (row) よ り 先 に 列 (column) を 埋 め る

こ れ が デ フ ォ ル ト の モ ー ド で あ る (後 方 互 換 の た め そ う な っ て い る )。

列 よ り 先 に 行 を 埋 め る

こ の モ ー ド は オ プ シ ョ ン -x, --fillrows で 有 効 に な る 。

表 形 式

入 力 に 含 ま れ る 列 の 数 を 判 断 し て 、 表 を 作 成 す る 。 こ の モ ー ド は オ プ シ ョ ン -t, --table で 有 効 に な る 。 列 の フ ォ ー マ ッ ト は --table-* オ プ シ ョ ン で 調 整 で き る 。 ど の モ ー ド を 使 う か 迷 っ て い る な ら 、 こ の モ ー ド を 使 う と よ い 。

入 力 は file か ら 読 み 込 む 。 file が 指 定 さ れ て い な け れ ば 、 標 準 入 力 か ら 読 み 込 む 。 空 行 は 無 視 し 、 無 効 な マ ル チ バ イ ト シ ー ケ ン ス は す べ て \x<hex> 方 式 で エ ン コ ー ド す る 。

オ プ シ ョ ン

--table-* オ プ シ ョ ン に 対 す る 引 き 数 columns は 、 列 の 名 前 ま た は 列 の 番 号 を 、 コ ン マ で 区 切 っ た リ ス ト で あ る 。 列 の 名 前 は 、 --table-columns オ プ シ ョ ン で 指 定 し た も の で あ り 、 列 の 番 号 は 、 入 力 に お け る 列 の 順 番 だ 。 列 の 名 前 と 番 号 を 混 ぜ て 使 う こ と も で き る 。
-J, --json

表 の 出 力 に JSON フ ォ ー マ ッ ト を 使 用 す る 。 --table-columns オ プ シ ョ ン が 必 須 で あ る 。 --table-name オ プ シ ョ ン も 指 定 し た 方 が よ い 。

-c, --output-width width

文 字 (character) 数 で 指 定 さ れ た 幅 に 出 力 を 整 形 す る 。 こ の オ プ シ ョ ン の 元 の 名 前 は --columns だ っ た が 、 そ の 名 前 は バ ー ジ ョ ン 2.30 以 来 、 非 推 奨 に な っ て い る 。 デ フ ォ ル ト で は 、 width よ り 長 い 入 力 が あ っ て も 、 短 縮 さ れ な い こ と に 注 意 し て い た だ き た い (訳 注 : 表 を width の 幅 に き ち ん と 収 め る に は 、 -t と と も に -T か -W を 指 定 す る 必 要 が あ る )。

-d, --table-noheadings

ヘ ッ ダ を 表 示 し な い 。 こ の オ プ シ ョ ン を 使 用 す れ ば 、 コ マ ン ド ラ イ ン で は 列 の 名 前 に 便 宜 的 な 名 前 を 使 っ て お い て 、 表 を 表 示 す る 際 に は ヘ ッ ダ を 見 せ な い よ う に す る こ と が で き る 。

-o, --output-separator string

表 出 力 に お け る 列 間 の 区 切 り を 指 定 す る (デ フ ォ ル ト は ス ペ ー ス 2 個 )。

-s, --separator separators

表 形 式 を 選 択 し た と き に 、 入 力 項 目 の 区 切 り に 使 え る 文 字 (複 数 可 ) を 指 定 す る (デ フ ォ ル ト は ホ ワ イ ト ス ペ ー ス )。

[ 訳 注 ]

デ フ ォ ル ト で は 、 ホ ワ イ ト ス ペ ー ス (ス ペ ー ス や タ ブ ) の 連 続 は 1 つ の デ リ ミ タ と し て 解 釈 さ れ る 。 そ れ に 対 し 、 -s オ プ シ ョ ン で 入 力 の デ リ ミ タ に 空 白 と タ ブ を 指 定 し た と き は 、 空 白 や タ ブ 1 個 1 個 が 独 立 し た デ リ ミ タ と し て 扱 わ れ る 。 別 の 例 を 挙 げ る な ら 、 -s " $% " と 指 定 す る と 、 $% と い う 連 続 が デ リ ミ タ に な る の で は な く 、 $ と % の 両 方 が 、 そ れ ぞ れ デ リ ミ タ と し て 扱 わ れ る 。

-t, --table

入 力 に 含 ま れ る 列 の 数 を 判 断 し て 、 表 を 作 成 す る 。 デ フ ォ ル ト で は 、 列 は ス ペ ー ス で 区 切 ら れ る が 、 --output-separator オ プ シ ョ ン を 使 っ て 指 定 し た 文 字 で 区 切 る こ と も で き る 。 表 形 式 の 出 力 は 、 表 示 を 見 栄 え の よ い も の に す る の に 便 利 で あ る 。

-N, --table-columns names

列 の 名 前 を 、 コ ン マ で 区 切 っ た 名 前 の リ ス ト で 指 定 す る 。 そ う し た 名 前 は 、 表 の ヘ ッ ダ に 使 わ れ た り 、 オ プ シ ョ ン 引 き 数 中 で 特 定 の 列 を 指 定 す る の に 使 わ れ た り す る 。

-R, --table-right columns

指 定 し た 列 で テ キ ス ト を 右 詰 め に す る 。

-T, --table-truncate columns

必 要 な ら テ キ ス ト を 短 縮 し て も よ い 列 を 指 定 す る 。 こ の オ プ シ ョ ン を 指 定 し な い と 、 表 の 中 の 非 常 に 長 い 項 目 は 、 何 行 か に 渡 っ て 表 示 さ れ る か も し れ な い 。

-E, --table-noextreme columns

列 の 幅 を 計 算 す る 際 、 並 外 れ て 長 い (平 均 よ り 長 い ) セ ル が あ っ た 場 合 に 、 そ う し た セ ル を 無 視 で き る 列 を 指 定 す る 。 こ の オ プ シ ョ ン は 、 列 の 幅 の 計 算 や 表 の 整 形 に は 影 響 す る が 、 表 示 さ れ る テ キ ス ト に は 影 響 を 与 え な い 。

こ の オ プ シ ョ ン を 指 定 し な い デ フ ォ ル ト で は 、 こ の オ プ シ ョ ン の 動 作 は 、 表 示 さ れ る 最 後 の (訳 注 : す な わ ち 、 一 番 右 の ) 列 に 適 用 さ れ る 。

-e, --table-header-repeat

ペ ー ジ ご と に ヘ ッ ダ 行 を 表 示 す る 。

-W, --table-wrap columns

長 い テ キ ス ト の 表 示 に 必 要 な 場 合 に 、 複 数 行 の セ ル を 使 う こ と の で き る 列 を 指 定 す る 。

-H, --table-hide columns

指 定 し た 列 を 表 示 し な い 。 名 前 の 付 い て い な い 列 を す べ て 隠 す に は 、 列 の 名 前 や 番 号 の 代 わ り に ’-’ と い う 特 別 な 引 き 数 を 使 え ば よ い (--table-columns を 参 照 )。

-O, --table-order columns

出 力 に お け る 列 の 順 番 を 指 定 す る 。

-n, --table-name name

JSON 出 力 に 使 う 表 の 名 前 を 指 定 す る 。 デ フ ォ ル ト は "table" で あ る 。

-L, --table-empty-lines

入 力 中 に 空 行 が あ る た び に 、 表 に も 空 行 を 挿 入 す る 。 デ フ ォ ル ト で は 、 空 行 は す べ て 無 視 す る こ と に な っ て い る 。

-r, --tree column

出 力 を ツ リ ー 状 に す る 列 を 指 定 す る 。 な お 、 親 子 関 係 に お け る 循 環 な ど の 変 則 的 な 指 定 は 、 警 告 を 出 さ ず に 無 視 さ れ る 。

-i, --tree-id column

親 子 関 係 を 生 成 す る た め の 「 行 ID」 が 存 在 す る 列 を 指 定 す る 。

-p, --tree-parent column

親 子 関 係 を 生 成 す る た め の 「 親 ID」 が 存 在 す る 列 を 指 定 す る 。

-x, --fillrows

列 を 埋 め る 前 に 行 を 埋 め る 。

-V , --version

バ ー ジ ョ ン 情 報 を 表 示 し て 、 終 了 す る 。

-h, --help

ヘ ル プ を 表 示 し て 、 終 了 す る 。

環 境 変 数

他 に 情 報 が 得 ら れ な い 場 合 は 、 画 面 の 幅 を 決 定 す る た め に 環 境 変 数 COLUMNS が 使 わ れ る 。

用 例

fstab を ヘ ッ ダ 行 を 付 け て 表 示 し 、 数 値 は 右 詰 め に す る :
sed ’s/#.*//’ /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE,OPTIONS,PASS,FREQ --table-right PASS,FREQ

名 前 の 付 い て い な い 列 は 隠 し て 、 fstab を 表 示 す る :
sed ’s/#.*//’ /etc/fstab | column --table --table-columns SOURCE,TARGET,TYPE --table-hide -

ツ リ ー 表 示 の 例 :
echo -e ’1 0 A\n2 1 AA\n3 1 AB\n4 2 AAA\n5 2 AAB’ | column --tree-id 1 --tree-parent 2 --tree 3
1 0 A
2 1 |-AA
4 2 | |-AAA
5 2 | ‘-AAB
3 1 ‘-AB

バ グ

バ ー ジ ョ ン 2.23 で -s オ プ シ ョ ン の 動 作 を 欲 張 り で な く し た (訳 注 : 値 が 指 定 さ れ て い な い 場 合 に 、 後 続 の 値 を 利 用 し な い よ う に し た )。 例 を 示 そ う 。

printf "a:b:c\n1::3\n" | column -t -s ’:’

従 来 の 出 力 :
a b c
1 3

新 し い 出 力 (util-linux 2.23 以 降 ):
a b c
1 3

こ の ツ ー ル の 従 来 の バ ー ジ ョ ン で は 、 「 デ フ ォ ル ト で は 、 列 よ り も 先 に 行 を 埋 め る 。 -x オ プ シ ョ ン は こ の 動 作 を 反 対 に す る 」 と 述 べ て い た 。 し か し 、 こ の 説 明 は 、 実 際 の 動 作 を 正 し く 反 映 し て い な か っ た の で 、 そ の 後 訂 正 さ れ て い る (「 説 明 」 セ ク シ ョ ン を ご 覧 い た だ き た い )。 column の 他 の 実 装 で は 、 以 前 の 説 明 を 今 で も 使 っ て い る か も し れ な い が 、 い ず れ に せ よ 、 動 作 は ど れ も 同 じ は ず で あ る 。

関 連 項 目

colrm (1), ls (1), paste (1), sort (1)

履 歴

column コ マ ン ド は 4.3BSD-Reno で 登 場 し た 。

入 手 方 法

こ の column コ マ ン ド は 、 util-linux パ ッ ケ ー ジ の 一 部 で あ り 、 https://www.kernel.org/pub/linux/utils/util-linux/ か ら 入 手 で き る 。

---