std::is_partitioned
| Definiert in Header <algorithm>
|
||
template< class InputIt, class UnaryPred >
bool is_partitioned( InputIt first, InputIt last, UnaryPred p );
|
(1) | (seit C++11) (constexpr seit C++20) |
template< class ExecutionPolicy, class ForwardIt, class UnaryPred >
bool is_partitioned( ExecutionPolicy&& policy,
ForwardIt first, ForwardIt last, UnaryPred p );
|
(2) | (seit C++17) |
[first, last) durch das Prädikat p partitioniert ist: alle Elemente, die p erfüllen, erscheinen vor allen Elementen, die es nicht erfüllen.policy.true ist:
|
|
(bis C++20) |
|
|
(seit C++20) |
Parameter
| first, last | - | das Paar von Iteratoren, das den Bereich der zu untersuchenden Elemente definiert |
| policy | - | die zu verwendende Ausführungsrichtlinie |
| p | - |
unäres Prädikat, das
true
für die Elemente zurückgibt, die am Anfang des Bereichs erwartet werden.
Der Ausdruck
p
(
v
)
muss für jedes Argument
|
| Typanforderungen | ||
-
InputIt
muss die Anforderungen von
LegacyInputIterator
erfüllen.
|
||
-
ForwardIt
muss die Anforderungen von
LegacyForwardIterator
erfüllen und sein Werttyp muss in den Parametertyp von
UnaryPred
konvertierbar sein.
|
||
-
UnaryPred
muss die Anforderungen von
Predicate
erfüllen.
|
||
Rückgabewert
true
falls die Elemente
e
im Bereich
[
first
,
last
)
bezüglich des Ausdrucks
p
(
e
)
partitioniert
sind.
false
andernfalls.
Komplexität
Höchstens std:: distance ( first, last ) Anwendungen von p .
Ausnahmen
Die Überladung mit einem Template-Parameter namens
ExecutionPolicy
meldet Fehler wie folgt:
-
Wenn die Ausführung einer als Teil des Algorithmus aufgerufenen Funktion eine Exception wirft und
ExecutionPolicyeiner der Standard-Policies ist, wird std::terminate aufgerufen. Für jede andereExecutionPolicyist das Verhalten implementierungsdefiniert. - Wenn der Algorithmus keinen Speicher allozieren kann, wird std::bad_alloc geworfen.
Mögliche Implementierung
template<class InputIt, class UnaryPred> bool is_partitioned(InputIt first, InputIt last, UnaryPred p) { for (; first != last; ++first) if (!p(*first)) break; for (; first != last; ++first) if (p(*first)) return false; return true; } |
Beispiel
#include <algorithm> #include <array> #include <iostream> int main() { std::array<int, 9> v {1, 2, 3, 4, 5, 6, 7, 8, 9}; auto is_even = [](int i) { return i % 2 == 0; }; std::cout.setf(std::ios_base::boolalpha); std::cout << std::is_partitioned(v.begin(), v.end(), is_even) << ' '; std::partition(v.begin(), v.end(), is_even); std::cout << std::is_partitioned(v.begin(), v.end(), is_even) << ' '; std::reverse(v.begin(), v.end()); std::cout << std::is_partitioned(v.cbegin(), v.cend(), is_even) << ' '; std::cout << std::is_partitioned(v.crbegin(), v.crend(), is_even) << '\n'; }
Ausgabe:
false true false true
Siehe auch
| teilt einen Bereich von Elementen in zwei Gruppen (Funktionsschablone & Algorithmus-Funktionsobjekt) | |
(C++20) |
|
(C++11) |
ermittelt den Partitionierungspunkt eines partitionierten Bereichs (Funktionsschablone & Algorithmus-Funktionsobjekt) |
(C++20) |
|
(C++20) |
bestimmt, ob der Bereich durch das vorgegebene Prädikat partitioniert ist (Algorithmus-Funktionsobjekt) |