Namespaces
Variants

std:: floor, std:: floorf, std:: floorl

From cppreference.net
C++
Numerics library
Common mathematical functions
Nearest integer floating point operations
floor
(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 floor ( float num ) ;

double floor ( double num ) ;

long double floor ( long double num ) ;
(C++23以前)
constexpr /*floating-point-type*/
floor ( /*floating-point-type*/ num ) ;
(C++23以降)
float floorf ( float num ) ;
(2) (C++11以降)
(C++23以降constexpr)
long double floorl ( long double num ) ;
(3) (C++11以降)
(C++23以降constexpr)
ヘッダーで定義 <simd>
template < /*math-floating-point*/ V >

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

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

目次

パラメータ

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

戻り値

エラーが発生しない場合、 num 以下の最大の整数値、すなわち ⌊num⌋ が返されます。

戻り値
math-floor.svg
num

エラーハンドリング

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

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

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

注記

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

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

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

例

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

出力: 

floor(+2.7) = 2.000000
floor(-2.7) = -3.000000
floor(-0.0) = -0.000000
floor(-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ドキュメント for floor