Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::experimental::clamp

The result of element-wise application of std::clamp(v[i], lo[i], hi[i]) for all i ∈ [ 0 , size()).

NotebookLM
Defined in header <experimental/simd>
template< class T, class Abi >
simd<T, Abi>
clamp( const simd<T, Abi>& v, const simd<T, Abi>& lo, const simd<T, Abi>& hi );
(parallelism TS v2)

Parameters

v - the elements to clamp
lo, hi - the boundaries to clamp v to

Return value

The result of element-wise application of std::clamp(v[i], lo[i], hi[i]) for all i ∈ [​0​, size()).

Example

example.cpp
#include <cstddef>
#include <cstdint>
#include <experimental/simd>
#include <iomanip>
#include <iostream>
namespace stdx = std::experimental;
 
void println(auto rem, auto const v)
{
    std::cout << rem << ": ";
    for (std::size_t i = 0; i != v.size(); ++i)
        std::cout << std::setw(4) << v[i] << ' ';
    std::cout << '\n';
}
 
int main()
{
    stdx::fixed_size_simd<int, 8> a{[](int i) {
        static constexpr auto c = {-129, -128, -1, 0, 42, 127, 128, 255};
        return c.begin()[i];
    }};
    println("a", a);
 
    stdx::fixed_size_simd<int, 8> lo1{INT8_MIN};
    stdx::fixed_size_simd<int, 8> hi1{INT8_MAX};
    const auto b = stdx::clamp(a, lo1, hi1);
    println("b", b);
 
    stdx::fixed_size_simd<int, 8> lo2{0};
    stdx::fixed_size_simd<int, 8> hi2{UINT8_MAX};
    const auto c = stdx::clamp(a, lo2, hi2);
    println("c", c);
}
Output
a: -129 -128   -1    0   42  127  128  255 
b: -128 -128   -1    0   42  127  127  127 
c:    0    0    0    0   42  127  128  255

See also

(C++17)
clamps a value between a pair of boundary values
(function template)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.