CKTIS / C++
std::length_error — dépassement d’une longueur autorisée
std::length_error, déclaré dans <stdexcept>, signale une tentative de produire un objet dont la longueur dépasse la limite autorisée. Découvrez son héritage, ses constructeurs de message et la façon de le traiter au moyen d’une référence const.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <stdexcept>
// C++23 message constructor declarations inside class std::length_error:
// explicit length_error(const std::string& what_arg);
// explicit length_error(const char* what_arg);
throw std::length_error("length limit exceeded");
// Handle with: catch (const std::length_error& e)std::length_error, déclaré dans <stdexcept>, est un type d’exception qui signale une tentative de produire un objet dont la longueur dépasse la taille maximale autorisée. Il dérive publiquement de std::logic_error et indirectement de std::exception. Ne le confondez pas avec std::out_of_range, qui signale un argument situé en dehors de la plage attendue.
Ses constructeurs acceptent un message sous la forme const std::string& ou const char*. La méthode what() donne accès à ce message. Interceptez l’exception avec const std::length_error& ; si vous traitez aussi les classes de base, placez le gestionnaire le plus spécifique en premier.
L’exemple vérifie volontairement une limite personnalisée et exécute throw std::length_error au lieu de forcer une allocation énorme. Avec 9 > 8, il affiche le message fourni. Il illustre le déclenchement explicite d’une exception, et non une vérification automatique de la taille par la bibliothèque.
Cette entrée concerne C++23. La source fournie est un projet de norme évolutif et présente également des déclarations constexpr, qui ne doivent pas être considérées comme garanties en C++23. L’exemple n’a pas besoin de tels constructeurs.
Exemples
#include <cstddef>
#include <iostream>
#include <stdexcept>
void check_length(std::size_t requested) {
constexpr std::size_t limit = 8;
if (requested > limit) {
throw std::length_error("length limit exceeded");
}
}
int main() {
try {
check_length(9);
} catch (const std::length_error& e) {
std::cout << e.what() << '\n';
}
}
Résultat
length limit exceeded
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.