名前 | 形式 | 機能説明 | オプション | オペランド | 使用例 | 環境 | 終了ステータス | 属性 | 関連項目
pr ユーティリティは、印刷とページ設定用のフィルタです。 複数のファイルを指定すると、その各々を読み込み、 書式化して、標準出力に書き出します。 デフォルトでは、入力データを 66 行からなるページに分割します。各ページには以下のものが含まれます。
5 行からなるヘッダー。ページ番号、日付、時刻、ファイルのパス名を含む
5 行の空行からなるトレーラ
標準出力が端末に割り当てられているとき、診断メッセージは pr ユーティリティの処理が完了してから出力されます。
複数カラム出力を示すオプションを指定すると、 テキストカラムは等しい幅で出力されます。 この幅に収まらない入力行は切り捨てられます。 デフォルトでは、出力テキストカラムは 1 つ以上の空白文字で区切られます。
以下のオプションを指定できます。 なおオプションの説明において、 column 、 lines 、 offset 、 page 、 width は正の 10 進整数を表し、 gap は負でない 10 進整数を表します。オプション引数の中には、省略可能なものがあります。 また直前のオプション文字と分離して独立した引数として 指定できないものがあります。具体例としては、 -s オプションと引数とを離して記述することはできません。 また -e、 -i、 -n の各オプションは、 2 つの引数を記述するのであれば、 それらをオプション文字と離すことはできません。
以下のオプションは、 /usr/bin/pr と /usr/xpg4/bin/pr の両方で使用できます。
書式化された入力の、 page で示すページ番号から出力を開始します。
column で示す数 ( デフォルトは 1) のカラムからなる、複数カラム出力を生成します。 これらのカラムには、入力ファイルからテキストを受け取った順序で データが書き出されます。 このオプションは -m オプションと同時に使うことはできません。 複数カラム出力を指定すると、 -e と -i の両オプションも指定されたと見なされます。 同一行数となるようなテキストカラムの生成を指定したか否か に関わらず、テキストカラムがページの長さを超えることはありません ( -l オプションの説明を参照 ) 。このオプションを -t とともに指定した場合、最少の行数で出力データを書き出します。
出力ページ内において、連鎖的にカラムが印刷されるよう、 -column オプション指定による出力を加工します。 たとえば column の値が 2 のとき、最初の入力行が 1 行目のカラム 1 に、 2 番目の入力行が 1 行目のカラム 2 に出力された後、続く 3 番目の行は 2 行目のカラム 1 に置かれます。
入力中に復帰改行文字が現れるたびに、その後にもう一つ 復帰改行文字を挿入して、ダブルスペース ( 2 倍の改行幅 ) で出力を生成します。
入力中の各タブ文字を、式 n *gap+1 を満たす次のカラム位置に展開します。 n は正の整数です。 gap に 0 を指定するか gap を省略すると、デフォルトとして 8 が用いられます。入力中のタブ文字は、 すべて適切な数の空白文字に展開されます。 数字でない文字 char を指定すると、それは入力タブ文字と見なされます。
改ページの際に、デフォルトである一連の復帰改行文字の代わりに、 用紙送り文字を使用します。 標準出力が端末に割り当てられているとき、 最初のページの出力を始める前に一時停止します。
ページヘッダーの見出しとして、 file オペランドの値の代わりに header で示す文字列を使用します。
ページの長さを、デフォルトの 66 の代わりに lines で示す行数に設定します。 lines の値がヘッダーとトレーラの長さの合計行数以下の場合、 pr は -t オプションが有効な場合と同じように、 ヘッダーとトレーラの出力を抑止します。
ファイルをマージします。 pr は file で指定された複数のファイルから 1 行ずつを読み込み、同じ幅のテキストカラムにそれらの行の内容を印刷して 標準出力を生成します。 最大 9 個のファイルのマージがサポートされています。
行番号の桁数を width で示す値とします。デフォルトは 5 です。出力上において行番号は、 デフォルト出力の場合には各テキストカラムの先頭の width 個のカラムを、 -m 出力の場合には各行の先頭の width 個のカラムを占めます。数字でない文字 char を指定すると、行番号と後続の出力を隔てるために行番号に付加されます。 char のデフォルトはタブ文字です。
各出力行の先頭に offset 個の空白文字を付加します。 -o オプションを省略すると、デフォルトのオフセット値は 0 となります。ここで指定するオフセット値は、出力行の幅に追加されます ( 後述する -w オプションの説明を参照 ) 。
標準出力が端末に割り当てられているとき、 ページの出力を始める前に一時停止します。 pr は警告 (ALERT) 文字を標準エラー出力に送り、 /dev/tty 上で改行文字が読み込まれるのを待ちます。
ファイルをオープンできなくても、それに関する診断レポートを出力しません。
テキストカラムを区切る文字として、一連の空白文字の代わりに、 char で示す 1 文字を使用します。 char のデフォルトはタブ文字です。
各ページに通常出力される 5 行のヘッダーと 5 行のトレーラを出力しません。 各ファイルの最終行を出力した後、そのページの最終行まで行送りをせず、 出力を停止します。
行の幅を width で示す数のカラム位置に設定します。 この指定は複数カラム出力に対してのみ有効です。 このオプションを省略したときのデフォルトの行幅は、 -s オプションも省略されていれば 72 となり、 -s オプションが指定されていれば 512 となります。
シングルカラム出力の場合には、 入力行の内容が出力幅の制限によって切り捨てられることはありません。
以下のオプションは、 /usr/bin/pr でのみ使用できます。
入力ファイルの行を折り返します。 -a または -m オプション指定による複数カラムモード使用時は、 現在のカラム幅に合うように行を折り返します。 複数カラムモードでなければ、現在の行幅 (80 カラム ) に合うように行を折り返します。
出力上で 1 つ以上の連続した空白文字が gap+1、 2*gap+1、 3*gap+1. . . のカラム位置に到達した場合、それらの空白文字を タブ文字で置き換えます。 gap を省略するかあるいは 0 を指定した場合、デフォルトとして 8 カラムごとにタブ位置が設定されていると見なされます。 数字でない文字 char を指定すると、それが出力タブ文字として使用されます。
ls -a | pr -n -h "Files in $(pwd)."
pr -3d -h "file list" file1 file2
pr -e9 -t <file1 >file2
pr の実行に影響を与える環境変数 LC_CTYPE 、 LC_TIME 、 LC_MESSAGES 、 NLSPATH 、 TZ についての詳細は、 environ(5) を参照してください。
次の属性については attributes(5) のマニュアルページを参照してください。
名前 | 形式 | 機能説明 | オプション | オペランド | 使用例 | 環境 | 終了ステータス | 属性 | 関連項目