c/include/proton/error.h

#ifndef PROTON_ERROR_H
#define PROTON_ERROR_H 1

/*
 *
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 *
 */

#include <proton/import_export.h>
#include <stdarg.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * @file
 *
 * @copybrief error
 *
 * @addtogroup error
 * @{
 */

/**
 * An int error `code` and some string `text` to describe the error.
 */
typedef struct pn_error_t pn_error_t;

#define PN_OK (0)              /**< No error */
#define PN_EOS (-1)            /**< End of stream */
#define PN_ERR (-2)            /**< General error */
#define PN_OVERFLOW (-3)       /**< Overflow error */
#define PN_UNDERFLOW (-4)      /**< Underflow error */
#define PN_STATE_ERR (-5)      /**< State error */
#define PN_ARG_ERR (-6)        /**< Argument error */
#define PN_TIMEOUT (-7)        /**< Timeout */
#define PN_INTR (-8)           /**< Interrupt */
#define PN_INPROGRESS (-9)     /**< In-progress */
#define PN_OUT_OF_MEMORY (-10) /**< Out-of-memory error */
#define PN_ABORTED (-11)       /**< Delivery aborted error */

/**
 * Get the name of the error code. Returned pointer is to a static
 * constant, do not delete.
 */
PN_EXTERN const char *pn_code(int code);

/**
 * Create an error object.
 */
PN_EXTERN pn_error_t *pn_error(void);

/**
 * Free an error object.
 */
PN_EXTERN void pn_error_free(pn_error_t *error);

/**
 * Reset the error to a "no error" state with code == 0.
 */
PN_EXTERN void pn_error_clear(pn_error_t *error);

/**
 * Set the error code and text. Makes a copy of text.
 */
PN_EXTERN int pn_error_set(pn_error_t *error, int code, const char *text);

/**
 * Set the code and set the text using a printf-style formatted
 * string.
 */
PN_EXTERN int pn_error_vformat(pn_error_t *error, int code, const char *fmt, va_list ap);

/**
 * Set the code and set the text using a printf-style formatted
 * string.
 */
PN_EXTERN int pn_error_format(pn_error_t *error, int code, const char *fmt, ...);

/**
 * Get the the error code.
 */
PN_EXTERN int pn_error_code(pn_error_t *error);

/**
 * Get the error text.  The returned pointer is owned by the
 * pn_error_t.
 */
PN_EXTERN const char *pn_error_text(pn_error_t *error);

/**
 * Copy the src error.
 */
PN_EXTERN int pn_error_copy(pn_error_t *error, pn_error_t *src);

/**
 * @cond INTERNAL
 */
#define PN_RETURN_IF_ERROR(x) \
do {\
int r = (x);\
if (r < 0) return r; \
} while (0)
/**
 * @endcond
 */

/**
 * @}
 */

#ifdef __cplusplus
}
#endif

#endif /* error.h */