nix_api_expr.h

Go to the documentation of this file.

#ifndef NIX_API_EXPR_H
#define NIX_API_EXPR_H
 
#include "nix_api_store.h"
#include "nix_api_util.h"
#include <stddef.h>
 
#ifndef __has_c_attribute
#  define __has_c_attribute(x) 0
#endif
 
#if __has_c_attribute(deprecated)
#  define NIX_DEPRECATED(msg) [[deprecated(msg)]]
#else
#  define NIX_DEPRECATED(msg)
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
// cffi start
 
// Type definitions
typedef struct nix_eval_state_builder nix_eval_state_builder;

typedef struct EvalState EvalState; // nix::EvalState


typedef struct nix_value nix_value;
NIX_DEPRECATED("use nix_value instead") typedef nix_value Value;
 
// Function prototypes
nix_err nix_libexpr_init(nix_c_context * context);

nix_err nix_expr_eval_from_string(
    nix_c_context * context, EvalState * state, const char * expr, const char * path, nix_value * value);

nix_err nix_value_call(nix_c_context * context, EvalState * state, nix_value * fn, nix_value * arg, nix_value * value);

nix_err nix_value_call_multi(
    nix_c_context * context, EvalState * state, nix_value * fn, size_t nargs, nix_value ** args, nix_value * value);

#define NIX_VALUE_CALL(context, state, value, fn, ...)                      \
    do {                                                                    \
        nix_value * args_array[] = {__VA_ARGS__};                           \
        size_t nargs = sizeof(args_array) / sizeof(args_array[0]);          \
        nix_value_call_multi(context, state, fn, nargs, args_array, value); \
    } while (0)

nix_err nix_value_force(nix_c_context * context, EvalState * state, nix_value * value);

nix_err nix_value_force_deep(nix_c_context * context, EvalState * state, nix_value * value);

nix_eval_state_builder * nix_eval_state_builder_new(nix_c_context * context, Store * store);

nix_err nix_eval_state_builder_load(nix_c_context * context, nix_eval_state_builder * builder);

nix_err nix_eval_state_builder_set_lookup_path(
    nix_c_context * context, nix_eval_state_builder * builder, const char ** lookupPath);

EvalState * nix_eval_state_build(nix_c_context * context, nix_eval_state_builder * builder);

void nix_eval_state_builder_free(nix_eval_state_builder * builder);

EvalState * nix_state_create(nix_c_context * context, const char ** lookupPath, Store * store);

void nix_state_free(EvalState * state);

 
// TODO: Deprecate nix_gc_incref in favor of the type-specific reference counting functions?
//       e.g. nix_value_incref.
//       It gives implementors more flexibility, and adds safety, so that generated
//       bindings can be used without fighting the host type system (where applicable).
nix_err nix_gc_incref(nix_c_context * context, const void * object);
nix_err nix_gc_decref(nix_c_context * context, const void * object);

void nix_gc_now();

void nix_gc_register_finalizer(void * obj, void * cd, void (*finalizer)(void * obj, void * cd));
 // doxygen group GC
 
// cffi end
#ifdef __cplusplus
}
#endif
 
#endif // NIX_API_EXPR_H