iree.h File Reference

Optional header-only adapters between IREE base types and the Loom C API. More...

Go to the source code of this file.

Detailed Description

Optional header-only adapters between IREE base types and the Loom C API.

This header is for IREE-hosted tools and runtimes that already use IREE base types. Core loomc/*.h headers remain independent from IREE. Including this header verifies ABI compatibility and provides zero-copy conversions for status, string view, byte span, and allocator values.

Example

Convert at the IREE/Loom boundary and preserve rich status payloads:

iree_status_t create_source_from_iree(
    iree_string_view_t identifier, iree_const_byte_span_t contents,
    iree_allocator_t host_allocator, loomc_source_t** out_source) {
  loomc_source_options_t options = {
      .type = LOOMC_STRUCTURE_TYPE_SOURCE_OPTIONS,
      .structure_size = sizeof(loomc_source_options_t),
      .format = LOOMC_SOURCE_FORMAT_TEXT,
      .identifier = loomc_string_view_from_iree(identifier),
      .contents = loomc_byte_span_from_iree(contents),
      .storage = LOOMC_SOURCE_STORAGE_COPY,
  };
  loomc_status_t status = loomc_source_create(
      &options, loomc_allocator_from_iree(host_allocator), out_source);
  return iree_status_from_loomc(status);
}