You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
124 lines
4.0 KiB
124 lines
4.0 KiB
//===-- mlir-c/Support.h - Helpers for C API to Core MLIR ---------*- 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 header declares the auxiliary data structures used in C APIs to core
|
|
// MLIR functionality.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef MLIR_C_SUPPORT_H
|
|
#define MLIR_C_SUPPORT_H
|
|
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
// Visibility annotations.
|
|
// Use MLIR_CAPI_EXPORTED for exported functions.
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#if defined(MLIR_CAPI_DISABLE_VISIBILITY_ANNOTATIONS)
|
|
#define MLIR_CAPI_EXPORTED
|
|
#elif defined(_WIN32) || defined(__CYGWIN__)
|
|
// Windows visibility declarations.
|
|
#if MLIR_CAPI_BUILDING_LIBRARY
|
|
#define MLIR_CAPI_EXPORTED __declspec(dllexport)
|
|
#else
|
|
#define MLIR_CAPI_EXPORTED __declspec(dllimport)
|
|
#endif
|
|
#else
|
|
// Non-windows: use visibility attributes.
|
|
#define MLIR_CAPI_EXPORTED __attribute__((visibility("default")))
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
// MlirStringRef.
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
/** A pointer to a sized fragment of a string, not necessarily null-terminated.
|
|
* Does not own the underlying string. This is equivalent to llvm::StringRef.
|
|
*/
|
|
struct MlirStringRef {
|
|
const char *data; /**< Pointer to the first symbol. */
|
|
size_t length; /**< Length of the fragment. */
|
|
};
|
|
typedef struct MlirStringRef MlirStringRef;
|
|
|
|
/** Constructs a string reference from the pointer and length. The pointer need
|
|
* not reference to a null-terminated string.
|
|
*/
|
|
inline static MlirStringRef mlirStringRefCreate(const char *str,
|
|
size_t length) {
|
|
MlirStringRef result;
|
|
result.data = str;
|
|
result.length = length;
|
|
return result;
|
|
}
|
|
|
|
/** Constructs a string reference from a null-terminated C string. Prefer
|
|
* mlirStringRefCreate if the length of the string is known.
|
|
*/
|
|
MLIR_CAPI_EXPORTED MlirStringRef
|
|
mlirStringRefCreateFromCString(const char *str);
|
|
|
|
/** A callback for returning string references.
|
|
*
|
|
* This function is called back by the functions that need to return a reference
|
|
* to the portion of the string with the following arguments:
|
|
* - an MlirStringRef represening the current portion of the string
|
|
* - a pointer to user data forwarded from the printing call.
|
|
*/
|
|
typedef void (*MlirStringCallback)(MlirStringRef, void *);
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
// MlirLogicalResult.
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
/** A logical result value, essentially a boolean with named states. LLVM
|
|
* convention for using boolean values to designate success or failure of an
|
|
* operation is a moving target, so MLIR opted for an explicit class.
|
|
* Instances of MlirLogicalResult must only be inspected using the associated
|
|
* functions. */
|
|
struct MlirLogicalResult {
|
|
int8_t value;
|
|
};
|
|
typedef struct MlirLogicalResult MlirLogicalResult;
|
|
|
|
/// Checks if the given logical result represents a success.
|
|
inline static bool mlirLogicalResultIsSuccess(MlirLogicalResult res) {
|
|
return res.value != 0;
|
|
}
|
|
|
|
/// Checks if the given logical result represents a failure.
|
|
inline static bool mlirLogicalResultIsFailure(MlirLogicalResult res) {
|
|
return res.value == 0;
|
|
}
|
|
|
|
/// Creates a logical result representing a success.
|
|
inline static MlirLogicalResult mlirLogicalResultSuccess() {
|
|
MlirLogicalResult res = {1};
|
|
return res;
|
|
}
|
|
|
|
/// Creates a logical result representing a failure.
|
|
inline static MlirLogicalResult mlirLogicalResultFailure() {
|
|
MlirLogicalResult res = {0};
|
|
return res;
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // MLIR_C_SUPPORT_H
|