Namensräume
Varianten
Aktionen

std::is_placeholder

Von cppreference.com
< cpp‎ | utility‎ | functional
 
 
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)
 
Funktionsobjekte
Partielle Funktionsanwendung
(C++20)(C++23)
(C++11)
is_placeholder
(C++11)
Funktionsaufruf
(C++17)(C++23)
Identitätsfunktions-Objekt
(C++20)
Transparente Operator-Wrapper
(C++14)
(C++14)
(C++14)
(C++14)  
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)

Alte Binder und Adaptoren
(bis C++17*)
(bis C++17*)
(bis C++17*)
(bis C++17*)
(bis C++17*)(bis C++17*)(bis C++17*)(bis C++17*)
(bis C++20*)
(bis C++20*)
(bis C++17*)(bis C++17*)
(bis C++17*)(bis C++17*)

(bis C++17*)
(bis C++17*)(bis C++17*)(bis C++17*)(bis C++17*)
(bis C++20*)
(bis C++20*)
 
Definiert in der Header-Datei <functional>
template< class T >
struct is_placeholder;
(seit C++11)

Wenn T der Typ eines Standard-Platzhalters (_1, _2, _3, ...) ist, dann leitet sich diese Vorlage von std::integral_constant<int, 1>, std::integral_constant<int, 2>, std::integral_constant<int, 3>, beziehungsweise ab.

Wenn T kein Standard-Platzhaltertyp ist, dann leitet sich diese Vorlage von std::integral_constant<int, 0> ab.

Ein Programm kann diese Vorlage für einen programdefinierten Typ T spezialisieren, um UnaryTypeTrait mit der Basiseigenschaft von std::integral_constant<int, N> mit einem positiven N zu implementieren, um anzuzeigen, dass T als der N-te Platzhaltertyp behandelt werden soll.

std::bind verwendet std::is_placeholder, um Platzhalter für ungebundene Argumente zu erkennen.

Inhalt

[edit] Hilfsvariablen-Vorlage

template< class T >
constexpr int is_placeholder_v = is_placeholder<T>::value;
(seit C++17)

Abgeleitet von std::integral_constant

Member-Konstanten

value
[static]
Platzhalterwert oder 0 für Nicht-Platzhaltertypen
(öffentliche statische Member-Konstante)

Memberfunktionen

operator int
konvertiert das Objekt zu int, gibt value zurück
(öffentliche Memberfunktion)
operator()
(C++14)
gibt value zurück
(öffentliche Memberfunktion)

Membertypen

Typ Definition
value_type int
type std::integral_constant<int, value>

[edit] Beispiel

#include <functional>
#include <iostream>
#include <type_traits>
 
struct My_2 {} my_2;
 
namespace std
{
    template<>
    struct is_placeholder<My_2> : public integral_constant<int, 2> {};
}
 
int f(int n1, int n2)
{
    return n1 + n2;
}
 
int main()
{
    std::cout << "Standard placeholder _5 is for the argument number "
              << std::is_placeholder_v<decltype(std::placeholders::_5)>
              << '\n';
 
    auto b = std::bind(f, my_2, 2);
    std::cout << "Adding 2 to 11 selected with a custom placeholder gives " 
              << b(10, 11) // the first argument, namely 10, is ignored
              << '\n';
}

Ausgabe

Standard placeholder _5 is for the argument number 5
Adding 2 to 11 selected with a custom placeholder gives 13

[edit] Siehe auch

(C++11)
bindet ein oder mehrere Argumente an ein Funktions-Objekt
(Funktions-Template) [bearbeiten]
Platzhalter für die ungebundenen Argumente in einem std::bind-Ausdruck
(Konstante) [bearbeiten]