名前
nl - 行番号を付けてファイルを出力する
書式
nl [-p] [-b STYLE] [-d CD] [-f STYLE] [-h STYLE] [-i NUMBER] [-l NUMBER] [-n FORMAT] [-s STRING] [-v NUMBER] [-w NUMBER] [--body-numbering=STYLE] [--footer-numbering=STYLE] [--header-numbering=STYLE] [--join-blank-lines=NUMBER] [--page-increment=NUMBER] [--no-renumber] [--number-format=FORMAT] [--number-separator=FORMAT] [--number-width=NUMBER] [--section-delimiter=CD] [--starting-line-number=NUMBER] [FILE...]
nl [--help] [--version]
説明
nl は指定された FILE それぞれを標準出力に書く。 その際行番号を一部または全部の行に追加する。 FILE が一つも与えられないと標準入力から読み込む。また FILE が - だった場合には、そのファイルには標準入力が用いられる。
nl は入力を論理ページ (logical page) に分解する。デフォルトでは、 行番号は各々の論理ページの先頭で 1 にリセットされる。 nl は入力されたファイルすべてをまとめてひとつの文書とみなす。 したがってファイルの切れ目でも行番号や論理ページはリセットされない。
オプション
-b STYLE, --body-numbering=STYLE | |||||||||||
各論理ページの本文セクションにおける行の番号付けの方式を選択する。
行に番号がつかないと、カレントの行番号は増加しないが、
行番号の区切る文字は行の前に置かれる。形式は以下の通り。
| |||||||||||
-d CD, --section-delimiter=CD | |||||||||||
セクション区切りとなる二文字を CD にする (デフォルトは e:)。 C だけが与えられた場合は、2 文字めは : のままとなる。 (\ 等のメタキャラクタを指定する場合には、シェルの展開から守るために クォートするか、バックスラッシュを一つ余計に付けるのを忘れないように。) | |||||||||||
-f STYLE, --footer-numbering=STYLE | |||||||||||
--body-numbering を見よ。 | |||||||||||
-h STYLE, --header-numbering=STYLE | |||||||||||
--body-numbering を見よ。 | |||||||||||
-i NUMBER, --page-increment=NUMBER | |||||||||||
行番号の増分を NUMBER にする (デフォルトは 1)。 | |||||||||||
-l NUMBER, --join-blank-lines=NUMBER | |||||||||||
NUMBER だけ連続した空行を、 番号付けの際に 1 論理行とみなし、最後の空行にのみ番号を付ける (NUMBER のデフォルトは 1)。 空行の連続が number 以下の場合には、番号付けを行わない。 空行とはスペースやタブも含め、文字を全く含まない行のこと。 | |||||||||||
-n FORMAT, --number-format=FORMAT | |||||||||||
行番号の出力フォーマットを指定する (デフォルトは rn):
| |||||||||||
-p, --no-renumber | |||||||||||
論理ページの先頭で行番号をリセットしない。 | |||||||||||
-s STRING, --number-separator=FORMAT | |||||||||||
出力ファイルの行番号とテキスト行の間の区切りに STRING を用いる (デフォルトは <TAB>)。 | |||||||||||
-v NUMBER, --starting-line-number=NUMBER | |||||||||||
それぞれの論理ページの行番号を NUMBER から始める (デフォルトは 1)。 | |||||||||||
-w NUMBER, --number-width=NUMBER | |||||||||||
行番号表示に用いる文字数を NUMBER にする (デフォルトは 6)。 | |||||||||||
--help | 標準出力に使用方法のメッセージを出力して正常終了する。 | ||||||||||
--version | |||||||||||
標準出力にバージョン情報を出力して正常終了する。 | |||||||||||
論理ページ
論理ページは三つのセクションからなる。 ヘッダ (header)、本文 (body)、フッタ (footer) である。 セクションは空であってもよい。 また、それぞれを別な形式で番号付けすることもできる。
入力ファイル中に以下のデリミタ文字列 (delimiter string) だけからなる行があると、論理ページのセクションの始まりとみなされる。
\:\:\: | ヘッダの先頭 |
\:\: | 本文の先頭 |
\: | フッタの先頭 |
注意
プログラムのバグについては bug-textutils@gnu.org に報告してください。 man ページは Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com> が作成しました。