aboutsummaryrefslogtreecommitdiff
path: root/ja/man/man1/printf.1
diff options
context:
space:
mode:
Diffstat (limited to 'ja/man/man1/printf.1')
-rw-r--r--ja/man/man1/printf.1259
1 files changed, 0 insertions, 259 deletions
diff --git a/ja/man/man1/printf.1 b/ja/man/man1/printf.1
deleted file mode 100644
index 34be58ac13..0000000000
--- a/ja/man/man1/printf.1
+++ /dev/null
@@ -1,259 +0,0 @@
-.\" Copyright (c) 1989, 1990, 1993
-.\" The Regents of the University of California. All rights reserved.
-.\"
-.\" This code is derived from software contributed to Berkeley by
-.\" the Institute of Electrical and Electronics Engineers, Inc.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\" 3. All advertising materials mentioning features or use of this software
-.\" must display the following acknowledgement:
-.\" This product includes software developed by the University of
-.\" California, Berkeley and its contributors.
-.\" 4. Neither the name of the University nor the names of its contributors
-.\" may be used to endorse or promote products derived from this software
-.\" without specific prior written permission.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" @(#)printf.1 8.1 (Berkeley) 6/6/93
-.\" jpman %Id: printf.1,v 1.2 1997/05/20 01:08:19 mutoh Stab %
-.\"
-.Dd June 6, 1993
-.Dt PRINTF 1
-.Os
-.Sh 名称
-.Nm printf
-.Nd フォーマット済み出力
-.Sh 書式
-.Nm
-.Ar format Op Ar arguments ...
-.Sh 解説
-.Nm
-は第一引数より後の引数をフォーマットに合わせて出力します。
-.Ar format
-は 3 種類のオブジェクトを含む文字列です。
-一つは通常の文字列で、単純に標準出力にコピーされます。
-一つはエスケープシーケンスで、変換されてから標準出力にコピーされます。
-もう一つはフォーマット記述で、これらはそれぞれ、後に続く
-.Ar arguments
-を表示します。
-.Pp
-第一引数より後の
-.Ar arguments
-は対応するフォーマットが
-.Cm c
-か
-.Cm s
-の場合は文字列として扱われ、それ以外は以下のような拡張部分と
-合わせて C の定数として評価されます。
-.Pp
-.Bl -bullet -offset indent -compact
-.It
-先頭に ``+'' や ``-'' の符号をつけることができます。
-.It
-もし先頭がシングルクォートやダブルクォートで始まっているか、数字、プラ
-ス/マイナス記号で始まっているのでなければ、その値は次の文字の
-.Tn ASCII
-コードになります。
-.El
-.Pp
-フォーマット文字列は
-.Ar arguments
-を変換するために何度も
-再利用されます。余分なフォーマット記述は 0 やヌル文字列に
-評価されます。
-.Pp
-キャラクタエスケープシーケンスは
-.Tn ANSI C
-規格
-.Tn X3J11
-で立案された定義で、バックスラッシュによる表記です。文字キャラクタとそ
-の意味は以下のようになります。
-.Bl -tag -width Ds -offset indent
-.It Cm \ea
-<ベル> キャラクタを書きます。
-.It Cm \eb
-<バックスペース> キャラクタを書きます。
-.It Cm \ef
-<フォームフィード> キャラクタを書きます。
-.It Cm \en
-<改行> キャラクタを書きます。
-.It Cm \er
-<復帰> キャラクタを書きます。
-.It Cm \et
-<タブ> キャラクタを書きます。
-.It Cm \ev
-<垂直タブ> キャラクタを書きます。
-.It Cm \e\'
-<シングルクォート> キャラクタを書きます。
-.It Cm \e\e
-<バックスラッシュ>キャラクタを書きます。
-.It Cm \e Ns Ar num
-1 から 3 桁の 8 進数
-.Ar num
-で表される
-.Tn ASCII
-コードの 8 ビット文字を書きます。
-.El
-.Pp
-各フォーマットの指定はパーセント文字(``%'')から始まります。
-フォーマットの他の部分は、以下の順番で続きます:
-.Bl -tag -width Ds
-.It "以下のフラグが 0 個以上つきます:"
-.Bl -tag -width Ds
-.It Cm #
-`#' キャラクタは数値を ``別形式'' で表示させるという指定です。
-.Cm c ,
-.Cm d ,
-.Cm s
-フォーマットではこのオプションは無効です。
-.Cm o
-フォーマットでは出力文字列の先頭に 0 をつけるため、
-その値の精度が上がります。
-.Cm x
-.Pq Cm X
-フォーマットでは、0 以外の値なら出力される文字列の先頭に
-.Li 0x
-.Pq Li 0X
-がつきます。
-.Cm e ,
-.Cm E ,
-.Cm f ,
-.Cm g ,
-.Cm G
-のフォーマットでは、たとえ小数点以下の値がなくても常に小数点がつきます
-(通常のフォーマットでは、小数点以下の値がある時のみ結果に小数点が含ま
-れます)。
-.Cm g
-と
-.Cm G
-のフォーマットでは、結果の終わりに付く 0 は通常のフォーマットと違って
-省略されません。
-.It Cm \&\-
-指定したフィールド幅で
-.Em 左詰め
-で出力します。
-.It Cm \&+
-符号つきのフォーマットの時に、数字の前に常に符号がつくように
-なります。
-.It Sq \&\ \&
-符号つきのフォーマットで正の値を表示する時に先頭に空白が一つ挿入されま
-す。 `+' と空白の両方が指定された場合、`+' が空白に優先されます。
-.It Cm \&0
-`0' は空白でパディングする代りに `0' でパディングを行ないます。
-`\-' と `0' の両方が指定された場合、`\-' が優先されます。
-.El
-.It "フィールド幅:"
-.Em field width ;
-.Em フィールド幅
-を指定するためにオプションとしてつける数値です。
-出力する文字列がこのフィールド幅よりも短い場合、フィールド幅を埋めるよ
-うに左側が(左詰めの指示があれば、右側が)空白でパディングされます。
-(先頭につく 0 はフラグですが、埋め込まれた 0 はフィールド幅の一部であ
-ることに注意)
-.It 精度:
-オプションでつけるピリオド
-.Sq Cm \&.\& ,
-には、
-.Em 精度
-を表わす数のオプションが続きます。この数は
-.Cm e
-と
-.Cm f
-フォーマットの場合に小数点以下の値を表示する桁数を指定し
-ます。
-.Cm e ,
-.Cm f
-以外では、文字列から表示される文字の最大数になります。もし精度を表す数
-がなければ、精度は 0 とされます。
-.It Format:
-フォーマットの型を表す文字です(
-.Cm diouxXfwEgGbcs
-のうちのいずれか)。
-.El
-.Pp
-フィールド幅や精度は数字の代りに
-.Sq Cm \&*
-も使えます。この場合、フィールド幅や精度は
-.Ar argument
-で与えます。
-.Pp
-フォーマットキャラクタとその意味は以下のようになります:
-.Bl -tag -width Fl
-.It Cm diouXx
-.Ar argument
-はそれぞれ符号つき 10 進数(d または i)、符号なし 8 進数(o)、
-符号なし 10 進数(u)、符号なし 16 進数(X または x)で表示されます。
-.It Cm f
-.Ar argument
-が `[\-]ddd.ddd' のスタイルで表示され、引数の精度で指定した数だけ小数
-点以下の d が続きます。精度の指定がなければ 6 文字になります。もし精度
-が明示的に 0 と指定された場合は小数点とそれ以下の値は表示されません。
-.It Cm eE
-.Ar argument
-が
-.Sm off
-.Pf [\-]d Cm \&. No ddd Cm e No \\*(Pmdd
-.Sm on
-のように、小数点の前に数字が一つで、後には引数の精度で指定した数だけ数
-字が続きます。精度の指定がなければ 6 文字になります。
-.Sq Cm \&E
-フォーマットが使われます。
-.It Cm gG
-.Ar argument
-が、最小の長さで最大の精度が得られるように、
-.Cm f
-または、
-.Cm e
-.Pq Cm E
-で表示されます。
-.It Cm c
-.Ar argument
-の最初の文字が表示されます。
-.It Cm s
-.Ar argument
-が終わりまでか、または精度で指定された文字数だけ表示されます。
-精度が 0 かもしくは指定されていない場合は文字列全てが表示されます。
-.It Cm \&%
-`%' を表示します。引数はつきません。
-.El
-.Pp
-存在しないフィールド、もしくは小さなフィールド幅指定でフィールドが切り
-詰められることはありません。指定されたフィールドが実際の幅を越えた時は、
-パディングが起こります。
-.Sh 戻り値
-.Nm
-は成功時には 0 を返し、失敗時には 1 を返します。
-.Sh 関連項目
-.Xr printf 3
-.Sh 歴史
-.Nm
-は、
-.Bx 4.3 Reno
-で追加され、標準ライブラリ関数
-.Xr printf 3
-に基いています。
-.Sh バグ
-浮動小数点数は
-.Tn ASCII
-から浮動小数に変換されてまた戻るので、浮動小数の精度が失われます。
-.Pp
-.Tn ANSI
-16 進文字定数はわざと用意されていません。