diff options
| author | Baitinq <[email protected]> | 2025-03-04 00:55:34 +0100 |
|---|---|---|
| committer | Baitinq <[email protected]> | 2025-03-04 01:08:28 +0100 |
| commit | d55372bfbf798416ad55a854581bf9bfa4af9ba6 (patch) | |
| tree | ad3fbf5b725b7018f74bef8a74dab72d51c6852f /llvm-c/Error.h | |
| parent | Codegen: Initialize all llvm targets (diff) | |
| download | pry-lang-d55372bfbf798416ad55a854581bf9bfa4af9ba6.tar.gz pry-lang-d55372bfbf798416ad55a854581bf9bfa4af9ba6.tar.bz2 pry-lang-d55372bfbf798416ad55a854581bf9bfa4af9ba6.zip | |
Codegen: add bundled llvm
Diffstat (limited to 'llvm-c/Error.h')
| -rw-r--r-- | llvm-c/Error.h | 91 |
1 files changed, 91 insertions, 0 deletions
diff --git a/llvm-c/Error.h b/llvm-c/Error.h new file mode 100644 index 0000000..874bbcf --- /dev/null +++ b/llvm-c/Error.h @@ -0,0 +1,91 @@ +/*===------- llvm-c/Error.h - llvm::Error class C Interface -------*- C -*-===*\ +|* *| +|* Part of the LLVM Project, under the Apache License v2.0 with LLVM *| +|* Exceptions. *| +|* See https://llvm.org/LICENSE.txt for license information. *| +|* SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception *| +|* *| +|*===----------------------------------------------------------------------===*| +|* *| +|* This file defines the C interface to LLVM's Error class. *| +|* *| +\*===----------------------------------------------------------------------===*/ + +#ifndef LLVM_C_ERROR_H +#define LLVM_C_ERROR_H + +#include "llvm-c/ExternC.h" + +LLVM_C_EXTERN_C_BEGIN + +/** + * @defgroup LLVMCError Error Handling + * @ingroup LLVMC + * + * @{ + */ + +#define LLVMErrorSuccess 0 + +/** + * Opaque reference to an error instance. Null serves as the 'success' value. + */ +typedef struct LLVMOpaqueError *LLVMErrorRef; + +/** + * Error type identifier. + */ +typedef const void *LLVMErrorTypeId; + +/** + * Returns the type id for the given error instance, which must be a failure + * value (i.e. non-null). + */ +LLVMErrorTypeId LLVMGetErrorTypeId(LLVMErrorRef Err); + +/** + * Dispose of the given error without handling it. This operation consumes the + * error, and the given LLVMErrorRef value is not usable once this call returns. + * Note: This method *only* needs to be called if the error is not being passed + * to some other consuming operation, e.g. LLVMGetErrorMessage. + */ +void LLVMConsumeError(LLVMErrorRef Err); + +/** + * Report a fatal error if Err is a failure value. + * + * This function can be used to wrap calls to fallible functions ONLY when it is + * known that the Error will always be a success value. + */ +void LLVMCantFail(LLVMErrorRef Err); + +/** + * Returns the given string's error message. This operation consumes the error, + * and the given LLVMErrorRef value is not usable once this call returns. + * The caller is responsible for disposing of the string by calling + * LLVMDisposeErrorMessage. + */ +char *LLVMGetErrorMessage(LLVMErrorRef Err); + +/** + * Dispose of the given error message. + */ +void LLVMDisposeErrorMessage(char *ErrMsg); + +/** + * Returns the type id for llvm StringError. + */ +LLVMErrorTypeId LLVMGetStringErrorTypeId(void); + +/** + * Create a StringError. + */ +LLVMErrorRef LLVMCreateStringError(const char *ErrMsg); + +/** + * @} + */ + +LLVM_C_EXTERN_C_END + +#endif |