Namensräume
Varianten
Aktionen

std::bit_floor

Von cppreference.com
< cpp‎ | numeric
 
 
Dienstprogramm-Bibliotheken
Sprachunterstützung
Typunterstützung (Basistypen, RTTI)
Bibliotheks-Feature-Test-Makros (C++20)
Programm-Dienstprogramme
Variadische Funktionen
Coroutine-Unterstützung (C++20)
Vertragsunterstützung (C++26)
Drei-Wege-Vergleich
(C++20)
(C++20)(C++20)(C++20)  
(C++20)(C++20)(C++20)

Allgemeine Hilfsmittel
Relationale Operatoren (in C++20 veraltet)
 
Bitmanipulation
(C++20)
(C++23)
Ganzzahlige Zweierpotenzen
(C++20)
bit_floor
(C++20)
(C++20)
Rotation
(C++20)
(C++20)
Zählen
(C++20)
(C++20)
(C++20)
Endianheit
(C++20)
 
Definiert in Header <bit>
template< class T >
constexpr T bit_floor( T x ) noexcept;
(seit C++20)

Wenn x nicht Null ist, wird die größte Potenz von zwei berechnet, die nicht größer als x ist. Wenn x Null ist, wird Null zurückgegeben.

Diese Überladung nimmt an der Überladungsauflösung teil, nur wenn T ein vorzeichenloser Ganzzahltyp ist (d.h. unsigned char, unsigned short, unsigned int, unsigned long, unsigned long long oder ein erweiterter vorzeichenloser Ganzzahltyp).

Inhalt

[bearbeiten] Parameter

x - Vorzeichenloser ganzzahliger Wert

[bearbeiten] Rückgabewert

Null, wenn x Null ist; andernfalls die größte Potenz von zwei, die nicht größer als x ist.

[bearbeiten] Hinweise

Vor P1956R1 war der vorgeschlagene Name für diese Funktionsvorlage floor2.

Feature-Test-Makro Wert Std Feature
__cpp_lib_int_pow2 202002L (C++20) Operationen mit Zweierpotenzen

[bearbeiten] Mögliche Implementierung

template<std::unsigned_integral T>
    requires !std::same_as<T, bool> && !std::same_as<T, char> &&
             !std::same_as<T, char8_t> && !std::same_as<T, char16_t> &&
             !std::same_as<T, char32_t> && !std::same_as<T, wchar_t>
constexpr T bit_floor(T x) noexcept
{
    if (x != 0)
        return T{1} << (std::bit_width(x) - 1);
    return 0;
}

[bearbeiten] Beispiel

#include <bit>
#include <bitset>
#include <iostream>
 
int main()
{
    using bin = std::bitset<8>;
    for (unsigned x{}; x != 012; ++x)
        std::cout << "bit_floor( " << bin(x) << " ) = "
                  << bin(std::bit_floor(x)) << '\n';
}

Ausgabe

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

[bearbeiten] Siehe auch

(C++20)
findet die kleinste ganzzahlige Zweierpotenz, die nicht kleiner als der gegebene Wert ist
(Funktion-Template) [bearbeiten]
(C++20)
berechnet das Ergebnis einer bitweisen Rechtsrotation
(Funktion-Template) [bearbeiten]
(C++20)
findet die kleinste Anzahl von Bits, die benötigt wird, um den gegebenen Wert darzustellen
(Funktion-Template) [bearbeiten]
prüft, ob eine Zahl eine ganzzahlige Zweierpotenz ist
(Funktion-Template) [bearbeiten]