WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::invalid_argument — Ausnahme für ungültige Argumente

std::invalid_argument aus <stdexcept> meldet ein ungültiges Argument. Der Typ enthält eine Diagnosemeldung, die über what() verfügbar ist, und gehört zur Ausnahmenhierarchie von std::logic_error.

Version: C++23; repository compiler flag, production runtime not attested

Syntax

#include <stdexcept>

// C++23 constructors:
explicit invalid_argument(const std::string& what_arg);
explicit invalid_argument(const char* what_arg);

throw std::invalid_argument("message");

std::invalid_argument ist ein Ausnahmetyp aus <stdexcept>, der ein ungültiges Argument melden soll. Er leitet sich öffentlich von std::logic_error und mittelbar von std::exception ab.

Seine Konstruktoren akzeptieren eine Meldung als const std::string& oder const char*. Die Methode what() stellt Text bereit, der bei einem Vergleich als C-String mit der übergebenen Meldung übereinstimmt. Das bloße Erzeugen eines Objekts löst es nicht als Ausnahme aus: Verwende throw, um es zu melden.

Im Beispiel weist require_name einen leeren Namen ausdrücklich zurück. Der catch-Block fängt die Ausnahme über const std::invalid_argument& ab und gibt die Meldung aus. Die Prüfung des Arguments und die Entscheidung, eine Ausnahme auszulösen, gehören zu dieser Funktion und werden nicht automatisch vom Ausnahmetyp bereitgestellt.

Dieser Eintrag bezieht sich auf C++23. Die angegebene Quelle ist ein fortgeschriebener Standardentwurf und zeigt auch constexpr-Konstruktoren; daraus folgt nicht, dass diese in C++23 als constexpr verfügbar sind. Das Beispiel benötigt diese Verwendung nicht. Ein Compiler-Flag bestätigt keine Unterstützung in einer Produktionslaufzeitumgebung.

Beispiele

#include <iostream>
#include <stdexcept>
#include <string>

void require_name(const std::string& name) {
    if (name.empty()) {
        throw std::invalid_argument("name must not be empty");
    }
}

int main() {
    try {
        require_name("");
    } catch (const std::invalid_argument& error) {
        std::cout << error.what() << '\n';
    }
}

Ergebnis

name must not be empty

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.

Quellen