release/man3/remquo.3

   1 .\" Copyright 2002 Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   3 .\"     <mtk.manpages@gmail.com>
   4 .\" Distributed under GPL
   5 .\" based on glibc infopages
   6 .\" polished, aeb
   7 .\"*******************************************************************
   8 .\"
   9 .\" This file was generated with po4a. Translate the source file.
  10 .\"
  11 .\"*******************************************************************
  12 .TH REMQUO 3 2010\-09\-20 GNU "Linux Programmer's Manual"
  13 .SH 名前
  14 remquo, remquof, remquol \- 商の一部と剰余を求める
  15 .SH 書式
  16 .nf
  17 \fB#include <math.h>\fP
  18 .sp
  19 \fBdouble remquo(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB, int *\fP\fIquo\fP\fB);\fP
  20 .br
  21 \fBfloat remquof(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB, int *\fP\fIquo\fP\fB);\fP
  22 .br
  23 \fBlong double remquol(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB, int *\fP\fIquo\fP\fB);\fP
  24 .fi
  25 .sp
  26 \fI\-lm\fP でリンクする。
  27 .sp
  28 .in -4n
  29 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  30 .in
  31 .sp
  32 .ad l
  33 \fBremquo\fP(), \fBremquof\fP(), \fBremquol\fP():
  34 .RS 4
  35 _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L;
  36 .br
  37 or \fIcc\ \-std=c99\fP
  38 .RE
  39 .ad
  40 .SH 説明
  41 これらの関数は \fIx\fP を \fIy\fP で割ったときの商の一部と剰余を計算する。 商のいくつかのビットが \fIquo\fP ポインタを使って格納される。
  42 剰余は関数の結果として返される。
  43
  44 剰余の値は \fBremainder\fP(3)  関数で計算されるものと同じである。
  45
  46 \fIquo\fP ポインタを使って格納される値には、 \fIx\ /\ y\fP の符号と最低でも商の下位 3 ビットが含まれる。
  47
  48 .\" A possible application of this function might be the computation
  49 .\" of sin(x). Compute remquo(x, pi/2, &quo) or so.
  50 .\"
  51 .\" glibc, UnixWare: return 3 bits
  52 .\" MacOS 10: return 7 bits
  53 たとえば \fIremquo(29.0,\ 3.0)\fP は \-1.0 を返し、 (訳注: quo の指しているものには) 2 が格納される。
  54 実際の商が整数値にならない点に注意すること。
  55 .SH 返り値
  56 成功すると、これらの関数は \fBremainder\fP(3)  に書かれている同様の関数と同じ値を返す。
  57
  58 \fIx\fP か \fIy\fP が NaN の場合、NaN が返される。
  59
  60 \fIx\fP が無限大で \fIy\fP が NaN でない場合、 領域エラー (domain error) が発生し、NaN が返される。
  61
  62 \fIy\fP がゼロで \fIx\fP が NaN でない場合、 領域エラー (domain error) が発生し、NaN が返される。
  63 .SH エラー
  64 これらの関数を呼び出した際にエラーが発生したかの判定方法についての情報は \fBmath_error\fP(7)  を参照のこと。
  65 .PP
  66 以下のエラーが発生する可能性がある。
  67 .TP
  68 領域エラー (domain error): \fIx\fP が無限大か \fIy\fP が 0 で、 他の引き数が NaN でない
  69 .\" .I errno
  70 .\" is set to
  71 .\" .BR EDOM .
  72 不正 (invalid) 浮動小数点例外 (\fBFE_INVALID\fP)  が上がる。
  73 .PP
  74 .\" FIXME . Is it intentional that these functions do not set errno?
  75 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6802
  76 これらの関数は \fIerrno\fP を設定しない。
  77 .SH バージョン
  78 これらの関数は glibc バージョン 2.1 で初めて登場した。
  79 .SH 準拠
  80 C99, POSIX.1\-2001.
  81 .SH 関連項目
  82 \fBfmod\fP(3), \fBlogb\fP(3), \fBremainder\fP(3)