std:: throw_with_nested
| 
           
           Défini dans l'en-tête
            
         
            
             <exception>
            
           
           | 
         ||
| 
           
           
            
             template
            
            
             <
            
            
             class
            
            T
            
             >
            
             
         [ [ noreturn ] ] void throw_with_nested ( T && t ) ;  | 
         
          
           (depuis C++11)
          
           (constexpr depuis C++26)  | 
        |
       Si
       
        
         
          
           std::
           
            decay
           
          
         
         
          <
         
         T
         
          >
         
         
          ::
         
         
          type
         
        
       
       est un type de classe non-finale et non-union qui n'est ni
       
        
         std::nested_exception
        
       
       ni dérivé de
       
        
         std::nested_exception
        
       
       , lance une exception d'un type non spécifié qui est publiquement dérivé à la fois de
       
        
         std::nested_exception
        
       
       et de
       
        
         
          
           std::
           
            decay
           
          
         
         
          <
         
         T
         
          >
         
         
          ::
         
         
          type
         
        
       
       , et construite à partir de
       
        
         
          
           std::
           
            forward
           
          
         
         
          <
         
         T
         
          >
         
         
          (
         
         t
         
          )
         
        
       
       . Le constructeur par défaut de la classe de base
       
        nested_exception
       
       appelle
       
        
         std::current_exception
        
       
       , capturant l'objet d'exception actuellement géré, s'il existe, dans un
       
        
         std::exception_ptr
        
       
       .
      
Sinon, lance std:: forward < T > ( t ) .
Requiert que std:: decay < T > :: type soit CopyConstructible .
         Table des matières | 
       
Paramètres
| t | - | l'objet d'exception à lever | 
Notes
| Macro de test de fonctionnalité | Valeur | Std | Fonctionnalité | 
|---|---|---|---|
         
          
           __cpp_lib_constexpr_exceptions
          
         
         | 
        
         
          
           202411L
          
         
         | 
        (C++26) | constexpr pour les types d'exception | 
Exemple
Démontre la construction et la récursion à travers un objet exception imbriqué.
#include <exception> #include <fstream> #include <iostream> #include <stdexcept> #include <string> // prints the explanatory string of an exception. If the exception is nested, // recurses to print the explanatory string of the exception it holds void print_exception(const std::exception& e, int level = 0) { std::cerr << std::string(level, ' ') << "exception: " << e.what() << '\n'; try { std::rethrow_if_nested(e); } catch (const std::exception& nestedException) { print_exception(nestedException, level + 1); } catch (...) {} } // sample function that catches an exception and wraps it in a nested exception void open_file(const std::string& s) { try { std::ifstream file(s); file.exceptions(std::ios_base::failbit); } catch (...) { std::throw_with_nested(std::runtime_error("Couldn't open " + s)); } } // sample function that catches an exception and wraps it in a nested exception void run() { try { open_file("nonexistent.file"); } catch (...) { std::throw_with_nested(std::runtime_error("run() failed")); } } // runs the sample function above and prints the caught exception int main() { try { run(); } catch (const std::exception& e) { print_exception(e); } }
Sortie possible :
exception: run() failed exception: Couldn't open nonexistent.file exception: basic_ios::clear
Voir aussi
| 
          
           
            
             
              (C++11)
             
            
           
           
          | 
        
         un type mixin pour capturer et stocker les exceptions courantes
          (classe)  | 
       
| 
          
           
            
             
              (C++11)
             
            
           
           
          | 
        
         relance l'exception depuis un
         
          
           std::nested_exception
          
         
          (modèle de fonction)  |