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.