CP2K Open Source Molecular Dynamics

User Tools

Site Tools

Trace: • hint_insufficiently_exploiting_cpu_extensions • md • ex01 • h2o_md • compile_on_windows • error_handling • compile_on_macos • index
dev:error_handling

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
dev:error_handling [2015/09/28 14:09] – oschuettdev:error_handling [2025/03/08 13:41] (current) – oschuett
Line 1: Line 1:
 ====== Error Handling ====== ====== Error Handling ======
  
-In CP2K there exist three convenient macros for error handling. They are defined in [[src>cp2k/src/common/cp_common_uses.f90]], and are therefore always available. However, these macros can only be used for **short messages**, because of Fortran's line length limitation.+In CP2K there exist three convenient macros for error handling. They are defined in [[src>src/base/base_uses.f90]], and are therefore always available. However, these macros can only be used for **short messages** (approximately less than 7 words), because of Fortran's line length limitation.
 <code Fortran> <code Fortran>
    CPWARN("A short warning message")    CPWARN("A short warning message")
    CPABORT("A short error message")    CPABORT("A short error message")
-   CPASSERT(2>1) ! For sanity checks only, not for user errors.+   CPASSERT(2 > 1) ! For sanity checks only, not for user errors.
 </code> </code>
  
 For longer messages one can use these two routines: For longer messages one can use these two routines:
 <code Fortran> <code Fortran>
-   CALL cp_warn(__SHORT_FILE__,__LINE__,"A long warning message "\\& +   CALL cp_warn(__LOCATION__,"A long warning message "//& 
-                "which can span multiple lines and contains "\\&+                "which can span multiple lines and contains "//&
                 "some valuable advice for the user.")                 "some valuable advice for the user.")
  
-   CALL cp_abort(__SHORT_FILE__,__LINE__,"A long error message "\\& +   CALL cp_abort(__LOCATION__,"A long error message "//& 
-                 "with even more valuable advises.")      +                 "with even more valuable advice.")      
 </code> </code>
  
 +<note important>
 +Messages from ''CPWARN'' and ''cp_warn'' are only printed on the first MPI-rank.\\ Warnings issued on other ranks are ignored.
 +</note>
  
 ===== Cheat Sheet ===== ===== Cheat Sheet =====
 If you want to... If you want to...
   * print a **short warning** message, then you should use:<code Fortran> CPWARN("your short message")</code>   * print a **short warning** message, then you should use:<code Fortran> CPWARN("your short message")</code>
-  * print a **longer warning** message, then you should use:<code Fortran> CALL cp_warn(__SHORT_FILE__,__LINE__,"you lengthy message, "//&+  * print a **longer warning** message, then you should use:<code Fortran> CALL cp_warn(__LOCATION__,"your lengthy message, "//&
               "which can even span multiple lines")</code>               "which can even span multiple lines")</code>
  
   * **stop** the program with a **short** error message, then you should use:<code Fortran> CPABORT("your short message")</code>   * **stop** the program with a **short** error message, then you should use:<code Fortran> CPABORT("your short message")</code>
-  * **stop** the program with a **longer** error message, then you should use:<code Fortran> CALL cp_abort(__SHORT_FILE__,__LINE__,"you lengthy message, "//&+  * **stop** the program with a **longer** error message, then you should use:<code Fortran> CALL cp_abort(__LOCATION__,"your lengthy message, "//&
                "which can even span multiple lines")</code>                "which can even span multiple lines")</code>
-  * have a **simple assertion** without a custom error message, then you should use:<code Fortran> CPASSERT(you_logical_expression)</code> +  * have a **simple assertion** without a custom error message, then you should use:<code Fortran> CPASSERT(your_logical_expression)</code> 
-  * have a **simple assertion** with a **short** error message, then you should use:<code Fortran> IF(.NOT.you_logical_expression) CPABORT("your short message")</code>+  * have a **simple assertion** with a **short** error message, then you should use:<code Fortran> IF(.NOT.your_logical_expression) CPABORT("your short message")</code>
   * have a **complex assertion** with a **short** error message, then you should use:<code Fortran> IF(.NOT.your_super_complicated_logical_expression_that_takes_alot_of_space)&   * have a **complex assertion** with a **short** error message, then you should use:<code Fortran> IF(.NOT.your_super_complicated_logical_expression_that_takes_alot_of_space)&
     CPABORT("your short message")</code>     CPABORT("your short message")</code>
   * have a **lengthy assertion** with a **longer** error message, then you should use:<code Fortran> IF(.NOT.your_super_long_logical_expression_that_takes_alot_of_space)&   * have a **lengthy assertion** with a **longer** error message, then you should use:<code Fortran> IF(.NOT.your_super_long_logical_expression_that_takes_alot_of_space)&
-    CALL cp_abort(__SHORT_FILE__,__LINE__,"you lengthy message"//&+    CALL cp_abort(__LOCATION__,"your lengthy message"//&
                   "which again can even span multiple lines")</code>                   "which again can even span multiple lines")</code>
  
dev/error_handling.1443449393.txt.gz · Last modified: (external edit)