std::lerp

 

C++

语言

标准库头文件

自立与有宿主实现

具名要求

语言支持库

概念库 (C++20)

诊断库

工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

原子操作库 (C++11)

线程支持库 (C++11)

技术规范

 

数值库

常用数学函数

数学特殊函数 (C++17)

数学常数 (C++20)

浮点环境 (C++11)

复数

数值数组

伪随机数生成

编译时有理数算术 (C++11)

因数运算

gcd (C++17)

lcm (C++17)

插值

midpoint (C++20)

lerp (C++20)

泛型数值运算

iota (C++11)

accumulate

inner_product

adjacent_difference

partial_sum

位操作

bit_cast (C++20)

byteswap (C++23)

has_single_bit (C++20)

bit_ceil (C++20)

bit_floor (C++20)

bit_width (C++20)

rotl (C++20)

rotr (C++20)

countl_zero (C++20)

countl_one (C++20)

countr_zero (C++20)

countr_one (C++20)

popcount (C++20)

endian (C++20)

 

定义于头文件 <cmath>
constexpr float       lerp( float a, float b, float t ) noexcept;	(1)	(C++20 起)
constexpr double      lerp( double a, double b, double t ) noexcept;	(2)	(C++20 起)
constexpr long double lerp( long double a, long double b, long double t ) noexcept;	(3)	(C++20 起)
constexpr Promoted    lerp( Arithmetic1 a, Arithmetic2 b, Arithmetic3 t ) noexcept;	(4)	(C++20 起)

1-3) 计算 \(a+t(b−a)\)a+t(b−a) ，即 a 与 b 间参数为 t 的线性内插（或为外插，当 t 落在范围 [0,1] 外时）。

4) 所有 1-3) 所不覆盖的算术类型参数的重载集或模板。。若任何参数拥有整数类型，则将它转型为 double 。若任何其他参数为 long double ，则返回类型为 long double ，否则为 double 。

参数

a, b, t

-

浮点或整数类型值

返回值

\(a+t(b−a)\)a+t(b−a)

isfinite(a) && isfinite(b) 时，保证下列属性：

• 若 t == 0 ，则结果等于 a ；
• 若 t == 1 ，则结果等于 b ；
• 若 t >= 0 && t <= 1 ，则结果有限；
• 若 isfinite(t) && a == b ，则结果等于 a ；
• 若 isfinite(t) || (!isnan(t) && b-a != 0) ，则结果非 NaN 。

令 CMP(x,y) 为若 x > y 则为 1 ，若 x < y 则为 -1 ，否则为 0 。对于任何 t1 与 t2 ， CMP(lerp(a, b, t2), lerp(a, b, t1)) 、 CMP(t2, t1) 与 CMP(b, a) 的积非负。（即 lerp 单调。）

注解

包含 <math.h> 时 lerp 在全局命名空间可用，即使它不是 C 的一部分。

示例

运行此代码

#include <iostream>
#include <cmath>
 
int main()
{
    float a=10.0f, b=20.0f;
 
    std::cout << "a=" << a << ", " << "b=" << b << '\n'
              << "mid point=" << std::lerp(a,b,0.5f) << '\n'
              << std::boolalpha << (a == std::lerp(a,b,0.0f)) << ' '
              << std::boolalpha << (b == std::lerp(a,b,1.0f)) << '\n';
}

输出：

a=10, b=20
mid point=15
true true

参阅

midpoint (C++20)

两个数值或指针间的中点 (函数模板)