CKTIS / C++
std::none_of — kein Element erfüllt eine Bedingung
std::none_of aus <algorithm> prüft, ob kein Element eines Bereichs ein Prädikat erfüllt. Das Ergebnis ist bool: true bedeutet, dass es keine Treffer gibt, false bedeutet, dass mindestens ein Treffer existiert. Für einen leeren Bereich lautet das Ergebnis true.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <algorithm>
std::none_of(first, last, pred)std::none_of(first, last, pred) untersucht den halboffenen Bereich [first, last): first ist enthalten, last nicht. Es gibt false zurück, wenn pred(*i) für mindestens ein Element wahr ist; andernfalls wird true zurückgegeben. Ein leerer Bereich ergibt true, weil er kein Element enthält, das die Bedingung erfüllt.
Binde <algorithm> ein und übergib einen gültigen Iteratorbereich sowie ein Prädikat, dessen Ergebnis als boolescher Wert geprüft werden kann. Die gewöhnliche Überladung erfordert Eingabe-Iteratoren. Der Algorithmus verändert die Elemente nicht; auch das Prädikat darf sie nicht über sein Argument verändern. Das Ergebnis ist ein bool, kein Iterator und keine Anzahl von Treffern.
Bei N Elementen wendet der Algorithmus das Prädikat höchstens N-mal an. Gehe nicht davon aus, dass das Prädikat für jedes Element aufgerufen wird. Es gibt auch eine Überladung mit Ausführungsrichtlinie, die Vorwärts-Iteratoren erfordert; das Beispiel verwendet die Überladung ohne Richtlinie.
Im Beispiel prüft is_negative, ob x < 0 gilt. Der erste Aufruf gibt true zurück, weil keine Zahl negativ ist. Der zweite gibt ebenfalls true zurück, weil values.begin(), values.begin() einen leeren Bereich festlegt. Die bereitgestellten Quellen sind ein sich weiterentwickelnder Standardentwurf; dieser Eintrag beschränkt sich auf die in C++23 verfügbare Schnittstelle.
Beispiele
#include <algorithm>
#include <array>
#include <iostream>
int main() {
const std::array<int, 4> values{2, 4, 6, 8};
const auto is_negative = [](int x) { return x < 0; };
std::cout << std::boolalpha
<< std::none_of(values.begin(), values.end(), is_negative) << '\n'
<< std::none_of(values.begin(), values.begin(), is_negative) << '\n';
}
Ergebnis
true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.