Namespaces
Variants

std:: bit_ceil

From cppreference.net
C++
Utilities library
Bit manipulation
Défini dans l'en-tête <bit>
template < class T >
constexpr T bit_ceil ( T x ) ;
(depuis C++20)

Calcule la plus petite puissance entière de deux qui n'est pas inférieure à x .

Si cette valeur n'est pas représentable dans T , le comportement est indéfini. L'appel à cette fonction est autorisé lors de l' évaluation constante uniquement si le comportement indéfini ne se produit pas.

Cette surcharge participe à la résolution de surcharge uniquement si T est un type entier non signé (c'est-à-dire, unsigned char , unsigned short , unsigned int , unsigned long , unsigned long long , ou un type entier non signé étendu).

Table des matières

Paramètres

x - valeur de type entier non signé

Valeur de retour

La plus petite puissance entière de deux qui n'est pas inférieure à x .

Exceptions

Ne lance rien.

Notes

Avant P1956R1 , le nom proposé pour ce modèle de fonction était ceil2 .

Macro de test de fonctionnalité Valeur Std Fonctionnalité
__cpp_lib_int_pow2 202002L (C++20) Opérations de puissance de 2 entières

Implémentation possible

Voir les implémentations possibles dans libstdc++ (gcc) et libc++ (clang) . 

template<typename T, typename ... U>
concept neither = (!std::same_as<T, U> && ...);
template<std::unsigned_integral T>
    requires neither<T, bool, char, char8_t, char16_t, char32_t, wchar_t>
constexpr T bit_ceil(T x) noexcept
{
    if (x <= 1u)
        return T(1);
    if constexpr (std::same_as<T, decltype(+x)>)
        return T(1) << std::bit_width(T(x - 1));
    else
    {   // pour les types sujets à la promotion entière
        constexpr int offset_for_ub =
            std::numeric_limits<unsigned>::digits - std::numeric_limits<T>::digits;
        return T(1u << (std::bit_width(T(x - 1)) + offset_for_ub) >> offset_for_ub);
    }
}
Seul le commentaire "for types subject to integral promotion" a été traduit en "pour les types sujets à la promotion entière", conformément aux instructions de conservation des balises HTML, du code C++ et des termes spécifiques au C++.

Exemple

Exécuter ce code 
#include <bit>
#include <bitset>
#include <iostream>
int main()
{
    using bin = std::bitset<8>;
    for (auto x{0U}; 0XA != x; ++x)
        std::cout << "bit_ceil( " << bin(x) << " ) = "
                  << bin(std::bit_ceil(x)) << '\n';
}

Sortie : 

bit_ceil( 00000000 ) = 00000001
bit_ceil( 00000001 ) = 00000001
bit_ceil( 00000010 ) = 00000010
bit_ceil( 00000011 ) = 00000100
bit_ceil( 00000100 ) = 00000100
bit_ceil( 00000101 ) = 00001000
bit_ceil( 00000110 ) = 00001000
bit_ceil( 00000111 ) = 00001000
bit_ceil( 00001000 ) = 00001000
bit_ceil( 00001001 ) = 00010000

Voir aussi

(C++20)
trouve la plus grande puissance entière de 2 inférieure ou égale à la valeur donnée
(modèle de fonction)