Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

std::invalid_argument — exception d’argument invalide

std::invalid_argument, défini dans <stdexcept>, signale un argument invalide. Il contient un message de diagnostic accessible via what() et appartient à la hiérarchie d’exceptions de std::logic_error.

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

Syntaxe

#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 est un type d’exception défini dans <stdexcept>, destiné à signaler un argument invalide. Il hérite publiquement de std::logic_error et, indirectement, de std::exception.

Ses constructeurs acceptent un message sous la forme const std::string& ou const char*. La méthode what() fournit un texte qui correspond au message transmis lors d’une comparaison de chaînes C. Le simple fait de créer un objet ne le déclenche pas comme exception : utilisez throw pour le signaler.

Dans l’exemple, require_name rejette explicitement un nom vide. Le bloc catch intercepte l’exception via const std::invalid_argument&, puis affiche le message. La vérification de l’argument et la décision de déclencher une exception relèvent de cette fonction ; elles ne sont pas assurées automatiquement par le type d’exception.

Cette entrée concerne C++23. La source fournie est un projet de norme en évolution et présente également des constructeurs constexpr ; cela ne signifie pas qu’ils soient disponibles comme constexpr en C++23. L’exemple n’a pas besoin de cette utilisation. Une option du compilateur ne garantit pas la prise en charge par un environnement d’exécution de production.

Exemples

#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';
    }
}

Résultat

name must not be empty

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources