Namespaces
Variants

std:: ceil, std:: ceilf, std:: ceill

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
ceil
(C++11) (C++11) (C++11)
(C++11)
(C++11)
(C++11) (C++11) (C++11)
Floating point manipulation functions
(C++11) (C++11)
(C++11)
(C++11)
Classification and comparison
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Types
(C++11)
(C++11)
(C++11)
Macro constants
定義先ヘッダ <cmath>
(1)
float ceil ( float num ) ;

double ceil ( double num ) ;

long double ceil ( long double num ) ;
(C++23まで)
constexpr /*floating-point-type*/
ceil ( /*floating-point-type*/ num ) ;
(C++23から)
float ceilf ( float num ) ;
(2) (C++11から)
(C++23からconstexpr)
long double ceill ( long double num ) ;
(3) (C++11から)
(C++23からconstexpr)
定義先ヘッダ <simd>
template < /*math-floating-point*/ V >

constexpr /*deduced-simd-t*/ < V >

ceil ( const V & v_num ) ;
(S) (C++26から)
定義先ヘッダ <cmath>
template < class Integer >
double ceil ( Integer num ) ;
(A) (C++23からconstexpr)
1-3) num 以上の最小の整数値を計算する。 ライブラリはパラメータの型として、すべてのcv修飾されていない浮動小数点型に対する std::ceil のオーバーロードを提供する。 (C++23以降)
S) SIMDオーバーロードは v_num に対して要素ごとに std::ceil を実行します。
(定義については math-floating-point および deduced-simd-t を参照)
(C++26以降)
A) すべての整数型に対して追加のオーバーロードが提供されており、これらは double として扱われます。
(C++11以降)

目次

パラメータ

num - 浮動小数点または整数値

戻り値

エラーが発生しない場合、 num 以上の最小の整数値、すなわち ⌈num⌉ が返されます。

戻り値
math-ceil.svg
num

エラーハンドリング

エラーは math_errhandling で指定された通りに報告されます。

IEEE浮動小数点演算（IEC 60559）を実装がサポートしている場合、

  • 現在の 丸めモード は効果を持ちません。
  • num が±∞の場合、変更されずに返されます。
  • num が±0の場合、変更されずに返されます。
  • num がNaNの場合、NaNが返されます。

注記

FE_INEXACT 非整数の有限値を丸める際に、 FE_INEXACT が（必須ではないが）発生する可能性があります。

標準的な浮動小数点形式において、表現可能な最大の浮動小数点値はすべて正確な整数です。したがって、この関数自体がオーバーフローすることは決してありません。しかし、結果が整数変数に格納される場合、あらゆる整数型（ std::intmax_t を含む）をオーバーフローする可能性があります。この理由により、戻り値の型は整数型ではなく浮動小数点型となっています。

この関数（ double 引数に対して）は以下のコードで実装されているかのように動作します（ FE_INEXACT を発生させない自由を除く）: 

#include <cfenv>
#include <cmath>
#pragma STDC FENV_ACCESS ON
double ceil(double x)
{
    int save_round = std::fegetround();
    std::fesetround(FE_UPWARD);
    double result = std::rint(x); // または std::nearbyint
    std::fesetround(save_round);
    return result;
}

追加のオーバーロードは (A) と完全に同一である必要はありません。それらは、整数型の引数 num に対して、 std :: ceil ( num ) が std :: ceil ( static_cast < double > ( num ) ) と同じ効果を持つことを保証するのに十分であればよいのです。

例

このコードを実行 
#include <cmath>
#include <iostream>
int main()
{
    std::cout << std::fixed
              << "ceil(+2.4) = " << std::ceil(+2.4) << '\n'
              << "ceil(-2.4) = " << std::ceil(-2.4) << '\n'
              << "ceil(-0.0) = " << std::ceil(-0.0) << '\n'
              << "ceil(-Inf) = " << std::ceil(-INFINITY) << '\n';
}

出力: 

ceil(+2.4) = 3.000000
ceil(-2.4) = -2.000000
ceil(-0.0) = -0.000000
ceil(-Inf) = -inf

関連項目

(C++11) (C++11)
指定された値以下の最大の整数
(関数)
(C++11) (C++11) (C++11)
絶対値が指定された値以下で最も近い整数
(関数)
(C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11)
最も近い整数（中間値の場合にはゼロから遠ざかる方向に丸める）
(関数)
(C++11) (C++11) (C++11)
現在の丸めモードを使用した最も近い整数
(関数)
(C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11) (C++11)
現在の丸めモードを使用した最も近い整数（結果が異なる場合に例外発生）
(関数)
Cドキュメント for ceil

外部リンク

整数除算の高速天井関数 — StackOverflow