ceilのヘルプ・マニュアル
日本語 英語
ceil --help
man ceil
CEIL(3) Linux Programmer’s Manual CEIL(3)
名前
ceil, ceilf, ceill - 引き数を下回らない最小の整数値
書式
#include
double ceil(double x);
float ceilf(float x);
long double ceill(long double x);
-lm でリンクする。
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
ceilf(), ceill(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600
|| _ISOC99_SOURCE; or cc -std=c99
説明
これらの関数は x より小さくない最小の整数値を返す。
例えば、 ceil(0.5) は 1.0 であり、 ceil(-0.5) は 0.0 である。
返り値
これらの関数は x を下回らない整数値を返す。
x が整数、+0、-0、NaN、無限のいずれかの場合、 x そのものを返す。
エラー
エラーは発生しない。 POSIX.1-2001 にはオーバーフローに対して範囲エラ ー
が記載されている。「注意」の節を参照。
準拠
C99, POSIX.1-2001. double 版の関数は SVr4, 4.3BSD, C89 にも準拠してい
る。
注意
SUSv2 と POSIX.1-2001 にはオーバーフローに関する記述があり、オーバー フ
ロ ーの際には errno を ERANGE に設定するか FE_OVERFLOW 例外を起こすとな
っている。実際のところ、どの現行のマシンでも結果がオーバーフローを起 こ
す ことはないので、このエラー処理は意味がない。 (より正確に言うと、オー
バーフローは指数部の最大値が仮数部を表すビットの数より小さい場合にし か
起 こらない。 IEEE-754 規格の 32 ビットと 64 ビットの浮動小数では、指数
部の最大値はそれぞれ 128 と 1024 であり、仮数部のビット数はそれぞれ 24
と 53 である。)
こ れらの関数が返す整数値は整数型 (int, long など) に格納するには大き過
ぎるかもしれない。オーバーフローが起こった場合の結果は分からないので 、
オ ーバーフローを避けるため、アプリケーションでは整数型に代入する前に返
された値の範囲確認を実行すべきである。
関連項目
floor(3), lrint(3), nearbyint(3), rint(3), round(3), trunc(3)
2008-08-05 CEIL(3)
CEIL(3) Linux Programmer’s Manual CEIL(3)
NAME
ceil, ceilf, ceill - ceiling function: smallest integral value not less
than argument
SYNOPSIS
#include
double ceil(double x);
float ceilf(float x);
long double ceill(long double x);
Link with -lm.
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
ceilf(), ceill(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600
|| _ISOC99_SOURCE; or cc -std=c99
DESCRIPTION
These functions return the smallest integral value that is not less
than x.
For example, ceil(0.5) is 1.0, and ceil(-0.5) is 0.0.
RETURN VALUE
These functions return the ceiling of x.
If x is integral, +0, -0, NaN, or infinite, x itself is returned.
ERRORS
No errors occur. POSIX.1-2001 documents a range error for overflows,
but see NOTES.
CONFORMING TO
C99, POSIX.1-2001. The variant returning double also conforms to SVr4,
4.3BSD, C89.
NOTES
SUSv2 and POSIX.1-2001 contain text about overflow (which might set
errno to ERANGE, or raise an FE_OVERFLOW exception). In practice, the
result cannot overflow on any current machine, so this error-handling
stuff is just nonsense. (More precisely, overflow can happen only when
the maximum value of the exponent is smaller than the number of man-
tissa bits. For the IEEE-754 standard 32-bit and 64-bit floating-point
numbers the maximum value of the exponent is 128 (respectively, 1024),
and the number of mantissa bits is 24 (respectively, 53).)
The integral value returned by these functions may be too large to
store in an integer type (int, long, etc.). To avoid an overflow,
which will produce undefined results, an application should perform a
range check on the returned value before assigning it to an integer
type.
SEE ALSO
floor(3), lrint(3), nearbyint(3), rint(3), round(3), trunc(3)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
2008-08-05 CEIL(3)