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