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, |
(2) | (seit C++17) |
[first, last) durch das Prädikat p partitioniert sind: Alle Elemente, die p erfüllen, erscheinen vor allen Elementen, die p nicht erfüllen.|
std::is_execution_policy_v<std::decay_t<ExecutionPolicy>> ist true. |
(bis C++20) |
|
std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>> ist true. |
(seit C++20) |
Inhalt |
[edit] Parameter
| first, last | - | das Iteratorenpaar, das den Bereich der zu untersuchenden Elemente definiert |
| policy | - | die Ausführungsrichtlinie, die verwendet werden soll |
| p | - | unäres Prädikat, das für die Elemente, die am Anfang des Bereichs erwartet werden, true zurückgibt. 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. | ||
[edit] Rückgabewert
true, wenn die Elemente e von [first, last) bezüglich des Ausdrucks p(e) partitioniert sind. false andernfalls.
[edit] Komplexität
Höchstens std::distance(first, last) Anwendungen von p.
[edit] Ausnahmen
Die Überladung mit einem Template-Parameter namens ExecutionPolicy meldet Fehler wie folgt
- Wenn die Ausführung einer Funktion, die als Teil des Algorithmus aufgerufen wird, eine Ausnahme auslöst und
ExecutionPolicyeine der Standardrichtlinien ist, wird std::terminate aufgerufen. Für jede andereExecutionPolicyist das Verhalten implementierungsabhängig. - Wenn dem Algorithmus der Speicher zur Neuzuweisung fehlt, wird std::bad_alloc ausgelöst.
[edit] 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; } |
[edit] 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
[edit] Siehe auch
| Teilt einen Bereich von Elementen in zwei Gruppen auf (Funktionstemplate) | |
| (C++11) |
Findet den Partitionierungspunkt eines partitionierten Bereichs (Funktionstemplate) |
| (C++20) |
Stellt fest, ob der Bereich durch das gegebene Prädikat partitioniert ist (Algorithmus-Funktionsobjekt) |