PR(1)

名称
pr - テキストファイルをページ単位で整形する

書式
pr [+page] [- column] [-adFmrt] [ [-e] [char] [gap]] [-h header] [ [-i] [char] [gap]] [-l lines] [-o offset] [ [-s] [char]] [ [-n] [char] [width]] [-w width] [-] [file ...]

解説
pr ユーティリティは、テキストファイルをページ単位に整形し、 出力します。複数の入力ファイルが指定された場合はそれぞれについて読み、 整形し、標準出力に書きます。デフォルトでは、入力ファイルは 1 ページ 66 行に 分割され、それぞれに以下のものがつきます。

• ページ番号、日付、時間、ファイルのパス名のついた 5 行のヘッダ

• 空行からなる 5 行のトレイラ

もし標準出力が端末の場合、診断メッセージは pr の処理が完了するまで抑制されます。

複数列での出力が指定された場合、各テキスト列は同一の幅で出力されます。 デフォルトでは各テキスト列は少なくとも 1 つの <空白> で分割されます。入力行がテキストの幅からはみ出るときは切り捨てられます。 単一列の出力の場合は切り捨てられません。

オプション

以下のオプションの記述において、 column, lines, offset, page, width は 10 進の正の整数で、gap は 10 進の負でない整数です。

+page
    入力を整形したあと、ページ番号 page から出力をはじめます。

- column
    column 列で出力します (デフォルトは 1)。テキストは入力ファイルから読んだ順に、 各列に垂直に書かれます。このオプションを指定すると、 -e と -i がついたとみなされます。また、このオプションは、 -m と一緒に使用してはいけません。 -t と一緒に使用すると、出力の表示行数が最小になります。

-d  ダブルスペースで出力します。入力に <改行> を見つけると、続けて余分な <改行> を 1 つ出力します。

-e [char][gap]
    入力中の各 <tab> を、式 n*gap+1 で表される位置のうちの現在位置の次に大きい位置まで展開します。 ここで、 n は 0 より大きい整数です。 もし、 gap が 0 もしくは省略された場合、デフォルトとして 8 が指定されたことになります。 入力中の全ての <tab> キャラクタは、適切な個数の <space> に展開されます。 もし char が数字でない文字の場合、それがその入力のタブキャラクタとして使われます。

-F  改ページに、デフォルトである <改行> キャラクタの代りに <フォームフィード> キャラクタを使います。

-h header
    ヘッダ行内のファイル名を、文字列 header に置き換えます。

-i [char][gap]
    出力において、2 個以上の空白が、式 gap+1 や 2*gap+1 などの列まで連続していた場合に、 この複数の <space> を <tab> で置き換えます。 gap が 0 もしくは省略された場合、デフォルトとしてタブ位置が 8 列ごとと指定された ことになります。入力中の全ての <tab> キャラクタは、適切な個数の <space> に展開されます。 もし char が数字でない文字の場合、それがその出力のタブキャラクタとして使われます。

-l lines
    ページ長をデフォルトの 66 行のかわりに lines 行にします。 lines がヘッダとトレイラの行数の和より大きくないときには、 -t オプションをつけたときのようにヘッダとトレイラを抑制します。

-m  複数のファイルの中身をマージします。引数で指定した各ファイルから読み込まれた 1 つの行は、同一の幅で並べて書かれます。テキストの列の数は、 引数で指定したファイルのうちのオープンに成功したものの数になります。 マージするファイルの最大値は、ページ幅とプロセスがオープンできるファイルの 最大数に依存します。このオプションを指定すると、 -e と -i がついたとみなされます。

-n [char][width]
    width 桁の行番号をつけます。 width のデフォルト値は 5 です。この番号は各行の最初に width の幅でつきます。もし char (数字でない文字) が与えられた場合は、 行番号とテキストの間をその文字で区切ります。 char のデフォルトは <tab> です。 width より長い行番号は切り詰められます。

-o offset
    出力の各行の先頭に offset 個の空白がつきます。 -o オプションが指定されていなければ、デフォルトは 0 になります。 この空白は出力の幅に加わります。

-r  ファイルのオープンに失敗したときのエラーメッセージを出力しません。

-s char
    テキストの各列間を、スペースのかわりに単一文字の char で分割します (char のデフォルトは <タブ> です)。

-t  通常ならば各ページに付加される 5 行の識別ヘッダと 5 行のトレイラのどちらも 表示しなくなります。各ファイルの最終行が出力されたあと、ページの最後までの 空白を作らずに動作をやめてしまいます。

-w width
    複数列出力のために、1 行の幅を width にします。 -w も -s も指定されない場合は、デフォルト幅は 72 です。 -w が指定されずに -s が指定された場合は、デフォルト幅は 512 になります。

file
    プリントするファイルのパス名です。もし file が指定されなかった場合、もしくは file が ‘-’ だった場合は、標準入力が利用されます。

-s オプションでは、オプション文字 (`s') と その引数 (char ) との間を空けることは許されていません。また、 -e, -i, -n は両方の引数が必要で、オプション文字と分割できません。

エラー
pr ユーティリティは、成功時には 0 を、エラーが起きたときは 1 を返します。

関連項目
cat(1), more(1)

規格
pr ユーティリティは p1003.2 準拠です。