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 .\"
   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 2014\-05\-10 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 .SS "マルチスレッディング (pthreads(7) 参照)"
  93 関数 \fBremquo\fP(), \fBremquof\fP(), \fBremquol\fP() はスレッドセーフである。
  94 .SH 準拠
  95 C99, POSIX.1\-2001.
  96 .SH 関連項目
  97 \fBfmod\fP(3), \fBlogb\fP(3), \fBremainder\fP(3)
  98 .SH この文書について
  99 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
 100 である。プロジェクトの説明とバグ報告に関する情報は
 101 http://www.kernel.org/doc/man\-pages/ に書かれている。