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