release/man3/fdim.3

   1 .\" Copyright 2003 Walter Harms, Andries Brouwer
   2 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   3 .\"     <mtk.manpages@gmail.com>
   4 .\" Distributed under GPL.
   5 .\"
   6 .\" Japanese Version Copyright (c) 2004-2005 Yuichi SATO
   7 .\"         all rights reserved.
   8 .\" Translated Sat Jul 24 10:14:17 JST 2004
   9 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  10 .\" Updated & Modified Mon Jan 10 08:17:08 JST 2005 by Yuichi SATO
  11 .\" Updated 2008-09-16, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  12 .\"
  13 .TH FDIM 3 2010-09-20 "" "Linux Programmer's Manual"
  14 .SH 名前
  15 fdim, fdimf, fdiml \- 正の差分を計算する
  16 .SH 書式
  17 .B #include <math.h>
  18 .sp
  19 .BI "double fdim(double " x ", double " y );
  20 .br
  21 .BI "float fdimf(float " x ", float " y );
  22 .br
  23 .BI "long double fdiml(long double " x ", long double " y );
  24 .sp
  25 \fI-lm\fP でリンクする。
  26 .sp
  27 .in -4n
  28 glibc 向けの機能検査マクロの要件
  29 .RB ( feature_test_macros (7)
  30 参照):
  31 .in
  32 .sp
  33 .ad l
  34 .BR fdimf (),
  35 .BR fdiml ():
  36 .RS 4
  37 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
  38 _POSIX_C_SOURCE\ >=\ 200112L;
  39 .br
  40 or
  41 .I cc\ -std=c99
  42 .RE
  43 .ad
  44 .SH 説明
  45 これらの関数は、二つの引き数間の正の差分 max(\fIx\fP-\fIy\fP,0) を返す。
  46 .SH 返り値
  47 成功すると、これらの関数は正の差分を返す。
  48
  49 .I x
  50 か
  51 .I y
  52 が NaN の場合、NaN が返される。
  53
  54 結果がオーバーフローする場合、範囲エラーが発生し、
  55 各関数はそれぞれ
  56 .BR HUGE_VAL ,
  57 .BR HUGE_VALF ,
  58 .B HUGE_VALL
  59 を返す。
  60 .SH エラー
  61 これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は
  62 .BR math_error (7)
  63 を参照のこと。
  64 .PP
  65 以下のエラーが発生する可能性がある。
  66 .TP
  67 範囲エラー (range error)、オーバーフローの場合
  68 .\" .I errno
  69 .\" is set to
  70 .\" .BR ERANGE .
  71 オーバーフロー浮動小数点例外
  72 .RB ( FE_OVERFLOW )
  73 が上がる。
  74 .PP
  75 これらの関数は
  76 .I errno
  77 を設定しない。
  78 .\" FIXME . Is it intentional that these functions do not set errno?
  79 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796
  80 .SH バージョン
  81 これらの関数は glibc バージョン 2.1 で初めて登場した。
  82 .SH 準拠
  83 C99, POSIX.1-2001.
  84 .SH 関連項目
  85 .BR fmax (3)