Line data    Source code

       1             : /******************************************************************************************************
       2             : 
       3             :    (C) 2022-2025 IVAS codec Public Collaboration with portions copyright Dolby International AB, Ericsson AB,
       4             :    Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V., Huawei Technologies Co. LTD.,
       5             :    Koninklijke Philips N.V., Nippon Telegraph and Telephone Corporation, Nokia Technologies Oy, Orange,
       6             :    Panasonic Holdings Corporation, Qualcomm Technologies, Inc., VoiceAge Corporation, and other
       7             :    contributors to this repository. All Rights Reserved.
       8             : 
       9             :    This software is protected by copyright law and by international treaties.
      10             :    The IVAS codec Public Collaboration consisting of Dolby International AB, Ericsson AB,
      11             :    Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V., Huawei Technologies Co. LTD.,
      12             :    Koninklijke Philips N.V., Nippon Telegraph and Telephone Corporation, Nokia Technologies Oy, Orange,
      13             :    Panasonic Holdings Corporation, Qualcomm Technologies, Inc., VoiceAge Corporation, and other
      14             :    contributors to this repository retain full ownership rights in their respective contributions in
      15             :    the software. This notice grants no license of any kind, including but not limited to patent
      16             :    license, nor is any license granted by implication, estoppel or otherwise.
      17             : 
      18             :    Contributors are required to enter into the IVAS codec Public Collaboration agreement before making
      19             :    contributions.
      20             : 
      21             :    This software is provided "AS IS", without any express or implied warranties. The software is in the
      22             :    development stage. It is intended exclusively for experts who have experience with such software and
      23             :    solely for the purpose of inspection. All implied warranties of non-infringement, merchantability
      24             :    and fitness for a particular purpose are hereby disclaimed and excluded.
      25             : 
      26             :    Any dispute, controversy or claim arising under or in relation to providing this software shall be
      27             :    submitted to and settled by the final, binding jurisdiction of the courts of Munich, Germany in
      28             :    accordance with the laws of the Federal Republic of Germany excluding its conflict of law rules and
      29             :    the United Nations Convention on Contracts on the International Sales of Goods.
      30             : 
      31             : *******************************************************************************************************/
      32             : 
      33             : #include "options.h"
      34             : 
      35             : #include <assert.h>
      36             : #include <stdarg.h>
      37             : #include <stdint.h>
      38             : 
      39             : #include "ivas_error.h"
      40             : 
      41             : 
      42             : #ifndef IVAS_ERROR_UTILS_H
      43             : #define IVAS_ERROR_UTILS_H
      44             : 
      45             : /*
      46             :  * Usage:
      47             :  *
      48             :  *  IVAS_ERROR( error_code, decription_fmt, ... );
      49             :  *
      50             :  * where:
      51             :  *      - error_code is of type enum ivas_error
      52             :  *      - decription_fmt is a description string with printf-like formatting
      53             :  *      - ... are (optional) printf-like arguments to place in the description format string
      54             :  *
      55             :  * Examples:
      56             :  *
      57             :  *  IVAS_ERROR( IVAS_ERR_FAILED_ALLOC, "Cannot allocate memory for XXX" );
      58             :  *
      59             :  *  IVAS_ERROR( IVAS_ERR_INTERNAL, "Unexpected value %f in frame %d", var, frame );
      60             :  *
      61             :  * Note: Contrary to printf, this macro is not able to verify at build time that the
      62             :  * placeholders (e.g. "%f") in the format string match the types of provided arguments.
      63             :  * If unexpected values are printed or the macro causes a crash, double check that the
      64             :  * format specifiers are correct.
      65             :  */
      66             : #define IVAS_ERROR( error_code, ... ) ivas_error_wrapper( error_code )
      67             : 
      68      132012 : static inline ivas_error ivas_error_wrapper( const ivas_error error_code )
      69             : {
      70      132012 :     return error_code;
      71             : }
      72             : 
      73             : #endif /* IVAS_ERROR_UTILS_H */