proton-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

/** A pn_error_t has an int error `code` and some string `text` to describe the error */
typedef struct pn_error_t pn_error_t;

#define PN_OK (0)
#define PN_EOS (-1)
#define PN_ERR (-2)
#define PN_OVERFLOW (-3)
#define PN_UNDERFLOW (-4)
#define PN_STATE_ERR (-5)
#define PN_ARG_ERR (-6)
#define PN_TIMEOUT (-7)
#define PN_INTR (-8)
#define PN_INPROGRESS (-9)
#define PN_OUT_OF_MEMORY (-10)

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

PN_EXTERN pn_error_t *pn_error(void);
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, ...);

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

/** @return the error text.  Returned pointer is owned by the pn_error_t. */
PN_EXTERN const char *pn_error_text(pn_error_t *error);

PN_EXTERN int pn_error_copy(pn_error_t *error, pn_error_t *src);

#define PN_RETURN_IF_ERROR(x) \
do {\
int r = (x);\
if (r < 0) return r; \
} while (0)

#ifdef __cplusplus
}
#endif

#endif /* error.h */