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