nordic-dev.net/nix
nordic-dev.net/nix
2
0
Fork 0
mirror of https://github.com/NixOS/nix.git synced 2024-11-22 06:42:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

C API: Docs

Browse Source
This commit is contained in:
Robert Hensing 2024-06-13 18:23:21 +02:00
parent c50db4e58c
commit 5d8118d9cb
1 changed files with 13 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
src/libexpr-c/nix_api_expr.h
View File

@ -29,12 +29,20 @@ extern "C" {
* @see nix_state_create * @see nix_state_create
*/ */
typedef struct EvalState EvalState; // nix::EvalState typedef struct EvalState EvalState; // nix::EvalState
/**
* @brief Represents a value in the Nix language. /** @brief A Nix language value, or thunk that may evaluate to a value.
*
* Values are the primary objects manipulated in the Nix language.
* They are considered to be immutable from a user's perspective, but the process of evaluating a Value changes its
* ValueType if it was a thunk. After a Value has been evaluated, its ValueType does not change.
*
* Evaluation in this context refers to the process of evaluating a single Value object, also called "forcing" the
* Value; see `nix_value_force`.
*
* The evaluator manages its own memory, but your use of the C API must follow the reference counting rules.
* *
* Owned by the garbage collector.
* @struct Value
* @see value_manip * @see value_manip
* @see nix_value_incref, nix_value_decref
*/ */
typedef struct nix_value nix_value; typedef struct nix_value nix_value;
[[deprecated("use nix_value instead")]] typedef nix_value Value; [[deprecated("use nix_value instead")]] typedef nix_value Value;
@ -128,7 +136,7 @@ nix_err nix_value_call_multi(
* The Nix interpreter is lazy, and not-yet-evaluated Values can be * The Nix interpreter is lazy, and not-yet-evaluated Values can be
* of type NIX_TYPE_THUNK instead of their actual value. * of type NIX_TYPE_THUNK instead of their actual value.
* *
* This function converts these Values into their final type. * This function mutates such a Value, so that, if successful, it has its final type.
* *
* @note This function is mainly needed before calling @ref getters, but not for API calls that return a `Value`. * @note This function is mainly needed before calling @ref getters, but not for API calls that return a `Value`.
* *