CKTIS / C++
std::invalid_argument — изключение за невалиден аргумент
std::invalid_argument от <stdexcept> сигнализира за невалиден аргумент. То съдържа диагностично съобщение, достъпно чрез what(), и принадлежи към йерархията от изключения на std::logic_error.
Версия: C++23; repository compiler flag, production runtime not attested
Синтаксис
#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 е тип изключение от <stdexcept>, предназначен да сигнализира за невалиден аргумент. Той наследява публично std::logic_error и косвено std::exception.
Конструкторите му приемат съобщение като const std::string& или const char*. Методът what() предоставя текст, който при сравнение като C-низ съвпада с подаденото съобщение. Самото създаване на обект не го хвърля като изключение: използвайте throw, за да го сигнализирате.
В примера require_name изрично отхвърля празно име. Блокът catch прихваща изключението чрез const std::invalid_argument& и извежда съобщението. Проверката на аргумента и решението да се хвърли изключение са част от тази функция, а не автоматична проверка, осигурена от типа изключение.
Този запис се отнася за C++23. Посоченият източник е развиващ се проект на стандарта и показва и конструктори constexpr; това не доказва, че те са налични като constexpr в C++23. Примерът не изисква такава употреба. Флагът на компилатора не удостоверява поддръжка в производствена среда за изпълнение.
Примери
#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';
}
}
Резултат
name must not be empty
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.