typedef void igraph_error_handler_t(const char *reason, const char *file,
                                    int line, igraph_error_t igraph_errno);

这是错误处理函数的类型。

参数： 

IGRAPH_FUNCATTR_NORETURN igraph_error_handler_t igraph_error_handler_abort;

默认错误处理程序，打印错误消息并中止程序。

igraph_error_handler_t igraph_error_handler_ignore;

此错误处理程序释放临时分配的内存并返回错误代码。

igraph_error_handler_t igraph_error_handler_printignore;

释放临时分配的内存，向标准错误打印错误消息并返回错误代码。

typedef igraph_error_type_t igraph_error_t;

此类型用作返回错误代码的 igraph 函数的返回类型。它是一个类型别名，因为 igraph_error_t 曾经是一个 int，并且使用方式与 igraph_error_type_t 略有不同。

typedef enum {
    IGRAPH_SUCCESS           = 0,
    IGRAPH_FAILURE           = 1,
    IGRAPH_ENOMEM            = 2,
    IGRAPH_PARSEERROR        = 3,
    IGRAPH_EINVAL            = 4,
    IGRAPH_EXISTS            = 5,
    IGRAPH_EINVEVECTOR       = 6,
    IGRAPH_EINVVID           = 7,
    IGRAPH_NONSQUARE         = 8,
    IGRAPH_EINVMODE          = 9,
    IGRAPH_EFILE             = 10,
    IGRAPH_UNIMPLEMENTED     = 12,
    IGRAPH_INTERRUPTED       = 13,
    IGRAPH_DIVERGED          = 14,
    IGRAPH_ARPACK_PROD       = 15,   /* unused, reserved */
    IGRAPH_ARPACK_NPOS       = 16,
    IGRAPH_ARPACK_NEVNPOS    = 17,
    IGRAPH_ARPACK_NCVSMALL   = 18,
    IGRAPH_ARPACK_NONPOSI    = 19,
    IGRAPH_ARPACK_WHICHINV   = 20,
    IGRAPH_ARPACK_BMATINV    = 21,
    IGRAPH_ARPACK_WORKLSMALL = 22,
    IGRAPH_ARPACK_TRIDERR    = 23,
    IGRAPH_ARPACK_ZEROSTART  = 24,
    IGRAPH_ARPACK_MODEINV    = 25,
    IGRAPH_ARPACK_MODEBMAT   = 26,
    IGRAPH_ARPACK_ISHIFT     = 27,
    IGRAPH_ARPACK_NEVBE      = 28,
    IGRAPH_ARPACK_NOFACT     = 29,
    IGRAPH_ARPACK_FAILED     = 30,
    IGRAPH_ARPACK_HOWMNY     = 31,
    IGRAPH_ARPACK_HOWMNYS    = 32,
    IGRAPH_ARPACK_EVDIFF     = 33,
    IGRAPH_ARPACK_SHUR       = 34,
    IGRAPH_ARPACK_LAPACK     = 35,
    IGRAPH_ARPACK_UNKNOWN    = 36,
    IGRAPH_ENEGLOOP          = 37,
    IGRAPH_EINTERNAL         = 38,
    IGRAPH_ARPACK_MAXIT      = 39,
    IGRAPH_ARPACK_NOSHIFT    = 40,
    IGRAPH_ARPACK_REORDER    = 41,
    IGRAPH_EDIVZERO          = 42,
    IGRAPH_GLP_EBOUND        = 43,
    IGRAPH_GLP_EROOT         = 44,
    IGRAPH_GLP_ENOPFS        = 45,
    IGRAPH_GLP_ENODFS        = 46,
    IGRAPH_GLP_EFAIL         = 47,
    IGRAPH_GLP_EMIPGAP       = 48,
    IGRAPH_GLP_ETMLIM        = 49,
    IGRAPH_GLP_ESTOP         = 50,
    IGRAPH_EATTRIBUTES       = 51,
    IGRAPH_EATTRCOMBINE      = 52,
    IGRAPH_ELAPACK           = 53,
    IGRAPH_EDRL IGRAPH_DEPRECATED_ENUMVAL = 54,
    IGRAPH_EOVERFLOW         = 55,
    IGRAPH_EGLP              = 56,
    IGRAPH_CPUTIME           = 57,
    IGRAPH_EUNDERFLOW        = 58,
    IGRAPH_ERWSTUCK          = 59,
    IGRAPH_STOP              = 60,
    IGRAPH_ERANGE            = 61,
    IGRAPH_ENOSOL            = 62
} igraph_error_type_t;

这些是 igraph 函数可能返回的值。请注意，只有在您使用 igraph_set_error_handler() 定义了错误处理程序时，这些值才具有意义。否则，程序会中止，导致错误的函数永远不会返回。

值： 

const char *igraph_strerror(const igraph_error_t igraph_errno);

这是一个简单的实用函数，它给出了 igraph 错误代码的简短通用文本描述。

参数： 

返回值： 

typedef void igraph_warning_handler_t(const char *reason,
                                      const char *file, int line);

当前将其定义为与 igraph_error_handler_t 具有相同的类型，尽管未使用最后一个（错误代码）参数。

igraph_warning_handler_t *igraph_set_warning_handler(igraph_warning_handler_t *new_handler);

安装提供的警告处理程序函数。

参数： 

返回值： 

#define IGRAPH_WARNING(reason)

这是从 igraph 函数触发警告的常用方法。它调用 igraph_warning()。

参数： 

#define IGRAPH_WARNINGF(reason, ...)

igraph 函数可以在它们注意到警告并想要向用户传递有关出错原因的额外信息时使用此宏。它使用正确的参数和无错误代码调用 igraph_warningf()。

参数： 

void igraph_warning(const char *reason, const char *file, int line);

如果您想要从使用 igraph 的函数中触发警告，请调用此函数。

参数： 

返回值： 

void igraph_warningf(const char *reason, const char *file, int line, ...);

此函数类似于 igraph_warning()，但使用类似 printf 的语法。它将其他参数替换到 reason 模板字符串中，并调用 igraph_warning()。

参数： 

void igraph_warning_handler_ignore(const char *reason, const char *file, int line);

此警告处理程序函数仅忽略所有警告。

参数： 

void igraph_warning_handler_print(const char *reason, const char *file, int line);

此警告处理程序函数仅将所有警告打印到标准错误。

参数： 

本章其余部分的内容可能仅对那些想要从另一种语言创建 igraph 接口或从 GUI 应用程序中使用 igraph 的人有用。大多数读者可以安全地跳到下一章。

您可以通过定义 igraph_error_handler_t 类型的函数并调用 igraph_set_error_handler() 来编写和安装错误处理程序。此功能对于接口编写者很有用，因为 igraph 将有机会以适当的方式发出错误信号。例如，R 接口使用 R 的本机打印设施来传达错误，而 Python 接口将它们转换为 Python 异常。

错误处理程序的两个主要任务是报告错误（即打印错误消息）并确保正确的资源清理。这可以通过调用 IGRAPH_FINALLY_FREE() 来确保，该函数会释放一些临时内存以避免内存泄漏。请注意，这可能会使传递给错误处理程序的错误消息缓冲区 reason 无效。在调用 IGRAPH_FINALLY_FREE() 之后，请勿访问它。

从 igraph 0.10 开始，通过多次调用错误处理程序（并间接调用 IGRAPH_FINALLY_FREE()）分阶段释放临时内存。因此，预计不会立即中止程序的错误处理程序会返回。错误处理程序不应执行 longjmp，因为这可能导致某些内存无法释放。

igraph_error_handler_t *igraph_set_error_handler(igraph_error_handler_t *new_handler);

如果发生错误，库中的函数会使用错误的文本描述和 igraph 错误代码调用 IGRAPH_ERROR() 宏。此宏（通过 igraph_error() 函数）调用已安装的错误处理程序。另一个有用的宏是 IGRAPH_CHECK()。此宏检查其参数（通常是函数调用）的返回值，如果它不是 IGRAPH_SUCCESS，则调用 IGRAPH_ERROR()。

#define IGRAPH_ERROR(reason, igraph_errno)

#define IGRAPH_ERRORF(reason, igraph_errno, ...)

igraph_error_t igraph_error(const char *reason, const char *file, int line,
                            igraph_error_t igraph_errno);

igraph_error_t igraph_errorf(const char *reason, const char *file, int line,
                             igraph_error_t igraph_errno, ...);

#define IGRAPH_CHECK(expr)

 IGRAPH_CHECK(vector_push_back(&v, 100)); 

#define IGRAPH_CHECK_CALLBACK(expr, code)

如果函数遇到错误（且程序未中止），则错误处理程序应释放所有临时内存。这是通过将所有临时对象的地址和销毁函数存储在堆栈中来完成的。IGRAPH_FINALLY 函数通过将其地址放入堆栈中来声明一个对象为临时对象。如果 igraph 函数成功返回，它将调用 IGRAPH_FINALLY_CLEAN()，并指定要从堆栈中移除的对象数量。但是，如果发生错误，错误处理程序应调用 IGRAPH_FINALLY_FREE() 以释放添加到堆栈中的每个对象。这意味着在调用函数（等等）中分配的临时对象也将被释放。

#define IGRAPH_FINALLY(func, ptr)

IGRAPH_CHECK(igraph_vector_init(&vector, 0));
IGRAPH_FINALLY(igraph_vector_destroy, &vector);

IGRAPH_VECTOR_INIT_FINALLY(&vector, 0);

void IGRAPH_FINALLY_CLEAN(int num);

igraph_vector_t vector;
igraph_vector_init(&vector, 10);
IGRAPH_FINALLY(igraph_vector_destroy, &vector);
// use vector
igraph_vector_destroy(&vector);
IGRAPH_FINALLY_CLEAN(1);

void IGRAPH_FINALLY_FREE(void);

要使函数在错误情况下表现良好，需要遵循一些简单的规则。首先，检查函数的参数，如果它们无效，则调用 IGRAPH_ERROR()。其次，在每个动态分配的对象上调用 IGRAPH_FINALLY，并在返回之前使用适当的参数调用 IGRAPH_FINALLY_CLEAN()。第三，对所有可能生成错误的 igraph 函数调用使用 IGRAPH_CHECK。

用于此簿记的堆栈大小是固定的，而且很小。如果要分配多个对象，请编写一个可以释放所有这些对象的销毁函数。有关示例，请参见 igraph 源代码中的 adjlist.c 文件。

对于某些函数，这些机制根本不够灵活。这些函数应定义自己的错误处理程序，并在返回之前恢复错误处理程序。

#include <igraph.h>

/* Create the condensation of a directed graph.
 * See https://en.wikipedia.org/wiki/Strongly_connected_component#Definitions
 * This example demonstrates how to write a basic igraph function, complete
 * with error handling. */
igraph_error_t condensation(const igraph_t *graph, igraph_t *cond) {
    igraph_vector_int_t membership;

    /* Data structures such as vector must be initialized in igraph before use. */
    IGRAPH_CHECK(igraph_vector_int_init(&membership, 0));

    /* Adding the initialized vector to the "finally" stack ensures that it will
     * be automatically destroyed if an error occurs. */
    IGRAPH_FINALLY(igraph_vector_int_destroy, &membership);

    /* Functions that return an error code can be wrapped in IGRAPH_CHECK to pass that error
     * up to the caller. */
    IGRAPH_CHECK(igraph_connected_components(graph, &membership, /* csize */ NULL, /* no */ NULL, IGRAPH_STRONG));

    /* To compute the condensation, we simply contract strongly connected components.
     * Since igraph_contract_vertices() modifies graphs in-place, we make a copy first. */
    IGRAPH_CHECK(igraph_copy(cond, graph));

    /* Since we are not done creating the condensation yet, we add 'cond' to the
     * "finally" stack, so that it will be destroyed if an error occurs. */
    IGRAPH_FINALLY(igraph_destroy, cond);

    /* Contract strongly connected components. */
    IGRAPH_CHECK(igraph_contract_vertices(cond, &membership, NULL));

    /* igraph_contract_vertices() preserves all edges, some of which become
     * parallel edges or self-loops after the contraction. We simplify these. */
    IGRAPH_CHECK(igraph_simplify(cond, /* remove_multiple */ true, /* remove_loops */ true, NULL));

    /* Data structures that are no longer needed must be explicitly destroyed.
     * If they were added to the "finally" stack, they must be removed explicitly,
     * in the opposite order to how they were added. IGRAPH_FINALLY_CLEAN removes
     * the indicated number of entries from the "finally" stack. We remove
     * 'membership' because it was destroyed, and 'cond' because the responsibility
     * to destroy it is now with the caller. */
    igraph_vector_int_destroy(&membership);
    IGRAPH_FINALLY_CLEAN(2);

    return IGRAPH_SUCCESS; /* return with no error */
}

int main(void) {
    igraph_t graph, cond;

    /* Create a random directed graph with mean degree 2 and compute its condensation. */
    igraph_erdos_renyi_game_gnm(&graph, 100, 200, IGRAPH_DIRECTED, IGRAPH_NO_LOOPS);
    condensation(&graph, &cond);

    printf("Number of vertices in the condensation: %" IGRAPH_PRId "\n", igraph_vcount(&cond));
    igraph_write_graph_edgelist(&cond, stdout);

    /* Destroy data structures that are no longer needed. */
    igraph_destroy(&graph);
    igraph_destroy(&cond);

    return 0;
}

在某些极少数情况下，igraph 可能会遇到无法完全处理的内部错误。在这种情况下，它将调用当前的致命错误处理程序。默认的致命错误处理程序只是打印错误并中止程序。

致命错误处理程序不返回。通常，它们可能会立即中止程序，或者在高级 igraph 接口的情况下，它们可能会使用 longjmp() 返回到顶层。仅当发生严重错误时才调用致命错误处理程序，因此 igraph 可能处于不一致的状态。返回到顶层的目的是给用户一个保存工作的机会，而不是立即中止。但是，程序会话应尽快重新启动。

大多数使用 igraph 的项目都将使用默认的致命错误处理程序。

typedef void igraph_fatal_handler_t(const char *reason, const char *file, int line);

igraph_fatal_handler_t *igraph_set_fatal_handler(igraph_fatal_handler_t *new_handler);

IGRAPH_FUNCATTR_NORETURN igraph_fatal_handler_t igraph_fatal_handler_abort;

#define IGRAPH_FATAL(reason)

#define IGRAPH_FATALF(reason, ...)

#define IGRAPH_ASSERT(condition)

void igraph_fatal(const char *reason, const char *file, int line);

void igraph_fatalf(const char *reason, const char *file, int line, ...);

igraph 错误处理方法很可能不是线程安全的，主要是因为用于存储临时分配对象地址的静态全局堆栈。此问题可能会在 igraph 的更高版本中得到解决。