次: , 前: fmt invocation, 上: Formatting file contents


4.2 pr: 印刷のためのファイルのページ化とコラム化

prは,それぞれのfile(`-'は標準入力を意味します)や, 与えられない場合は標準入力をページ化し,オプションで複数列の書式での出 力を標準出力に書き出します.オプションで,全てのfileを結合し一列 ごとに並列に全てを出力します.概要です.

     pr [option]... [file]...

デフォルトで,五行のヘッダがそれぞれのページに出力されます.二行の空白 行.日付,ファイル名,そしてページ番号がある行.さらに二行は空白行です. また,五行の空白行を持つフッタも出力します.-Fオプションで, 三行のヘッダを出力します.最初の二行の空白行は削除されます.フッタは使 用されません.どちらの場合でもデフォルトのpage_lengthは66行です. テキスト行のデフォルト数は56(-Fが無い場合)から63(-F がある場合)まで変化します.ヘッダのテキスト行は,`date string page'の形式で,行がpage_widthいっぱいになるよ うにstringの周りにスペースが挿入されます.ここで,dateは日 付(詳細は,-D--date-formatオプションを参照してくだ さい),stringはセンタリングされたヘッダ文字列,そしてpage はページ番号を示します.LC_MESSAGESロカールカテゴリはpage の綴りに影響します.デフォルトのCロカールでは`Page number' になり,numberは十進数のページ番号です.

入力のフォームフィードは,出力で改ページとなります.複数のフォームフィー ドは空のページを生成します.

列は同じ幅で,オプションの文字列(デフォルトは`space')で分けられて います.複数列の出力では,-Jオプションを使用していない場合, 行は常にpage_width(デフォルトで72)で切り詰められます.単一列での 出力は,デフォルトでは切り詰められません.その場合,行を切り詰めるため -Wオプションを使用してください.

以下の変更は,version 1.22iでなされ,それ以降のprのバージョ ンに適用されています. - Brian

プログラムは以下のオプションを受け入れます.Common optionsも参照 してください.

`+first_page[:last_page]'
`--pages=first_page[:last_page]'
ページfirst_pageから出力を開始し,last_pageで停止します. `:last_page'が無い場合は,ファイルの終りを暗黙に指定します. 飛ばされたページ数を計算している間,入力ファイルのそれぞれのフォーム フィードは,結果として新しいページになります.`+first_page' がある場合と無い場合のページの数え方は同じです.デフォルトで,入力ファ イルの最初のページでカウントを開始します(最初のページは出力されません). 行の番号付けは,-Nオプションで変更してもかまいません.
`-column'
`--columns=column'
それぞれ単一fileを用いて,-aが使用されない場合は column列(デフォルトで1)の出力を生成し列を下へ向かって出力します. 列の幅は,columnが増加するに従い,自動的に減少します. page_widthを増加させるため,-W/-wを使用していない場合も 同様です.このオプションは,いくつかの行を切り詰める可能性があります. それぞれのページの列の行数は平均化されます.オプション-e-iは,複数のテキスト列の出力のためにあります.-Jをと もに用いると,列の整列と行の切り詰めは停止します.十分な長さの行は,フ リーフィールド書式に組み込まれ,-Sオプションはフィールドを分 ける可能性があります.-column-mオプションと ともに使用してはいけません.
`-a'
`--across'
それぞれ単一fileを用い,列を下ではなく横に出力します. -columnオプションは,一列以上のcolumnで与える必要 があります.列に適さないほど余りに長い場合,それは切り詰められます.
`-c'
`--show-control-chars'
ハット表記で(例えば,`^G')を使用して制御文字を出力します.八進数 のバックスラッシュ表記で,その他の印刷不可能な文字を表示します.デフォ ルトで,印刷不可能な文字は変更されません.
`-d'
`--double-space'
ダブルスペースの出力です.
`-D format'
`--date-format=format'
formatを使用してヘッダの日付を書式化し,それはコマンド`date +format'と同じ慣習を使用します.See date invocation. `%'で始まる指示語以外,format内の文字は変更されずに出力され ます.ヘッダの日付の場所に,例えば--date-format="Monday morning"のような,任意の文字列を指定するために,このオプションを使用 することが可能です.

POSIXLY_CORRECT環境変数が設定されていない場合,日付の書式はデフォ ルトで`%Y-%m-%d %H:%M'です(例えば,`2001-12-04 23:59').それ 以外の場合,書式はLC_TIMEロカールカテゴリに依存し,デフォルトは `%b %e %H:%M %Y'(例えば,`Dec 4 23:59 2001')になります.

`-e[in-tabchar[in-tabwidth]]'
`--expand-tabs[=in-tabchar[in-tabwidth]]'
入力のtabをスペースに展開します.オプションの引数 in-tabcharは,入力のタブ文字(デフォルトはTAB文字)です.二番目の オプション引数in-tabwidthは,入力タブ文字の幅(デフォルトは8)です.
`-f'
`-F'
`--form-feed'
出力ページを分けるため,改行の代わりにフォームフィードを使用します.デ フォルトページの長さの66行は変更されません.しかし,ページごとのテキス トの行数はデフォルトの56行から63行に変更されます.
`-h HEADER'
`--header=HEADER'
ヘッダのファイル名を中央揃えされた文字列headerで置換します.シェ ルを使用しているとき,headerを引用符で囲むべきで,-hと はスペースで分離すべきです.
`-i[out-tabchar[out-tabwidth]]'
`--output-tabs[=out-tabchar[out-tabwidth]]'
出力上でスペースをtabに置換します.オプション引数 out-tabcharは出力されるタブ文字です(デフォルトはTAB文字です).二 番目のオプション引数out-tabwidthは出力されるタブ文字の幅(デフォ ルトで8)です.
`-J'
`--join-lines'
十分な長さの行に統合します.列オプション-column-a -column,または-mとともに使用します. -W/-wの行の切り詰めを停止します.列の整列は使用されません. `-S[string]'とともに使用してもかまいません.-Jは (-W-Sとともに),三列オプションの古い (POSIX 準拠の)オプション-w-sを解決するた めに導入されました.
`-l page_length'
`--length=page_length'
ページの長さを,ヘッダ[とフッタ]の行を含めて,page_length行(デフォ ルトで66)に設定します.page_lengthが10以下(または-Fが3 以下)の場合,ヘッダとフッタは取り除かれ,入力ファイルの全てのフォーム フィード設定は,-Tオプションが指定されたかのように無視されま す.
`-m'
`--merge'
全てのfileを並列に,それぞれの列に一つに統合して出力します.列に 適さないほど行が長すぎる場合,それは-Jオプションが使用されて いない限り切り詰められます.--sep-string[=string]を使用 してもかまいません.fileの(フォームフィード設定の)空のページは空 の列を生成しますが,stringで印は付いたままです.結果として,連続 した行の番号付けと,統合されたファイル全体を通じて印が付いた列になりま す.統合されても完全に空のページになるものは,区切りも行番号もありませ ん.デフォルトヘッダは`date page'になり,真中にスペー スが挿入されます.これで中間の空白部分を満たすため,-h--headerオプションとともに使用してもかまいません.
`-n[number-separator[digits]]'
`--number-lines[=number-separator[digits]]'
digits桁の行の番号付けを提供します(デフォルトのdigitsは5で す).複数列の出力では,番号はそれぞれのテキスト列の最初のdigits 列の位置や,-m出力のそれぞれの行だけに生成されます.単一列の 出力では,番号はそれぞれの行に-mが行うように生成します.デフォ ルトの行カウントの開始は,入力ファイルの最初の行で始まります (--pageオプションと-Nオプションとは異なり,最初に印 刷される行ではありません).オプション引数number-separatorは,以 下に続くテキストと分離するために行数に後置される文字です.デフォルトの 分離文字はTAB文字です.厳密な意味で,TABは常に単一の列の出力だけに出力 されます.TAB幅はTAB位置で変化し,例えば,左のmargin-oオプションで指定された場合は変化します.複数列出力のプロ パティは,`equal width of output columns' (POSIX指定) で与えられます.TAB幅は,最初の列の値で固定され,左の marginの値の違いでは変更されません.それは,固定数のスペースが常 にnumber-separator tabの位置に出力されることを意味します.タブ機 能は出力位置に依存します.
`-N line_number'
`--first-line-number=line_number'
最初のページに出力される最初の行(ほとんどの場合,入力ファイルの最初で はありません)を,数字のline_numberで行のカウントを開始します.
`-o margin'
`--indent=margin'
それぞれの行をmarginスペースのマージン幅(デフォルトはゼロ)で字下 げします.ページ全体の幅はマージンに-W/-wオプションの page_width設定を加えたものになります.数字付の単一列の出力では (-nオプションとは異なり)制限されることによるオーバーフローが 発生するかもしれません.
`-r'
`--no-file-warnings'
引数fileが開けなかったとき,警告メッセージを出力しません.(しか し,終了ステータスはゼロではありません.)
`-s[char]'
`--separator[=char]'
単一文字charで列を分けます.charのデフォルトは, -wを用いないとTAB文字で,-wを用いると`no character'になります.-sが無い場合のデフォルトの分離文字は `space'に設定されます.-s[char]は,-wが設定され ていない場合,全ての三列オプション(-COLUMN|`-a -COLUMN'|-m)の行の切り詰めを停止します.それは, POSIX準拠の公式なものです.
`-S string'
`--sep-string[=string]'
出力の列を分離するためstringを使用します.-Sオプション は-sオプションと異なり,-W/-wオプションに対し効果が ありません.それは行の切り詰めや列の整列に効果がありません. -S を用いず,-Jを用いると,prはデフォルト の出力の分離文字のTABを使用します.-S-Jを用いない と,pr は`space'を使用します(`-S" "'と同じです). -Sstringを用るとき,stringを空にしてはいけません. stringが無い--sep-string--sep-string=""と等 価です.

古いシステムでは,prは時代遅れのオプション -S[string]を代わりにサポートし,stringはオプショ ンになります.POSIX 1003.1-2001 (see Standards conformance)ではこの古い使用方法を許可していません.移植性がある空の stringを指定するため,--sep-stringを使用してください.

`-t'
`--omit-header'
それぞれのページに,通常のヘッダ[とフッタ]を出力せず,ページの底まで補 充しません(空白行またはフォームフィードを用います).ページ構造は生成さ れませんが,入力ファイルで設定されているフォームフィードは維持されます. 前もって定義されたページ化は変更されません.-t-Tは, 他のオプションとともに使用すると便利かもしれません.例えば,`-t -e4'は,入力ファイルのTAB文字を四つのスペースに展開しますが,それ以外 の変更を行いません.-tの使用は-hに優先します.
`-T'
`--omit-pagination'
ヘッダ[とフッタ]を出力しません.更に,入力ファイルのフォームフィード設 定を全て削除します.
`-v'
`--show-nonprinting'
出力できない文字を,八進数のバックスラッシュ表記で出力します.
`-w page_width'
`--width=page_width'
複数のテキスト列出力に対してのみ,ページ幅をpage_width文字数に設 定します(page_widthのデフォルトは72です).-s[CHAR]は, デフォルトページ幅を停止し,すべての行を切り詰め,列を整列します.十分 な長さの行は,列オプションの設定にかかわらずマージされます. page_width設定が無い場合,おそらく単一列の出力になります. POSIX準拠の公式なものです.
`-W page_width'
`--page_width=page_width'
ページ幅をpage_width文字に設定します.それは列オプションによらず 有効です.-Jが使用されない場合,テキスト行は切り詰められます. 三列オプション(-column,`-a -column',または -m)の一つとともに用いた場合,列の整列は常に使用されます.セパ レータオプションの-S-sは,-Wオプションに 効果がありません.デフォルトは72文字です.`-W page_width'が 無く,あらゆる列オプションが無い場合,行の切り詰めは行われません(下位 互換を保つためと,よくある仕事に合わせるために定義されています).それ は,`-W 72 -J'と等価です.ヘッダ行は常に切り詰められません.

終了ステータスのゼロは成功を示し,ゼロ以外の値は失敗を示します.