Nix 2.34.6
Nix, the purely functional package manager: C API (experimental)
Loading...
Searching...
No Matches
nix_api_value.h
Go to the documentation of this file.
1#ifndef NIX_API_VALUE_H
2#define NIX_API_VALUE_H
3
7
8#include "nix_api_util.h"
9#include "nix_api_store.h"
10
11#include <stdbool.h>
12#include <stddef.h>
13#include <stdint.h>
14
15#ifdef __cplusplus
16extern "C" {
17#endif
18// cffi start
19
26
34
39
43
44// Type definitions
106
107// forward declarations
108typedef struct nix_value nix_value;
109typedef struct EvalState EvalState;
110
112[[deprecated("use nix_value instead")]] typedef nix_value Value;
113
114// type defs
131typedef struct BindingsBuilder BindingsBuilder;
132
149typedef struct ListBuilder ListBuilder;
150
158typedef struct PrimOp PrimOp;
166typedef struct ExternalValue ExternalValue;
167
173
187typedef void (*PrimOpFun)(
188 void * user_data, nix_c_context * context, EvalState * state, nix_value ** args, nix_value * ret);
189
206 nix_c_context * context,
207 PrimOpFun fun,
208 int arity,
209 const char * name,
210 const char ** args,
211 const char * doc,
212 void * user_data);
213
231
232// Function prototypes
233
243
255
268
276
283const char * nix_get_typename(nix_c_context * context, const nix_value * value);
284
291bool nix_get_bool(nix_c_context * context, const nix_value * value);
292
305nix_get_string(nix_c_context * context, const nix_value * value, nix_get_string_callback callback, void * user_data);
306
313const char * nix_get_path_string(nix_c_context * context, const nix_value * value);
314
321unsigned int nix_get_list_size(nix_c_context * context, const nix_value * value);
322
329unsigned int nix_get_attrs_size(nix_c_context * context, const nix_value * value);
330
337double nix_get_float(nix_c_context * context, const nix_value * value);
338
345int64_t nix_get_int(nix_c_context * context, const nix_value * value);
346
355
366nix_value * nix_get_list_byidx(nix_c_context * context, const nix_value * value, EvalState * state, unsigned int ix);
367
381nix_value *
382nix_get_list_byidx_lazy(nix_c_context * context, const nix_value * value, EvalState * state, unsigned int ix);
383
394nix_value * nix_get_attr_byname(nix_c_context * context, const nix_value * value, EvalState * state, const char * name);
395
409nix_value *
410nix_get_attr_byname_lazy(nix_c_context * context, const nix_value * value, EvalState * state, const char * name);
411
420bool nix_has_attr_byname(nix_c_context * context, const nix_value * value, EvalState * state, const char * name);
421
445nix_value *
446nix_get_attr_byidx(nix_c_context * context, nix_value * value, EvalState * state, unsigned int i, const char ** name);
447
475 nix_c_context * context, nix_value * value, EvalState * state, unsigned int i, const char ** name);
476
498const char * nix_get_attr_name_byidx(nix_c_context * context, nix_value * value, EvalState * state, unsigned int i);
499
515nix_err nix_init_bool(nix_c_context * context, nix_value * value, bool b);
516
524nix_err nix_init_string(nix_c_context * context, nix_value * value, const char * str);
525
533nix_err nix_init_path_string(nix_c_context * context, EvalState * s, nix_value * value, const char * str);
534
542nix_err nix_init_float(nix_c_context * context, nix_value * value, double d);
543
551
552nix_err nix_init_int(nix_c_context * context, nix_value * value, int64_t i);
560
577
586
599nix_err nix_make_list(nix_c_context * context, ListBuilder * list_builder, nix_value * value);
600
608ListBuilder * nix_make_list_builder(nix_c_context * context, EvalState * state, size_t capacity);
609
618nix_list_builder_insert(nix_c_context * context, ListBuilder * list_builder, unsigned int index, nix_value * value);
619
626
640
657nix_err nix_copy_value(nix_c_context * context, nix_value * value, const nix_value * source);
659
667
676nix_bindings_builder_insert(nix_c_context * context, BindingsBuilder * builder, const char * name, nix_value * value);
677
684
702nix_realised_string * nix_string_realise(nix_c_context * context, EvalState * state, nix_value * value, bool isIFD);
703
709
715
721
727const StorePath * nix_realised_string_get_store_path(nix_realised_string * realised_string, size_t index);
728
733
734// cffi end
735#ifdef __cplusplus
736}
737#endif
738
739#endif // NIX_API_VALUE_H
void(* nix_get_string_callback)(const char *start, unsigned int n, void *user_data)
Called to get the value of a string owned by Nix.
Definition nix_api_util.h:171
nix_err
Type for error codes in the Nix system.
Definition nix_api_util.h:59
nix_err nix_register_primop(nix_c_context *context, PrimOp *primOp)
add a primop to the builtins attribute set
PrimOp * nix_alloc_primop(nix_c_context *context, PrimOpFun fun, int arity, const char *name, const char **args, const char *doc, void *user_data)
Allocate a PrimOp.
void(* PrimOpFun)(void *user_data, nix_c_context *context, EvalState *state, nix_value **args, nix_value *ret)
Function pointer for primops.
Definition nix_api_value.h:187
nix_err nix_init_string(nix_c_context *context, nix_value *value, const char *str)
Set a string.
void nix_list_builder_free(ListBuilder *list_builder)
Free a list builder.
nix_err nix_list_builder_insert(nix_c_context *context, ListBuilder *list_builder, unsigned int index, nix_value *value)
Insert bindings into a builder.
nix_err nix_init_int(nix_c_context *context, nix_value *value, int64_t i)
Set an int.
nix_err nix_init_external(nix_c_context *context, nix_value *value, ExternalValue *val)
Set an external value.
nix_err nix_init_null(nix_c_context *context, nix_value *value)
Set null.
nix_value * nix_alloc_value(nix_c_context *context, EvalState *state)
Allocate a Nix value.
nix_err nix_make_attrs(nix_c_context *context, nix_value *value, BindingsBuilder *b)
Create an attribute set from a bindings builder.
nix_err nix_copy_value(nix_c_context *context, nix_value *value, const nix_value *source)
Copy from another value.
nix_err nix_make_list(nix_c_context *context, ListBuilder *list_builder, nix_value *value)
Create a list from a list builder.
nix_err nix_init_path_string(nix_c_context *context, EvalState *s, nix_value *value, const char *str)
Set a path.
nix_err nix_init_float(nix_c_context *context, nix_value *value, double d)
Set a float.
nix_err nix_init_primop(nix_c_context *context, nix_value *value, PrimOp *op)
Set primop.
nix_err nix_init_bool(nix_c_context *context, nix_value *value, bool b)
Set boolean value.
ListBuilder * nix_make_list_builder(nix_c_context *context, EvalState *state, size_t capacity)
Create a list builder.
nix_err nix_init_apply(nix_c_context *context, nix_value *value, nix_value *fn, nix_value *arg)
Set the value to a thunk that will perform a function application when needed.
const char * nix_get_attr_name_byidx(nix_c_context *context, nix_value *value, EvalState *state, unsigned int i)
Get an attribute name by index.
const char * nix_get_path_string(nix_c_context *context, const nix_value *value)
Get path as string.
ValueType nix_get_type(nix_c_context *context, const nix_value *value)
Get value type.
nix_value * nix_get_list_byidx(nix_c_context *context, const nix_value *value, EvalState *state, unsigned int ix)
Get the ix'th element of a list.
nix_value * nix_get_attr_byidx(nix_c_context *context, nix_value *value, EvalState *state, unsigned int i, const char **name)
Get an attribute by index.
const char * nix_get_typename(nix_c_context *context, const nix_value *value)
Get type name of value as defined in the evaluator.
unsigned int nix_get_list_size(nix_c_context *context, const nix_value *value)
Get the length of a list.
double nix_get_float(nix_c_context *context, const nix_value *value)
Get float value in 64 bits.
ExternalValue * nix_get_external(nix_c_context *context, nix_value *value)
Get external reference.
unsigned int nix_get_attrs_size(nix_c_context *context, const nix_value *value)
Get the element count of an attrset.
nix_value * nix_get_attr_byname_lazy(nix_c_context *context, const nix_value *value, EvalState *state, const char *name)
Get an attribute value by attribute name, without forcing evaluation of the attribute's value.
nix_value * nix_get_attr_byname(nix_c_context *context, const nix_value *value, EvalState *state, const char *name)
Get an attr by name.
nix_value * nix_get_list_byidx_lazy(nix_c_context *context, const nix_value *value, EvalState *state, unsigned int ix)
Get the ix'th element of a list without forcing evaluation of the element.
bool nix_get_bool(nix_c_context *context, const nix_value *value)
Get boolean value.
nix_value * nix_get_attr_byidx_lazy(nix_c_context *context, nix_value *value, EvalState *state, unsigned int i, const char **name)
Get an attribute by index, without forcing evaluation of the attribute's value.
nix_err nix_get_string(nix_c_context *context, const nix_value *value, nix_get_string_callback callback, void *user_data)
Get the raw string.
int64_t nix_get_int(nix_c_context *context, const nix_value *value)
Get int value.
bool nix_has_attr_byname(nix_c_context *context, const nix_value *value, EvalState *state, const char *name)
Check if an attribute name exists on a value.
nix_err nix_value_incref(nix_c_context *context, nix_value *value)
Increment the garbage collector reference counter for the given nix_value.
nix_err nix_value_decref(nix_c_context *context, nix_value *value)
Decrement the garbage collector reference counter for the given object.
ValueType
Represents the state of a Nix value.
Definition nix_api_value.h:53
Main entry for the libstore C bindings.
Main entry for the libutil C bindings.
nix_realised_string * nix_string_realise(nix_c_context *context, EvalState *state, nix_value *value, bool isIFD)
Realise a string context.
void nix_realised_string_free(nix_realised_string *realised_string)
Free a realised string.
size_t nix_realised_string_get_store_path_count(nix_realised_string *realised_string)
Number of realised store paths.
BindingsBuilder * nix_make_bindings_builder(nix_c_context *context, EvalState *state, size_t capacity)
Create a bindings builder.
const StorePath * nix_realised_string_get_store_path(nix_realised_string *realised_string, size_t index)
Get a store path. The store paths are stored in an arbitrary order.
const char * nix_realised_string_get_buffer_start(nix_realised_string *realised_string)
Start of the string.
nix_value Value
Definition nix_api_value.h:112
nix_err nix_bindings_builder_insert(nix_c_context *context, BindingsBuilder *builder, const char *name, nix_value *value)
Insert bindings into a builder.
size_t nix_realised_string_get_buffer_size(nix_realised_string *realised_string)
Length of the string.
void nix_bindings_builder_free(BindingsBuilder *builder)
Free a bindings builder.
@ NIX_TYPE_ATTRS
Attribute set (key-value mapping).
Definition nix_api_value.h:91
@ NIX_TYPE_FUNCTION
Function (lambda or builtin).
Definition nix_api_value.h:99
@ NIX_TYPE_EXTERNAL
External value from C++ plugins or C API.
Definition nix_api_value.h:103
@ NIX_TYPE_THUNK
Definition nix_api_value.h:61
@ NIX_TYPE_NULL
Null value.
Definition nix_api_value.h:87
@ NIX_TYPE_BOOL
Boolean true or false value.
Definition nix_api_value.h:73
@ NIX_TYPE_LIST
Ordered list of values.
Definition nix_api_value.h:95
@ NIX_TYPE_STRING
String value with context.
Definition nix_api_value.h:79
@ NIX_TYPE_FLOAT
IEEE 754 double precision floating point number.
Definition nix_api_value.h:69
@ NIX_TYPE_PATH
Filesystem path.
Definition nix_api_value.h:83
@ NIX_TYPE_INT
Definition nix_api_value.h:65
Stores an under-construction set of bindings.
Represents a state of the Nix language evaluator.
External Value.
Stores an under-construction list.
PrimOp function.
This object stores error state.
String without placeholders, and realised store paths.
A Nix language value, or thunk that may evaluate to a value.