Kùzu C API
Loading...
Searching...
No Matches
kuzu.h File Reference
#include <stdbool.h>
#include <stdint.h>
#include <time.h>

Go to the source code of this file.

Data Structures

struct  ArrowSchema
 
struct  ArrowArray
 
struct  kuzu_system_config
 Stores runtime configuration for creating or opening a Database. More...
 
struct  kuzu_database
 kuzu_database manages all database components. More...
 
struct  kuzu_connection
 kuzu_connection is used to interact with a Database instance. Each connection is thread-safe. Multiple connections can connect to the same Database instance in a multi-threaded environment. More...
 
struct  kuzu_prepared_statement
 kuzu_prepared_statement is a parameterized query which can avoid planning the same query for repeated execution. More...
 
struct  kuzu_query_result
 kuzu_query_result stores the result of a query. More...
 
struct  kuzu_flat_tuple
 kuzu_flat_tuple stores a vector of values. More...
 
struct  kuzu_logical_type
 kuzu_logical_type is the kuzu internal representation of data types. More...
 
struct  kuzu_value
 kuzu_value is used to represent a value with any kuzu internal dataType. More...
 
struct  kuzu_internal_id_t
 kuzu internal internal_id type which stores the table_id and offset of a node/rel. More...
 
struct  kuzu_date_t
 kuzu internal date type which stores the number of days since 1970-01-01 00:00:00 UTC. More...
 
struct  kuzu_timestamp_ns_t
 kuzu internal timestamp_ns type which stores the number of nanoseconds since 1970-01-01 00:00:00 UTC. More...
 
struct  kuzu_timestamp_ms_t
 kuzu internal timestamp_ms type which stores the number of milliseconds since 1970-01-01 00:00:00 UTC. More...
 
struct  kuzu_timestamp_sec_t
 kuzu internal timestamp_sec_t type which stores the number of seconds since 1970-01-01 00:00:00 UTC. More...
 
struct  kuzu_timestamp_tz_t
 kuzu internal timestamp_tz type which stores the number of microseconds since 1970-01-01 with timezone 00:00:00 UTC. More...
 
struct  kuzu_timestamp_t
 kuzu internal timestamp type which stores the number of microseconds since 1970-01-01 00:00:00 UTC. More...
 
struct  kuzu_interval_t
 kuzu internal interval type which stores the months, days and microseconds. More...
 
struct  kuzu_query_summary
 kuzu_query_summary stores the execution time, plan, compiling time and query options of a query. More...
 
struct  kuzu_int128_t
 

Macros

#define KUZU_HELPER_DLL_IMPORT   __attribute__((visibility("default")))
 
#define KUZU_HELPER_DLL_EXPORT   __attribute__((visibility("default")))
 
#define KUZU_HELPER_DLL_LOCAL   __attribute__((visibility("hidden")))
 
#define KUZU_HELPER_DEPRECATED   __attribute__((__deprecated__))
 
#define KUZU_API   KUZU_HELPER_DLL_IMPORT
 
#define KUZU_DEPRECATED   KUZU_HELPER_DEPRECATED
 
#define KUZU_DEPRECATED_EXPORT   KUZU_API KUZU_DEPRECATED
 
#define ARROW_C_DATA_INTERFACE
 
#define ARROW_FLAG_DICTIONARY_ORDERED   1
 
#define ARROW_FLAG_NULLABLE   2
 
#define ARROW_FLAG_MAP_KEYS_SORTED   4
 
#define KUZU_C_API   KUZU_API
 

Enumerations

enum  kuzu_data_type_id {
  KUZU_ANY = 0 , KUZU_NODE = 10 , KUZU_REL = 11 , KUZU_RECURSIVE_REL = 12 ,
  KUZU_SERIAL = 13 , KUZU_BOOL = 22 , KUZU_INT64 = 23 , KUZU_INT32 = 24 ,
  KUZU_INT16 = 25 , KUZU_INT8 = 26 , KUZU_UINT64 = 27 , KUZU_UINT32 = 28 ,
  KUZU_UINT16 = 29 , KUZU_UINT8 = 30 , KUZU_INT128 = 31 , KUZU_DOUBLE = 32 ,
  KUZU_FLOAT = 33 , KUZU_DATE = 34 , KUZU_TIMESTAMP = 35 , KUZU_TIMESTAMP_SEC = 36 ,
  KUZU_TIMESTAMP_MS = 37 , KUZU_TIMESTAMP_NS = 38 , KUZU_TIMESTAMP_TZ = 39 , KUZU_INTERVAL = 40 ,
  KUZU_DECIMAL = 41 , KUZU_INTERNAL_ID = 42 , KUZU_STRING = 50 , KUZU_BLOB = 51 ,
  KUZU_LIST = 52 , KUZU_ARRAY = 53 , KUZU_STRUCT = 54 , KUZU_MAP = 55 ,
  KUZU_UNION = 56 , KUZU_POINTER = 58 , KUZU_UUID = 59
}
 enum class for kuzu internal dataTypes. More...
 
enum  kuzu_state { KuzuSuccess = 0 , KuzuError = 1 }
 enum class for kuzu function return state. More...
 

Functions

KUZU_C_API kuzu_state kuzu_database_init (const char *database_path, kuzu_system_config system_config, kuzu_database *out_database)
 Allocates memory and creates a kuzu database instance at database_path with bufferPoolSize=buffer_pool_size. Caller is responsible for calling kuzu_database_destroy() to release the allocated memory.
 
KUZU_C_API void kuzu_database_destroy (kuzu_database *database)
 Destroys the kuzu database instance and frees the allocated memory.
 
KUZU_C_API kuzu_system_config kuzu_default_system_config ()
 
KUZU_C_API kuzu_state kuzu_connection_init (kuzu_database *database, kuzu_connection *out_connection)
 Allocates memory and creates a connection to the database. Caller is responsible for calling kuzu_connection_destroy() to release the allocated memory.
 
KUZU_C_API void kuzu_connection_destroy (kuzu_connection *connection)
 Destroys the connection instance and frees the allocated memory.
 
KUZU_C_API kuzu_state kuzu_connection_set_max_num_thread_for_exec (kuzu_connection *connection, uint64_t num_threads)
 Sets the maximum number of threads to use for executing queries.
 
KUZU_C_API kuzu_state kuzu_connection_get_max_num_thread_for_exec (kuzu_connection *connection, uint64_t *out_result)
 Returns the maximum number of threads of the connection to use for executing queries.
 
KUZU_C_API kuzu_state kuzu_connection_query (kuzu_connection *connection, const char *query, kuzu_query_result *out_query_result)
 Executes the given query and returns the result.
 
KUZU_C_API kuzu_state kuzu_connection_prepare (kuzu_connection *connection, const char *query, kuzu_prepared_statement *out_prepared_statement)
 Prepares the given query and returns the prepared statement.
 
KUZU_C_API kuzu_state kuzu_connection_execute (kuzu_connection *connection, kuzu_prepared_statement *prepared_statement, kuzu_query_result *out_query_result)
 Executes the prepared_statement using connection.
 
KUZU_C_API void kuzu_connection_interrupt (kuzu_connection *connection)
 Interrupts the current query execution in the connection.
 
KUZU_C_API kuzu_state kuzu_connection_set_query_timeout (kuzu_connection *connection, uint64_t timeout_in_ms)
 Sets query timeout value in milliseconds for the connection.
 
KUZU_C_API void kuzu_prepared_statement_destroy (kuzu_prepared_statement *prepared_statement)
 Destroys the prepared statement instance and frees the allocated memory.
 
KUZU_C_API bool kuzu_prepared_statement_is_success (kuzu_prepared_statement *prepared_statement)
 
KUZU_C_API char * kuzu_prepared_statement_get_error_message (kuzu_prepared_statement *prepared_statement)
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_bool (kuzu_prepared_statement *prepared_statement, const char *param_name, bool value)
 Binds the given boolean value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int64 (kuzu_prepared_statement *prepared_statement, const char *param_name, int64_t value)
 Binds the given int64_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int32 (kuzu_prepared_statement *prepared_statement, const char *param_name, int32_t value)
 Binds the given int32_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int16 (kuzu_prepared_statement *prepared_statement, const char *param_name, int16_t value)
 Binds the given int16_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int8 (kuzu_prepared_statement *prepared_statement, const char *param_name, int8_t value)
 Binds the given int8_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint64 (kuzu_prepared_statement *prepared_statement, const char *param_name, uint64_t value)
 Binds the given uint64_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint32 (kuzu_prepared_statement *prepared_statement, const char *param_name, uint32_t value)
 Binds the given uint32_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint16 (kuzu_prepared_statement *prepared_statement, const char *param_name, uint16_t value)
 Binds the given uint16_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint8 (kuzu_prepared_statement *prepared_statement, const char *param_name, uint8_t value)
 Binds the given int8_t value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_double (kuzu_prepared_statement *prepared_statement, const char *param_name, double value)
 Binds the given double value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_float (kuzu_prepared_statement *prepared_statement, const char *param_name, float value)
 Binds the given float value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_date (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_date_t value)
 Binds the given date value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_ns (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_timestamp_ns_t value)
 Binds the given timestamp_ns value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_sec (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_timestamp_sec_t value)
 Binds the given timestamp_sec value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_tz (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_timestamp_tz_t value)
 Binds the given timestamp_tz value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_ms (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_timestamp_ms_t value)
 Binds the given timestamp_ms value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_timestamp_t value)
 Binds the given timestamp value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_interval (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_interval_t value)
 Binds the given interval value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_string (kuzu_prepared_statement *prepared_statement, const char *param_name, const char *value)
 Binds the given string value to the given parameter name in the prepared statement.
 
KUZU_C_API kuzu_state kuzu_prepared_statement_bind_value (kuzu_prepared_statement *prepared_statement, const char *param_name, kuzu_value *value)
 Binds the given kuzu value to the given parameter name in the prepared statement.
 
KUZU_C_API void kuzu_query_result_destroy (kuzu_query_result *query_result)
 Destroys the given query result instance.
 
KUZU_C_API bool kuzu_query_result_is_success (kuzu_query_result *query_result)
 Returns true if the query is executed successful, false otherwise.
 
KUZU_C_API char * kuzu_query_result_get_error_message (kuzu_query_result *query_result)
 Returns the error message if the query is failed.
 
KUZU_C_API uint64_t kuzu_query_result_get_num_columns (kuzu_query_result *query_result)
 Returns the number of columns in the query result.
 
KUZU_C_API kuzu_state kuzu_query_result_get_column_name (kuzu_query_result *query_result, uint64_t index, char **out_column_name)
 Returns the column name at the given index.
 
KUZU_C_API kuzu_state kuzu_query_result_get_column_data_type (kuzu_query_result *query_result, uint64_t index, kuzu_logical_type *out_column_data_type)
 Returns the data type of the column at the given index.
 
KUZU_C_API uint64_t kuzu_query_result_get_num_tuples (kuzu_query_result *query_result)
 Returns the number of tuples in the query result.
 
KUZU_C_API kuzu_state kuzu_query_result_get_query_summary (kuzu_query_result *query_result, kuzu_query_summary *out_query_summary)
 Returns the query summary of the query result.
 
KUZU_C_API bool kuzu_query_result_has_next (kuzu_query_result *query_result)
 Returns true if we have not consumed all tuples in the query result, false otherwise.
 
KUZU_C_API kuzu_state kuzu_query_result_get_next (kuzu_query_result *query_result, kuzu_flat_tuple *out_flat_tuple)
 Returns the next tuple in the query result. Throws an exception if there is no more tuple.
 
KUZU_C_API bool kuzu_query_result_has_next_query_result (kuzu_query_result *query_result)
 Returns true if we have not consumed all query results, false otherwise. Use this function for loop results of multiple query statements.
 
KUZU_C_API kuzu_state kuzu_query_result_get_next_query_result (kuzu_query_result *query_result, kuzu_query_result *out_next_query_result)
 Returns the next query result. Use this function to loop multiple query statements' results.
 
KUZU_C_API char * kuzu_query_result_to_string (kuzu_query_result *query_result)
 Returns the query result as a string.
 
KUZU_C_API void kuzu_query_result_reset_iterator (kuzu_query_result *query_result)
 Resets the iterator of the query result to the beginning of the query result.
 
KUZU_C_API kuzu_state kuzu_query_result_get_arrow_schema (kuzu_query_result *query_result, struct ArrowSchema *out_schema)
 Returns the query result's schema as ArrowSchema.
 
KUZU_C_API kuzu_state kuzu_query_result_get_next_arrow_chunk (kuzu_query_result *query_result, int64_t chunk_size, struct ArrowArray *out_arrow_array)
 Returns the next chunk of the query result as ArrowArray.
 
KUZU_C_API void kuzu_flat_tuple_destroy (kuzu_flat_tuple *flat_tuple)
 Destroys the given flat tuple instance.
 
KUZU_C_API kuzu_state kuzu_flat_tuple_get_value (kuzu_flat_tuple *flat_tuple, uint64_t index, kuzu_value *out_value)
 Returns the value at index of the flat tuple.
 
KUZU_C_API char * kuzu_flat_tuple_to_string (kuzu_flat_tuple *flat_tuple)
 Converts the flat tuple to a string.
 
KUZU_C_API void kuzu_data_type_create (kuzu_data_type_id id, kuzu_logical_type *child_type, uint64_t num_elements_in_array, kuzu_logical_type *out_type)
 Creates a data type instance with the given id, childType and num_elements_in_array. Caller is responsible for destroying the returned data type instance.
 
KUZU_C_API void kuzu_data_type_clone (kuzu_logical_type *data_type, kuzu_logical_type *out_type)
 Creates a new data type instance by cloning the given data type instance.
 
KUZU_C_API void kuzu_data_type_destroy (kuzu_logical_type *data_type)
 Destroys the given data type instance.
 
KUZU_C_API bool kuzu_data_type_equals (kuzu_logical_type *data_type1, kuzu_logical_type *data_type2)
 Returns true if the given data type is equal to the other data type, false otherwise.
 
KUZU_C_API kuzu_data_type_id kuzu_data_type_get_id (kuzu_logical_type *data_type)
 Returns the enum type id of the given data type.
 
KUZU_C_API kuzu_state kuzu_data_type_get_num_elements_in_array (kuzu_logical_type *data_type, uint64_t *out_result)
 Returns the number of elements for array.
 
KUZU_C_API kuzu_valuekuzu_value_create_null ()
 Creates a NULL value of ANY type. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_null_with_data_type (kuzu_logical_type *data_type)
 Creates a value of the given data type. Caller is responsible for destroying the returned value.
 
KUZU_C_API bool kuzu_value_is_null (kuzu_value *value)
 Returns true if the given value is NULL, false otherwise.
 
KUZU_C_API void kuzu_value_set_null (kuzu_value *value, bool is_null)
 Sets the given value to NULL or not.
 
KUZU_C_API kuzu_valuekuzu_value_create_default (kuzu_logical_type *data_type)
 Creates a value of the given data type with default non-NULL value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_bool (bool val_)
 Creates a value with boolean type and the given bool value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_int8 (int8_t val_)
 Creates a value with int8 type and the given int8 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_int16 (int16_t val_)
 Creates a value with int16 type and the given int16 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_int32 (int32_t val_)
 Creates a value with int32 type and the given int32 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_int64 (int64_t val_)
 Creates a value with int64 type and the given int64 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_uint8 (uint8_t val_)
 Creates a value with uint8 type and the given uint8 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_uint16 (uint16_t val_)
 Creates a value with uint16 type and the given uint16 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_uint32 (uint32_t val_)
 Creates a value with uint32 type and the given uint32 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_uint64 (uint64_t val_)
 Creates a value with uint64 type and the given uint64 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_int128 (kuzu_int128_t val_)
 Creates a value with int128 type and the given int128 value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_float (float val_)
 Creates a value with float type and the given float value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_double (double val_)
 Creates a value with double type and the given double value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_internal_id (kuzu_internal_id_t val_)
 Creates a value with internal_id type and the given internal_id value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_date (kuzu_date_t val_)
 Creates a value with date type and the given date value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_timestamp_ns (kuzu_timestamp_ns_t val_)
 Creates a value with timestamp_ns type and the given timestamp value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_timestamp_ms (kuzu_timestamp_ms_t val_)
 Creates a value with timestamp_ms type and the given timestamp value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_timestamp_sec (kuzu_timestamp_sec_t val_)
 Creates a value with timestamp_sec type and the given timestamp value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_timestamp_tz (kuzu_timestamp_tz_t val_)
 Creates a value with timestamp_tz type and the given timestamp value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_timestamp (kuzu_timestamp_t val_)
 Creates a value with timestamp type and the given timestamp value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_interval (kuzu_interval_t val_)
 Creates a value with interval type and the given interval value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_create_string (const char *val_)
 Creates a value with string type and the given string value. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_state kuzu_value_create_list (uint64_t num_elements, kuzu_value **elements, kuzu_value **out_value)
 Creates a list value with the given number of elements and the given elements. The caller needs to make sure that all elements have the same type. The elements are copied into the list value, so destroying the elements after creating the list value is safe. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_state kuzu_value_create_struct (uint64_t num_fields, const char **field_names, kuzu_value **field_values, kuzu_value **out_value)
 Creates a struct value with the given number of fields and the given field names and values. The caller needs to make sure that all field names are unique. The field names and values are copied into the struct value, so destroying the field names and values after creating the struct value is safe. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_state kuzu_value_create_map (uint64_t num_fields, kuzu_value **keys, kuzu_value **values, kuzu_value **out_value)
 Creates a map value with the given number of fields and the given keys and values. The caller needs to make sure that all keys are unique, and all keys and values have the same type. The keys and values are copied into the map value, so destroying the keys and values after creating the map value is safe. Caller is responsible for destroying the returned value.
 
KUZU_C_API kuzu_valuekuzu_value_clone (kuzu_value *value)
 Creates a new value based on the given value. Caller is responsible for destroying the returned value.
 
KUZU_C_API void kuzu_value_copy (kuzu_value *value, kuzu_value *other)
 Copies the other value to the value.
 
KUZU_C_API void kuzu_value_destroy (kuzu_value *value)
 Destroys the value.
 
KUZU_C_API kuzu_state kuzu_value_get_list_size (kuzu_value *value, uint64_t *out_result)
 Returns the number of elements per list of the given value. The value must be of type ARRAY.
 
KUZU_C_API kuzu_state kuzu_value_get_list_element (kuzu_value *value, uint64_t index, kuzu_value *out_value)
 Returns the element at index of the given value. The value must be of type LIST.
 
KUZU_C_API kuzu_state kuzu_value_get_struct_num_fields (kuzu_value *value, uint64_t *out_result)
 Returns the number of fields of the given struct value. The value must be of type STRUCT.
 
KUZU_C_API kuzu_state kuzu_value_get_struct_field_name (kuzu_value *value, uint64_t index, char **out_result)
 Returns the field name at index of the given struct value. The value must be of physical type STRUCT (STRUCT, NODE, REL, RECURSIVE_REL, UNION).
 
KUZU_C_API kuzu_state kuzu_value_get_struct_field_value (kuzu_value *value, uint64_t index, kuzu_value *out_value)
 Returns the field value at index of the given struct value. The value must be of physical type STRUCT (STRUCT, NODE, REL, RECURSIVE_REL, UNION).
 
KUZU_C_API kuzu_state kuzu_value_get_map_size (kuzu_value *value, uint64_t *out_result)
 Returns the size of the given map value. The value must be of type MAP.
 
KUZU_C_API kuzu_state kuzu_value_get_map_key (kuzu_value *value, uint64_t index, kuzu_value *out_key)
 Returns the key at index of the given map value. The value must be of physical type MAP.
 
KUZU_C_API kuzu_state kuzu_value_get_map_value (kuzu_value *value, uint64_t index, kuzu_value *out_value)
 Returns the field value at index of the given map value. The value must be of physical type MAP.
 
KUZU_C_API kuzu_state kuzu_value_get_recursive_rel_node_list (kuzu_value *value, kuzu_value *out_value)
 Returns the list of nodes for recursive rel value. The value must be of type RECURSIVE_REL.
 
KUZU_C_API kuzu_state kuzu_value_get_recursive_rel_rel_list (kuzu_value *value, kuzu_value *out_value)
 Returns the list of rels for recursive rel value. The value must be of type RECURSIVE_REL.
 
KUZU_C_API void kuzu_value_get_data_type (kuzu_value *value, kuzu_logical_type *out_type)
 Returns internal type of the given value.
 
KUZU_C_API kuzu_state kuzu_value_get_bool (kuzu_value *value, bool *out_result)
 Returns the boolean value of the given value. The value must be of type BOOL.
 
KUZU_C_API kuzu_state kuzu_value_get_int8 (kuzu_value *value, int8_t *out_result)
 Returns the int8 value of the given value. The value must be of type INT8.
 
KUZU_C_API kuzu_state kuzu_value_get_int16 (kuzu_value *value, int16_t *out_result)
 Returns the int16 value of the given value. The value must be of type INT16.
 
KUZU_C_API kuzu_state kuzu_value_get_int32 (kuzu_value *value, int32_t *out_result)
 Returns the int32 value of the given value. The value must be of type INT32.
 
KUZU_C_API kuzu_state kuzu_value_get_int64 (kuzu_value *value, int64_t *out_result)
 Returns the int64 value of the given value. The value must be of type INT64 or SERIAL.
 
KUZU_C_API kuzu_state kuzu_value_get_uint8 (kuzu_value *value, uint8_t *out_result)
 Returns the uint8 value of the given value. The value must be of type UINT8.
 
KUZU_C_API kuzu_state kuzu_value_get_uint16 (kuzu_value *value, uint16_t *out_result)
 Returns the uint16 value of the given value. The value must be of type UINT16.
 
KUZU_C_API kuzu_state kuzu_value_get_uint32 (kuzu_value *value, uint32_t *out_result)
 Returns the uint32 value of the given value. The value must be of type UINT32.
 
KUZU_C_API kuzu_state kuzu_value_get_uint64 (kuzu_value *value, uint64_t *out_result)
 Returns the uint64 value of the given value. The value must be of type UINT64.
 
KUZU_C_API kuzu_state kuzu_value_get_int128 (kuzu_value *value, kuzu_int128_t *out_result)
 Returns the int128 value of the given value. The value must be of type INT128.
 
KUZU_C_API kuzu_state kuzu_int128_t_from_string (const char *str, kuzu_int128_t *out_result)
 convert a string to int128 value.
 
KUZU_C_API kuzu_state kuzu_int128_t_to_string (kuzu_int128_t val, char **out_result)
 convert int128 to corresponding string.
 
KUZU_C_API kuzu_state kuzu_value_get_float (kuzu_value *value, float *out_result)
 Returns the float value of the given value. The value must be of type FLOAT.
 
KUZU_C_API kuzu_state kuzu_value_get_double (kuzu_value *value, double *out_result)
 Returns the double value of the given value. The value must be of type DOUBLE.
 
KUZU_C_API kuzu_state kuzu_value_get_internal_id (kuzu_value *value, kuzu_internal_id_t *out_result)
 Returns the internal id value of the given value. The value must be of type INTERNAL_ID.
 
KUZU_C_API kuzu_state kuzu_value_get_date (kuzu_value *value, kuzu_date_t *out_result)
 Returns the date value of the given value. The value must be of type DATE.
 
KUZU_C_API kuzu_state kuzu_value_get_timestamp (kuzu_value *value, kuzu_timestamp_t *out_result)
 Returns the timestamp value of the given value. The value must be of type TIMESTAMP.
 
KUZU_C_API kuzu_state kuzu_value_get_timestamp_ns (kuzu_value *value, kuzu_timestamp_ns_t *out_result)
 Returns the timestamp_ns value of the given value. The value must be of type TIMESTAMP_NS.
 
KUZU_C_API kuzu_state kuzu_value_get_timestamp_ms (kuzu_value *value, kuzu_timestamp_ms_t *out_result)
 Returns the timestamp_ms value of the given value. The value must be of type TIMESTAMP_MS.
 
KUZU_C_API kuzu_state kuzu_value_get_timestamp_sec (kuzu_value *value, kuzu_timestamp_sec_t *out_result)
 Returns the timestamp_sec value of the given value. The value must be of type TIMESTAMP_SEC.
 
KUZU_C_API kuzu_state kuzu_value_get_timestamp_tz (kuzu_value *value, kuzu_timestamp_tz_t *out_result)
 Returns the timestamp_tz value of the given value. The value must be of type TIMESTAMP_TZ.
 
KUZU_C_API kuzu_state kuzu_value_get_interval (kuzu_value *value, kuzu_interval_t *out_result)
 Returns the interval value of the given value. The value must be of type INTERVAL.
 
KUZU_C_API kuzu_state kuzu_value_get_decimal_as_string (kuzu_value *value, char **out_result)
 Returns the decimal value of the given value as a string. The value must be of type DECIMAL.
 
KUZU_C_API kuzu_state kuzu_value_get_string (kuzu_value *value, char **out_result)
 Returns the string value of the given value. The value must be of type STRING.
 
KUZU_C_API kuzu_state kuzu_value_get_blob (kuzu_value *value, uint8_t **out_result)
 Returns the blob value of the given value. The returned buffer is null-terminated similar to a string. The value must be of type BLOB.
 
KUZU_C_API kuzu_state kuzu_value_get_uuid (kuzu_value *value, char **out_result)
 Returns the uuid value of the given value. to a string. The value must be of type UUID.
 
KUZU_C_API char * kuzu_value_to_string (kuzu_value *value)
 Converts the given value to string.
 
KUZU_C_API kuzu_state kuzu_node_val_get_id_val (kuzu_value *node_val, kuzu_value *out_value)
 Returns the internal id value of the given node value as a kuzu value.
 
KUZU_C_API kuzu_state kuzu_node_val_get_label_val (kuzu_value *node_val, kuzu_value *out_value)
 Returns the label value of the given node value as a label value.
 
KUZU_C_API kuzu_state kuzu_node_val_get_property_size (kuzu_value *node_val, uint64_t *out_value)
 Returns the number of properties of the given node value.
 
KUZU_C_API kuzu_state kuzu_node_val_get_property_name_at (kuzu_value *node_val, uint64_t index, char **out_result)
 Returns the property name of the given node value at the given index.
 
KUZU_C_API kuzu_state kuzu_node_val_get_property_value_at (kuzu_value *node_val, uint64_t index, kuzu_value *out_value)
 Returns the property value of the given node value at the given index.
 
KUZU_C_API kuzu_state kuzu_node_val_to_string (kuzu_value *node_val, char **out_result)
 Converts the given node value to string.
 
KUZU_C_API kuzu_state kuzu_rel_val_get_src_id_val (kuzu_value *rel_val, kuzu_value *out_value)
 Returns the internal id value of the source node of the given rel value as a kuzu value.
 
KUZU_C_API kuzu_state kuzu_rel_val_get_dst_id_val (kuzu_value *rel_val, kuzu_value *out_value)
 Returns the internal id value of the destination node of the given rel value as a kuzu value.
 
KUZU_C_API kuzu_state kuzu_rel_val_get_label_val (kuzu_value *rel_val, kuzu_value *out_value)
 Returns the label value of the given rel value.
 
KUZU_C_API kuzu_state kuzu_rel_val_get_property_size (kuzu_value *rel_val, uint64_t *out_value)
 Returns the number of properties of the given rel value.
 
KUZU_C_API kuzu_state kuzu_rel_val_get_property_name_at (kuzu_value *rel_val, uint64_t index, char **out_result)
 Returns the property name of the given rel value at the given index.
 
KUZU_C_API kuzu_state kuzu_rel_val_get_property_value_at (kuzu_value *rel_val, uint64_t index, kuzu_value *out_value)
 Returns the property of the given rel value at the given index as kuzu value.
 
KUZU_C_API kuzu_state kuzu_rel_val_to_string (kuzu_value *rel_val, char **out_result)
 Converts the given rel value to string.
 
KUZU_C_API void kuzu_destroy_string (char *str)
 Destroys any string created by the Kùzu C API, including both the error message and the values returned by the API functions. This function is provided to avoid the inconsistency between the memory allocation and deallocation across different libraries and is preferred over using the standard C free function.
 
KUZU_C_API void kuzu_destroy_blob (uint8_t *blob)
 Destroys any blob created by the Kùzu C API. This function is provided to avoid the inconsistency between the memory allocation and deallocation across different libraries and is preferred over using the standard C free function.
 
KUZU_C_API void kuzu_query_summary_destroy (kuzu_query_summary *query_summary)
 Destroys the given query summary.
 
KUZU_C_API double kuzu_query_summary_get_compiling_time (kuzu_query_summary *query_summary)
 Returns the compilation time of the given query summary in milliseconds.
 
KUZU_C_API double kuzu_query_summary_get_execution_time (kuzu_query_summary *query_summary)
 Returns the execution time of the given query summary in milliseconds.
 
KUZU_C_API kuzu_state kuzu_timestamp_ns_to_tm (kuzu_timestamp_ns_t timestamp, struct tm *out_result)
 Convert timestamp_ns to corresponding tm struct.
 
KUZU_C_API kuzu_state kuzu_timestamp_ms_to_tm (kuzu_timestamp_ms_t timestamp, struct tm *out_result)
 Convert timestamp_ms to corresponding tm struct.
 
KUZU_C_API kuzu_state kuzu_timestamp_sec_to_tm (kuzu_timestamp_sec_t timestamp, struct tm *out_result)
 Convert timestamp_sec to corresponding tm struct.
 
KUZU_C_API kuzu_state kuzu_timestamp_tz_to_tm (kuzu_timestamp_tz_t timestamp, struct tm *out_result)
 Convert timestamp_tz to corresponding tm struct.
 
KUZU_C_API kuzu_state kuzu_timestamp_to_tm (kuzu_timestamp_t timestamp, struct tm *out_result)
 Convert timestamp to corresponding tm struct.
 
KUZU_C_API kuzu_state kuzu_timestamp_ns_from_tm (struct tm tm, kuzu_timestamp_ns_t *out_result)
 Convert tm struct to timestamp_ns value.
 
KUZU_C_API kuzu_state kuzu_timestamp_ms_from_tm (struct tm tm, kuzu_timestamp_ms_t *out_result)
 Convert tm struct to timestamp_ms value.
 
KUZU_C_API kuzu_state kuzu_timestamp_sec_from_tm (struct tm tm, kuzu_timestamp_sec_t *out_result)
 Convert tm struct to timestamp_sec value.
 
KUZU_C_API kuzu_state kuzu_timestamp_tz_from_tm (struct tm tm, kuzu_timestamp_tz_t *out_result)
 Convert tm struct to timestamp_tz value.
 
KUZU_C_API kuzu_state kuzu_timestamp_from_tm (struct tm tm, kuzu_timestamp_t *out_result)
 Convert timestamp_ns to corresponding string.
 
KUZU_C_API kuzu_state kuzu_date_to_string (kuzu_date_t date, char **out_result)
 Convert date to corresponding string.
 
KUZU_C_API kuzu_state kuzu_date_from_string (const char *str, kuzu_date_t *out_result)
 Convert a string to date value.
 
KUZU_C_API kuzu_state kuzu_date_to_tm (kuzu_date_t date, struct tm *out_result)
 Convert date to corresponding tm struct.
 
KUZU_C_API kuzu_state kuzu_date_from_tm (struct tm tm, kuzu_date_t *out_result)
 Convert tm struct to date value.
 
KUZU_C_API void kuzu_interval_to_difftime (kuzu_interval_t interval, double *out_result)
 Convert interval to corresponding difftime value in seconds.
 
KUZU_C_API void kuzu_interval_from_difftime (double difftime, kuzu_interval_t *out_result)
 Convert difftime value in seconds to interval.
 
KUZU_C_API char * kuzu_get_version ()
 Returns the version of the Kùzu library.
 
KUZU_C_API uint64_t kuzu_get_storage_version ()
 Returns the storage version of the Kùzu library.
 

Macro Definition Documentation

◆ ARROW_C_DATA_INTERFACE

#define ARROW_C_DATA_INTERFACE

◆ ARROW_FLAG_DICTIONARY_ORDERED

#define ARROW_FLAG_DICTIONARY_ORDERED   1

◆ ARROW_FLAG_MAP_KEYS_SORTED

#define ARROW_FLAG_MAP_KEYS_SORTED   4

◆ ARROW_FLAG_NULLABLE

#define ARROW_FLAG_NULLABLE   2

◆ KUZU_API

#define KUZU_API   KUZU_HELPER_DLL_IMPORT

◆ KUZU_C_API

#define KUZU_C_API   KUZU_API

◆ KUZU_DEPRECATED

#define KUZU_DEPRECATED   KUZU_HELPER_DEPRECATED

◆ KUZU_DEPRECATED_EXPORT

#define KUZU_DEPRECATED_EXPORT   KUZU_API KUZU_DEPRECATED

◆ KUZU_HELPER_DEPRECATED

#define KUZU_HELPER_DEPRECATED   __attribute__((__deprecated__))

◆ KUZU_HELPER_DLL_EXPORT

#define KUZU_HELPER_DLL_EXPORT   __attribute__((visibility("default")))

◆ KUZU_HELPER_DLL_IMPORT

#define KUZU_HELPER_DLL_IMPORT   __attribute__((visibility("default")))

◆ KUZU_HELPER_DLL_LOCAL

#define KUZU_HELPER_DLL_LOCAL   __attribute__((visibility("hidden")))

Enumeration Type Documentation

◆ kuzu_data_type_id

enum class for kuzu internal dataTypes.

Enumerator
KUZU_ANY 
KUZU_NODE 
KUZU_REL 
KUZU_RECURSIVE_REL 
KUZU_SERIAL 
KUZU_BOOL 
KUZU_INT64 
KUZU_INT32 
KUZU_INT16 
KUZU_INT8 
KUZU_UINT64 
KUZU_UINT32 
KUZU_UINT16 
KUZU_UINT8 
KUZU_INT128 
KUZU_DOUBLE 
KUZU_FLOAT 
KUZU_DATE 
KUZU_TIMESTAMP 
KUZU_TIMESTAMP_SEC 
KUZU_TIMESTAMP_MS 
KUZU_TIMESTAMP_NS 
KUZU_TIMESTAMP_TZ 
KUZU_INTERVAL 
KUZU_DECIMAL 
KUZU_INTERNAL_ID 
KUZU_STRING 
KUZU_BLOB 
KUZU_LIST 
KUZU_ARRAY 
KUZU_STRUCT 
KUZU_MAP 
KUZU_UNION 
KUZU_POINTER 
KUZU_UUID 

◆ kuzu_state

enum kuzu_state

enum class for kuzu function return state.

Enumerator
KuzuSuccess 
KuzuError 

Function Documentation

◆ kuzu_connection_destroy()

KUZU_C_API void kuzu_connection_destroy ( kuzu_connection * connection)

Destroys the connection instance and frees the allocated memory.

Parameters
connectionThe connection instance to destroy.

◆ kuzu_connection_execute()

KUZU_C_API kuzu_state kuzu_connection_execute ( kuzu_connection * connection,
kuzu_prepared_statement * prepared_statement,
kuzu_query_result * out_query_result )

Executes the prepared_statement using connection.

Parameters
connectionThe connection instance to execute the prepared_statement.
prepared_statementThe prepared statement to execute.
[out]out_query_resultThe output parameter that will hold the result of the query.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_connection_get_max_num_thread_for_exec()

KUZU_C_API kuzu_state kuzu_connection_get_max_num_thread_for_exec ( kuzu_connection * connection,
uint64_t * out_result )

Returns the maximum number of threads of the connection to use for executing queries.

Parameters
connectionThe connection instance to return max number of threads for execution.
[out]out_resultThe output parameter that will hold the maximum number of threads to use for executing queries.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_connection_init()

KUZU_C_API kuzu_state kuzu_connection_init ( kuzu_database * database,
kuzu_connection * out_connection )

Allocates memory and creates a connection to the database. Caller is responsible for calling kuzu_connection_destroy() to release the allocated memory.

Parameters
databaseThe database instance to connect to.
[out]out_connectionThe output parameter that will hold the connection instance.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_connection_interrupt()

KUZU_C_API void kuzu_connection_interrupt ( kuzu_connection * connection)

Interrupts the current query execution in the connection.

Parameters
connectionThe connection instance to interrupt.

◆ kuzu_connection_prepare()

KUZU_C_API kuzu_state kuzu_connection_prepare ( kuzu_connection * connection,
const char * query,
kuzu_prepared_statement * out_prepared_statement )

Prepares the given query and returns the prepared statement.

Parameters
connectionThe connection instance to prepare the query.
queryThe query to prepare.
[out]out_prepared_statementThe output parameter that will hold the prepared statement.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_connection_query()

KUZU_C_API kuzu_state kuzu_connection_query ( kuzu_connection * connection,
const char * query,
kuzu_query_result * out_query_result )

Executes the given query and returns the result.

Parameters
connectionThe connection instance to execute the query.
queryThe query to execute.
[out]out_query_resultThe output parameter that will hold the result of the query.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_connection_set_max_num_thread_for_exec()

KUZU_C_API kuzu_state kuzu_connection_set_max_num_thread_for_exec ( kuzu_connection * connection,
uint64_t num_threads )

Sets the maximum number of threads to use for executing queries.

Parameters
connectionThe connection instance to set max number of threads for execution.
num_threadsThe maximum number of threads to use for executing queries.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_connection_set_query_timeout()

KUZU_C_API kuzu_state kuzu_connection_set_query_timeout ( kuzu_connection * connection,
uint64_t timeout_in_ms )

Sets query timeout value in milliseconds for the connection.

Parameters
connectionThe connection instance to set query timeout value.
timeout_in_msThe timeout value in milliseconds.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_data_type_clone()

KUZU_C_API void kuzu_data_type_clone ( kuzu_logical_type * data_type,
kuzu_logical_type * out_type )

Creates a new data type instance by cloning the given data type instance.

Parameters
data_typeThe data type instance to clone.
[out]out_typeThe output parameter that will hold the cloned data type instance.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_data_type_create()

KUZU_C_API void kuzu_data_type_create ( kuzu_data_type_id id,
kuzu_logical_type * child_type,
uint64_t num_elements_in_array,
kuzu_logical_type * out_type )

Creates a data type instance with the given id, childType and num_elements_in_array. Caller is responsible for destroying the returned data type instance.

Parameters
idThe enum type id of the datatype to create.
child_typeThe child type of the datatype to create(only used for nested dataTypes).
num_elements_in_arrayThe number of elements in the array(only used for ARRAY).
[out]out_typeThe output parameter that will hold the data type instance.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_data_type_destroy()

KUZU_C_API void kuzu_data_type_destroy ( kuzu_logical_type * data_type)

Destroys the given data type instance.

Parameters
data_typeThe data type instance to destroy.

◆ kuzu_data_type_equals()

KUZU_C_API bool kuzu_data_type_equals ( kuzu_logical_type * data_type1,
kuzu_logical_type * data_type2 )

Returns true if the given data type is equal to the other data type, false otherwise.

Parameters
data_type1The first data type instance to compare.
data_type2The second data type instance to compare.

◆ kuzu_data_type_get_id()

KUZU_C_API kuzu_data_type_id kuzu_data_type_get_id ( kuzu_logical_type * data_type)

Returns the enum type id of the given data type.

Parameters
data_typeThe data type instance to return.

◆ kuzu_data_type_get_num_elements_in_array()

KUZU_C_API kuzu_state kuzu_data_type_get_num_elements_in_array ( kuzu_logical_type * data_type,
uint64_t * out_result )

Returns the number of elements for array.

Parameters
data_typeThe data type instance to return.
[out]out_resultThe output parameter that will hold the number of elements in the array.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_database_destroy()

KUZU_C_API void kuzu_database_destroy ( kuzu_database * database)

Destroys the kuzu database instance and frees the allocated memory.

Parameters
databaseThe database instance to destroy.

◆ kuzu_database_init()

KUZU_C_API kuzu_state kuzu_database_init ( const char * database_path,
kuzu_system_config system_config,
kuzu_database * out_database )

Allocates memory and creates a kuzu database instance at database_path with bufferPoolSize=buffer_pool_size. Caller is responsible for calling kuzu_database_destroy() to release the allocated memory.

Parameters
database_pathThe path to the database.
system_configThe runtime configuration for creating or opening the database.
[out]out_databaseThe output parameter that will hold the database instance.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_date_from_string()

KUZU_C_API kuzu_state kuzu_date_from_string ( const char * str,
kuzu_date_t * out_result )

Convert a string to date value.

Parameters
strThe string to convert.
[out]out_resultThe output parameter that will hold the date value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_date_from_tm()

KUZU_C_API kuzu_state kuzu_date_from_tm ( struct tm tm,
kuzu_date_t * out_result )

Convert tm struct to date value.

Parameters
tmThe tm struct to convert.
[out]out_resultThe output parameter that will hold the date value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_date_to_string()

KUZU_C_API kuzu_state kuzu_date_to_string ( kuzu_date_t date,
char ** out_result )

Convert date to corresponding string.

Parameters
dateThe date value to convert.
[out]out_resultThe output parameter that will hold the string value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_date_to_tm()

KUZU_C_API kuzu_state kuzu_date_to_tm ( kuzu_date_t date,
struct tm * out_result )

Convert date to corresponding tm struct.

Parameters
dateThe date value to convert.
[out]out_resultThe output parameter that will hold the tm struct.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_default_system_config()

KUZU_C_API kuzu_system_config kuzu_default_system_config ( )

◆ kuzu_destroy_blob()

KUZU_C_API void kuzu_destroy_blob ( uint8_t * blob)

Destroys any blob created by the Kùzu C API. This function is provided to avoid the inconsistency between the memory allocation and deallocation across different libraries and is preferred over using the standard C free function.

Parameters
blobThe blob to destroy.

◆ kuzu_destroy_string()

KUZU_C_API void kuzu_destroy_string ( char * str)

Destroys any string created by the Kùzu C API, including both the error message and the values returned by the API functions. This function is provided to avoid the inconsistency between the memory allocation and deallocation across different libraries and is preferred over using the standard C free function.

Parameters
strThe string to destroy.

◆ kuzu_flat_tuple_destroy()

KUZU_C_API void kuzu_flat_tuple_destroy ( kuzu_flat_tuple * flat_tuple)

Destroys the given flat tuple instance.

Parameters
flat_tupleThe flat tuple instance to destroy.

◆ kuzu_flat_tuple_get_value()

KUZU_C_API kuzu_state kuzu_flat_tuple_get_value ( kuzu_flat_tuple * flat_tuple,
uint64_t index,
kuzu_value * out_value )

Returns the value at index of the flat tuple.

Parameters
flat_tupleThe flat tuple instance to return.
indexThe index of the value to return.
[out]out_valueThe output parameter that will hold the value at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_flat_tuple_to_string()

KUZU_C_API char * kuzu_flat_tuple_to_string ( kuzu_flat_tuple * flat_tuple)

Converts the flat tuple to a string.

Parameters
flat_tupleThe flat tuple instance to convert.
Returns
The flat tuple as a string.

◆ kuzu_get_storage_version()

KUZU_C_API uint64_t kuzu_get_storage_version ( )

Returns the storage version of the Kùzu library.

◆ kuzu_get_version()

KUZU_C_API char * kuzu_get_version ( )

Returns the version of the Kùzu library.

◆ kuzu_int128_t_from_string()

KUZU_C_API kuzu_state kuzu_int128_t_from_string ( const char * str,
kuzu_int128_t * out_result )

convert a string to int128 value.

Parameters
strThe string to convert.
[out]out_resultThe output parameter that will hold the int128 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_int128_t_to_string()

KUZU_C_API kuzu_state kuzu_int128_t_to_string ( kuzu_int128_t val,
char ** out_result )

convert int128 to corresponding string.

Parameters
valThe int128 value to convert.
[out]out_resultThe output parameter that will hold the string value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_interval_from_difftime()

KUZU_C_API void kuzu_interval_from_difftime ( double difftime,
kuzu_interval_t * out_result )

Convert difftime value in seconds to interval.

Parameters
difftimeThe difftime value to convert.
[out]out_resultThe output parameter that will hold the interval value.

◆ kuzu_interval_to_difftime()

KUZU_C_API void kuzu_interval_to_difftime ( kuzu_interval_t interval,
double * out_result )

Convert interval to corresponding difftime value in seconds.

Parameters
intervalThe interval value to convert.
[out]out_resultThe output parameter that will hold the difftime value.

◆ kuzu_node_val_get_id_val()

KUZU_C_API kuzu_state kuzu_node_val_get_id_val ( kuzu_value * node_val,
kuzu_value * out_value )

Returns the internal id value of the given node value as a kuzu value.

Parameters
node_valThe node value to return.
[out]out_valueThe output parameter that will hold the internal id value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_node_val_get_label_val()

KUZU_C_API kuzu_state kuzu_node_val_get_label_val ( kuzu_value * node_val,
kuzu_value * out_value )

Returns the label value of the given node value as a label value.

Parameters
node_valThe node value to return.
[out]out_valueThe output parameter that will hold the label value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_node_val_get_property_name_at()

KUZU_C_API kuzu_state kuzu_node_val_get_property_name_at ( kuzu_value * node_val,
uint64_t index,
char ** out_result )

Returns the property name of the given node value at the given index.

Parameters
node_valThe node value to return.
indexThe index of the property.
[out]out_resultThe output parameter that will hold the property name at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_node_val_get_property_size()

KUZU_C_API kuzu_state kuzu_node_val_get_property_size ( kuzu_value * node_val,
uint64_t * out_value )

Returns the number of properties of the given node value.

Parameters
node_valThe node value to return.
[out]out_valueThe output parameter that will hold the number of properties.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_node_val_get_property_value_at()

KUZU_C_API kuzu_state kuzu_node_val_get_property_value_at ( kuzu_value * node_val,
uint64_t index,
kuzu_value * out_value )

Returns the property value of the given node value at the given index.

Parameters
node_valThe node value to return.
indexThe index of the property.
[out]out_valueThe output parameter that will hold the property value at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_node_val_to_string()

KUZU_C_API kuzu_state kuzu_node_val_to_string ( kuzu_value * node_val,
char ** out_result )

Converts the given node value to string.

Parameters
node_valThe node value to convert.
[out]out_resultThe output parameter that will hold the node value as a string.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_bool()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_bool ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
bool value )

Binds the given boolean value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe boolean value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_date()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_date ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_date_t value )

Binds the given date value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe date value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_double()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_double ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
double value )

Binds the given double value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe double value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_float()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_float ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
float value )

Binds the given float value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe float value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_int16()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int16 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
int16_t value )

Binds the given int16_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe int16_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_int32()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int32 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
int32_t value )

Binds the given int32_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe int32_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_int64()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int64 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
int64_t value )

Binds the given int64_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe int64_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_int8()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_int8 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
int8_t value )

Binds the given int8_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe int8_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_interval()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_interval ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_interval_t value )

Binds the given interval value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe interval value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_string()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_string ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
const char * value )

Binds the given string value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe string value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_timestamp()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_timestamp_t value )

Binds the given timestamp value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe timestamp value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_timestamp_ms()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_ms ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_timestamp_ms_t value )

Binds the given timestamp_ms value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe timestamp_ms value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_timestamp_ns()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_ns ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_timestamp_ns_t value )

Binds the given timestamp_ns value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe timestamp_ns value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_timestamp_sec()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_sec ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_timestamp_sec_t value )

Binds the given timestamp_sec value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe timestamp_sec value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_timestamp_tz()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_timestamp_tz ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_timestamp_tz_t value )

Binds the given timestamp_tz value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe timestamp_tz value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_uint16()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint16 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
uint16_t value )

Binds the given uint16_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe uint16_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_uint32()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint32 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
uint32_t value )

Binds the given uint32_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe uint32_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_uint64()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint64 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
uint64_t value )

Binds the given uint64_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe uint64_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_uint8()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_uint8 ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
uint8_t value )

Binds the given int8_t value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe int8_t value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_bind_value()

KUZU_C_API kuzu_state kuzu_prepared_statement_bind_value ( kuzu_prepared_statement * prepared_statement,
const char * param_name,
kuzu_value * value )

Binds the given kuzu value to the given parameter name in the prepared statement.

Parameters
prepared_statementThe prepared statement instance to bind the value.
param_nameThe parameter name to bind the value.
valueThe kuzu value to bind.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_prepared_statement_destroy()

KUZU_C_API void kuzu_prepared_statement_destroy ( kuzu_prepared_statement * prepared_statement)

Destroys the prepared statement instance and frees the allocated memory.

Parameters
prepared_statementThe prepared statement instance to destroy.

◆ kuzu_prepared_statement_get_error_message()

KUZU_C_API char * kuzu_prepared_statement_get_error_message ( kuzu_prepared_statement * prepared_statement)
Parameters
prepared_statementThe prepared statement instance.
Returns
the error message if the statement is not prepared successfully.

◆ kuzu_prepared_statement_is_success()

KUZU_C_API bool kuzu_prepared_statement_is_success ( kuzu_prepared_statement * prepared_statement)
Returns
the query is prepared successfully or not.

◆ kuzu_query_result_destroy()

KUZU_C_API void kuzu_query_result_destroy ( kuzu_query_result * query_result)

Destroys the given query result instance.

Parameters
query_resultThe query result instance to destroy.

◆ kuzu_query_result_get_arrow_schema()

KUZU_C_API kuzu_state kuzu_query_result_get_arrow_schema ( kuzu_query_result * query_result,
struct ArrowSchema * out_schema )

Returns the query result's schema as ArrowSchema.

Parameters
query_resultThe query result instance to return.
[out]out_schemaThe output parameter that will hold the datatypes of the columns as an arrow schema.
Returns
The state indicating the success or failure of the operation.

It is the caller's responsibility to call the release function to release the underlying data

◆ kuzu_query_result_get_column_data_type()

KUZU_C_API kuzu_state kuzu_query_result_get_column_data_type ( kuzu_query_result * query_result,
uint64_t index,
kuzu_logical_type * out_column_data_type )

Returns the data type of the column at the given index.

Parameters
query_resultThe query result instance to return.
indexThe index of the column to return data type.
[out]out_column_data_typeThe output parameter that will hold the column data type.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_query_result_get_column_name()

KUZU_C_API kuzu_state kuzu_query_result_get_column_name ( kuzu_query_result * query_result,
uint64_t index,
char ** out_column_name )

Returns the column name at the given index.

Parameters
query_resultThe query result instance to return.
indexThe index of the column to return name.
[out]out_column_nameThe output parameter that will hold the column name.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_query_result_get_error_message()

KUZU_C_API char * kuzu_query_result_get_error_message ( kuzu_query_result * query_result)

Returns the error message if the query is failed.

Parameters
query_resultThe query result instance to check and return error message.
Returns
The error message if the query has failed.

◆ kuzu_query_result_get_next()

KUZU_C_API kuzu_state kuzu_query_result_get_next ( kuzu_query_result * query_result,
kuzu_flat_tuple * out_flat_tuple )

Returns the next tuple in the query result. Throws an exception if there is no more tuple.

Parameters
query_resultThe query result instance to return.
[out]out_flat_tupleThe output parameter that will hold the next tuple.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_query_result_get_next_arrow_chunk()

KUZU_C_API kuzu_state kuzu_query_result_get_next_arrow_chunk ( kuzu_query_result * query_result,
int64_t chunk_size,
struct ArrowArray * out_arrow_array )

Returns the next chunk of the query result as ArrowArray.

Parameters
query_resultThe query result instance to return.
chunk_sizeThe number of tuples to return in the chunk.
[out]out_arrow_arrayThe output parameter that will hold the arrow array representation of the query result. The arrow array internally stores an arrow struct with fields for each of the columns.
Returns
The state indicating the success or failure of the operation.

It is the caller's responsibility to call the release function to release the underlying data

◆ kuzu_query_result_get_next_query_result()

KUZU_C_API kuzu_state kuzu_query_result_get_next_query_result ( kuzu_query_result * query_result,
kuzu_query_result * out_next_query_result )

Returns the next query result. Use this function to loop multiple query statements' results.

Parameters
query_resultThe query result instance to return.
[out]out_next_query_resultThe output parameter that will hold the next query result.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_query_result_get_num_columns()

KUZU_C_API uint64_t kuzu_query_result_get_num_columns ( kuzu_query_result * query_result)

Returns the number of columns in the query result.

Parameters
query_resultThe query result instance to return.

◆ kuzu_query_result_get_num_tuples()

KUZU_C_API uint64_t kuzu_query_result_get_num_tuples ( kuzu_query_result * query_result)

Returns the number of tuples in the query result.

Parameters
query_resultThe query result instance to return.

◆ kuzu_query_result_get_query_summary()

KUZU_C_API kuzu_state kuzu_query_result_get_query_summary ( kuzu_query_result * query_result,
kuzu_query_summary * out_query_summary )

Returns the query summary of the query result.

Parameters
query_resultThe query result instance to return.
[out]out_query_summaryThe output parameter that will hold the query summary.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_query_result_has_next()

KUZU_C_API bool kuzu_query_result_has_next ( kuzu_query_result * query_result)

Returns true if we have not consumed all tuples in the query result, false otherwise.

Parameters
query_resultThe query result instance to check.

◆ kuzu_query_result_has_next_query_result()

KUZU_C_API bool kuzu_query_result_has_next_query_result ( kuzu_query_result * query_result)

Returns true if we have not consumed all query results, false otherwise. Use this function for loop results of multiple query statements.

Parameters
query_resultThe query result instance to check.

◆ kuzu_query_result_is_success()

KUZU_C_API bool kuzu_query_result_is_success ( kuzu_query_result * query_result)

Returns true if the query is executed successful, false otherwise.

Parameters
query_resultThe query result instance to check.

◆ kuzu_query_result_reset_iterator()

KUZU_C_API void kuzu_query_result_reset_iterator ( kuzu_query_result * query_result)

Resets the iterator of the query result to the beginning of the query result.

Parameters
query_resultThe query result instance to reset iterator.

◆ kuzu_query_result_to_string()

KUZU_C_API char * kuzu_query_result_to_string ( kuzu_query_result * query_result)

Returns the query result as a string.

Parameters
query_resultThe query result instance to return.
Returns
The query result as a string.

◆ kuzu_query_summary_destroy()

KUZU_C_API void kuzu_query_summary_destroy ( kuzu_query_summary * query_summary)

Destroys the given query summary.

Parameters
query_summaryThe query summary to destroy.

◆ kuzu_query_summary_get_compiling_time()

KUZU_C_API double kuzu_query_summary_get_compiling_time ( kuzu_query_summary * query_summary)

Returns the compilation time of the given query summary in milliseconds.

Parameters
query_summaryThe query summary to get compilation time.

◆ kuzu_query_summary_get_execution_time()

KUZU_C_API double kuzu_query_summary_get_execution_time ( kuzu_query_summary * query_summary)

Returns the execution time of the given query summary in milliseconds.

Parameters
query_summaryThe query summary to get execution time.

◆ kuzu_rel_val_get_dst_id_val()

KUZU_C_API kuzu_state kuzu_rel_val_get_dst_id_val ( kuzu_value * rel_val,
kuzu_value * out_value )

Returns the internal id value of the destination node of the given rel value as a kuzu value.

Parameters
rel_valThe rel value to return.
[out]out_valueThe output parameter that will hold the internal id value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_rel_val_get_label_val()

KUZU_C_API kuzu_state kuzu_rel_val_get_label_val ( kuzu_value * rel_val,
kuzu_value * out_value )

Returns the label value of the given rel value.

Parameters
rel_valThe rel value to return.
[out]out_valueThe output parameter that will hold the label value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_rel_val_get_property_name_at()

KUZU_C_API kuzu_state kuzu_rel_val_get_property_name_at ( kuzu_value * rel_val,
uint64_t index,
char ** out_result )

Returns the property name of the given rel value at the given index.

Parameters
rel_valThe rel value to return.
indexThe index of the property.
[out]out_resultThe output parameter that will hold the property name at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_rel_val_get_property_size()

KUZU_C_API kuzu_state kuzu_rel_val_get_property_size ( kuzu_value * rel_val,
uint64_t * out_value )

Returns the number of properties of the given rel value.

Parameters
rel_valThe rel value to return.
[out]out_valueThe output parameter that will hold the number of properties.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_rel_val_get_property_value_at()

KUZU_C_API kuzu_state kuzu_rel_val_get_property_value_at ( kuzu_value * rel_val,
uint64_t index,
kuzu_value * out_value )

Returns the property of the given rel value at the given index as kuzu value.

Parameters
rel_valThe rel value to return.
indexThe index of the property.
[out]out_valueThe output parameter that will hold the property value at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_rel_val_get_src_id_val()

KUZU_C_API kuzu_state kuzu_rel_val_get_src_id_val ( kuzu_value * rel_val,
kuzu_value * out_value )

Returns the internal id value of the source node of the given rel value as a kuzu value.

Parameters
rel_valThe rel value to return.
[out]out_valueThe output parameter that will hold the internal id value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_rel_val_to_string()

KUZU_C_API kuzu_state kuzu_rel_val_to_string ( kuzu_value * rel_val,
char ** out_result )

Converts the given rel value to string.

Parameters
rel_valThe rel value to convert.
[out]out_resultThe output parameter that will hold the rel value as a string.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_from_tm()

KUZU_C_API kuzu_state kuzu_timestamp_from_tm ( struct tm tm,
kuzu_timestamp_t * out_result )

Convert timestamp_ns to corresponding string.

Parameters
timestampThe timestamp_ns value to convert.
[out]out_resultThe output parameter that will hold the string value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_ms_from_tm()

KUZU_C_API kuzu_state kuzu_timestamp_ms_from_tm ( struct tm tm,
kuzu_timestamp_ms_t * out_result )

Convert tm struct to timestamp_ms value.

Parameters
tmThe tm struct to convert.
[out]out_resultThe output parameter that will hold the timestamp_ms value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_ms_to_tm()

KUZU_C_API kuzu_state kuzu_timestamp_ms_to_tm ( kuzu_timestamp_ms_t timestamp,
struct tm * out_result )

Convert timestamp_ms to corresponding tm struct.

Parameters
timestampThe timestamp_ms value to convert.
[out]out_resultThe output parameter that will hold the tm struct.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_ns_from_tm()

KUZU_C_API kuzu_state kuzu_timestamp_ns_from_tm ( struct tm tm,
kuzu_timestamp_ns_t * out_result )

Convert tm struct to timestamp_ns value.

Parameters
tmThe tm struct to convert.
[out]out_resultThe output parameter that will hold the timestamp_ns value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_ns_to_tm()

KUZU_C_API kuzu_state kuzu_timestamp_ns_to_tm ( kuzu_timestamp_ns_t timestamp,
struct tm * out_result )

Convert timestamp_ns to corresponding tm struct.

Parameters
timestampThe timestamp_ns value to convert.
[out]out_resultThe output parameter that will hold the tm struct.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_sec_from_tm()

KUZU_C_API kuzu_state kuzu_timestamp_sec_from_tm ( struct tm tm,
kuzu_timestamp_sec_t * out_result )

Convert tm struct to timestamp_sec value.

Parameters
tmThe tm struct to convert.
[out]out_resultThe output parameter that will hold the timestamp_sec value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_sec_to_tm()

KUZU_C_API kuzu_state kuzu_timestamp_sec_to_tm ( kuzu_timestamp_sec_t timestamp,
struct tm * out_result )

Convert timestamp_sec to corresponding tm struct.

Parameters
timestampThe timestamp_sec value to convert.
[out]out_resultThe output parameter that will hold the tm struct.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_to_tm()

KUZU_C_API kuzu_state kuzu_timestamp_to_tm ( kuzu_timestamp_t timestamp,
struct tm * out_result )

Convert timestamp to corresponding tm struct.

Parameters
timestampThe timestamp value to convert.
[out]out_resultThe output parameter that will hold the tm struct.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_tz_from_tm()

KUZU_C_API kuzu_state kuzu_timestamp_tz_from_tm ( struct tm tm,
kuzu_timestamp_tz_t * out_result )

Convert tm struct to timestamp_tz value.

Parameters
tmThe tm struct to convert.
[out]out_resultThe output parameter that will hold the timestamp_tz value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_timestamp_tz_to_tm()

KUZU_C_API kuzu_state kuzu_timestamp_tz_to_tm ( kuzu_timestamp_tz_t timestamp,
struct tm * out_result )

Convert timestamp_tz to corresponding tm struct.

Parameters
timestampThe timestamp_tz value to convert.
[out]out_resultThe output parameter that will hold the tm struct.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_clone()

KUZU_C_API kuzu_value * kuzu_value_clone ( kuzu_value * value)

Creates a new value based on the given value. Caller is responsible for destroying the returned value.

Parameters
valueThe value to create from.

◆ kuzu_value_copy()

KUZU_C_API void kuzu_value_copy ( kuzu_value * value,
kuzu_value * other )

Copies the other value to the value.

Parameters
valueThe value to copy to.
otherThe value to copy from.

◆ kuzu_value_create_bool()

KUZU_C_API kuzu_value * kuzu_value_create_bool ( bool val_)

Creates a value with boolean type and the given bool value. Caller is responsible for destroying the returned value.

Parameters
val_The bool value of the value to create.

◆ kuzu_value_create_date()

KUZU_C_API kuzu_value * kuzu_value_create_date ( kuzu_date_t val_)

Creates a value with date type and the given date value. Caller is responsible for destroying the returned value.

Parameters
val_The date value of the value to create.

◆ kuzu_value_create_default()

KUZU_C_API kuzu_value * kuzu_value_create_default ( kuzu_logical_type * data_type)

Creates a value of the given data type with default non-NULL value. Caller is responsible for destroying the returned value.

Parameters
data_typeThe data type of the value to create.

◆ kuzu_value_create_double()

KUZU_C_API kuzu_value * kuzu_value_create_double ( double val_)

Creates a value with double type and the given double value. Caller is responsible for destroying the returned value.

Parameters
val_The double value of the value to create.

◆ kuzu_value_create_float()

KUZU_C_API kuzu_value * kuzu_value_create_float ( float val_)

Creates a value with float type and the given float value. Caller is responsible for destroying the returned value.

Parameters
val_The float value of the value to create.

◆ kuzu_value_create_int128()

KUZU_C_API kuzu_value * kuzu_value_create_int128 ( kuzu_int128_t val_)

Creates a value with int128 type and the given int128 value. Caller is responsible for destroying the returned value.

Parameters
val_The int128 value of the value to create.

◆ kuzu_value_create_int16()

KUZU_C_API kuzu_value * kuzu_value_create_int16 ( int16_t val_)

Creates a value with int16 type and the given int16 value. Caller is responsible for destroying the returned value.

Parameters
val_The int16 value of the value to create.

◆ kuzu_value_create_int32()

KUZU_C_API kuzu_value * kuzu_value_create_int32 ( int32_t val_)

Creates a value with int32 type and the given int32 value. Caller is responsible for destroying the returned value.

Parameters
val_The int32 value of the value to create.

◆ kuzu_value_create_int64()

KUZU_C_API kuzu_value * kuzu_value_create_int64 ( int64_t val_)

Creates a value with int64 type and the given int64 value. Caller is responsible for destroying the returned value.

Parameters
val_The int64 value of the value to create.

◆ kuzu_value_create_int8()

KUZU_C_API kuzu_value * kuzu_value_create_int8 ( int8_t val_)

Creates a value with int8 type and the given int8 value. Caller is responsible for destroying the returned value.

Parameters
val_The int8 value of the value to create.

◆ kuzu_value_create_internal_id()

KUZU_C_API kuzu_value * kuzu_value_create_internal_id ( kuzu_internal_id_t val_)

Creates a value with internal_id type and the given internal_id value. Caller is responsible for destroying the returned value.

Parameters
val_The internal_id value of the value to create.

◆ kuzu_value_create_interval()

KUZU_C_API kuzu_value * kuzu_value_create_interval ( kuzu_interval_t val_)

Creates a value with interval type and the given interval value. Caller is responsible for destroying the returned value.

Parameters
val_The interval value of the value to create.

◆ kuzu_value_create_list()

KUZU_C_API kuzu_state kuzu_value_create_list ( uint64_t num_elements,
kuzu_value ** elements,
kuzu_value ** out_value )

Creates a list value with the given number of elements and the given elements. The caller needs to make sure that all elements have the same type. The elements are copied into the list value, so destroying the elements after creating the list value is safe. Caller is responsible for destroying the returned value.

Parameters
num_elementsThe number of elements in the list.
elementsThe elements of the list.
[out]out_valueThe output parameter that will hold a pointer to the created list value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_create_map()

KUZU_C_API kuzu_state kuzu_value_create_map ( uint64_t num_fields,
kuzu_value ** keys,
kuzu_value ** values,
kuzu_value ** out_value )

Creates a map value with the given number of fields and the given keys and values. The caller needs to make sure that all keys are unique, and all keys and values have the same type. The keys and values are copied into the map value, so destroying the keys and values after creating the map value is safe. Caller is responsible for destroying the returned value.

Parameters
num_fieldsThe number of fields in the map.
keysThe keys of the map.
valuesThe values of the map.
[out]out_valueThe output parameter that will hold a pointer to the created map value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_create_null()

KUZU_C_API kuzu_value * kuzu_value_create_null ( )

Creates a NULL value of ANY type. Caller is responsible for destroying the returned value.

◆ kuzu_value_create_null_with_data_type()

KUZU_C_API kuzu_value * kuzu_value_create_null_with_data_type ( kuzu_logical_type * data_type)

Creates a value of the given data type. Caller is responsible for destroying the returned value.

Parameters
data_typeThe data type of the value to create.

◆ kuzu_value_create_string()

KUZU_C_API kuzu_value * kuzu_value_create_string ( const char * val_)

Creates a value with string type and the given string value. Caller is responsible for destroying the returned value.

Parameters
val_The string value of the value to create.

◆ kuzu_value_create_struct()

KUZU_C_API kuzu_state kuzu_value_create_struct ( uint64_t num_fields,
const char ** field_names,
kuzu_value ** field_values,
kuzu_value ** out_value )

Creates a struct value with the given number of fields and the given field names and values. The caller needs to make sure that all field names are unique. The field names and values are copied into the struct value, so destroying the field names and values after creating the struct value is safe. Caller is responsible for destroying the returned value.

Parameters
num_fieldsThe number of fields in the struct.
field_namesThe field names of the struct.
field_valuesThe field values of the struct.
[out]out_valueThe output parameter that will hold a pointer to the created struct value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_create_timestamp()

KUZU_C_API kuzu_value * kuzu_value_create_timestamp ( kuzu_timestamp_t val_)

Creates a value with timestamp type and the given timestamp value. Caller is responsible for destroying the returned value.

Parameters
val_The timestamp value of the value to create.

◆ kuzu_value_create_timestamp_ms()

KUZU_C_API kuzu_value * kuzu_value_create_timestamp_ms ( kuzu_timestamp_ms_t val_)

Creates a value with timestamp_ms type and the given timestamp value. Caller is responsible for destroying the returned value.

Parameters
val_The timestamp_ms value of the value to create.

◆ kuzu_value_create_timestamp_ns()

KUZU_C_API kuzu_value * kuzu_value_create_timestamp_ns ( kuzu_timestamp_ns_t val_)

Creates a value with timestamp_ns type and the given timestamp value. Caller is responsible for destroying the returned value.

Parameters
val_The timestamp_ns value of the value to create.

◆ kuzu_value_create_timestamp_sec()

KUZU_C_API kuzu_value * kuzu_value_create_timestamp_sec ( kuzu_timestamp_sec_t val_)

Creates a value with timestamp_sec type and the given timestamp value. Caller is responsible for destroying the returned value.

Parameters
val_The timestamp_sec value of the value to create.

◆ kuzu_value_create_timestamp_tz()

KUZU_C_API kuzu_value * kuzu_value_create_timestamp_tz ( kuzu_timestamp_tz_t val_)

Creates a value with timestamp_tz type and the given timestamp value. Caller is responsible for destroying the returned value.

Parameters
val_The timestamp_tz value of the value to create.

◆ kuzu_value_create_uint16()

KUZU_C_API kuzu_value * kuzu_value_create_uint16 ( uint16_t val_)

Creates a value with uint16 type and the given uint16 value. Caller is responsible for destroying the returned value.

Parameters
val_The uint16 value of the value to create.

◆ kuzu_value_create_uint32()

KUZU_C_API kuzu_value * kuzu_value_create_uint32 ( uint32_t val_)

Creates a value with uint32 type and the given uint32 value. Caller is responsible for destroying the returned value.

Parameters
val_The uint32 value of the value to create.

◆ kuzu_value_create_uint64()

KUZU_C_API kuzu_value * kuzu_value_create_uint64 ( uint64_t val_)

Creates a value with uint64 type and the given uint64 value. Caller is responsible for destroying the returned value.

Parameters
val_The uint64 value of the value to create.

◆ kuzu_value_create_uint8()

KUZU_C_API kuzu_value * kuzu_value_create_uint8 ( uint8_t val_)

Creates a value with uint8 type and the given uint8 value. Caller is responsible for destroying the returned value.

Parameters
val_The uint8 value of the value to create.

◆ kuzu_value_destroy()

KUZU_C_API void kuzu_value_destroy ( kuzu_value * value)

Destroys the value.

Parameters
valueThe value to destroy.

◆ kuzu_value_get_blob()

KUZU_C_API kuzu_state kuzu_value_get_blob ( kuzu_value * value,
uint8_t ** out_result )

Returns the blob value of the given value. The returned buffer is null-terminated similar to a string. The value must be of type BLOB.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the blob value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_bool()

KUZU_C_API kuzu_state kuzu_value_get_bool ( kuzu_value * value,
bool * out_result )

Returns the boolean value of the given value. The value must be of type BOOL.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the boolean value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_data_type()

KUZU_C_API void kuzu_value_get_data_type ( kuzu_value * value,
kuzu_logical_type * out_type )

Returns internal type of the given value.

Parameters
valueThe value to return.
[out]out_typeThe output parameter that will hold the internal type of the value.

◆ kuzu_value_get_date()

KUZU_C_API kuzu_state kuzu_value_get_date ( kuzu_value * value,
kuzu_date_t * out_result )

Returns the date value of the given value. The value must be of type DATE.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the date value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_decimal_as_string()

KUZU_C_API kuzu_state kuzu_value_get_decimal_as_string ( kuzu_value * value,
char ** out_result )

Returns the decimal value of the given value as a string. The value must be of type DECIMAL.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the decimal value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_double()

KUZU_C_API kuzu_state kuzu_value_get_double ( kuzu_value * value,
double * out_result )

Returns the double value of the given value. The value must be of type DOUBLE.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the double value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_float()

KUZU_C_API kuzu_state kuzu_value_get_float ( kuzu_value * value,
float * out_result )

Returns the float value of the given value. The value must be of type FLOAT.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the float value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_int128()

KUZU_C_API kuzu_state kuzu_value_get_int128 ( kuzu_value * value,
kuzu_int128_t * out_result )

Returns the int128 value of the given value. The value must be of type INT128.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the int128 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_int16()

KUZU_C_API kuzu_state kuzu_value_get_int16 ( kuzu_value * value,
int16_t * out_result )

Returns the int16 value of the given value. The value must be of type INT16.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the int16 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_int32()

KUZU_C_API kuzu_state kuzu_value_get_int32 ( kuzu_value * value,
int32_t * out_result )

Returns the int32 value of the given value. The value must be of type INT32.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the int32 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_int64()

KUZU_C_API kuzu_state kuzu_value_get_int64 ( kuzu_value * value,
int64_t * out_result )

Returns the int64 value of the given value. The value must be of type INT64 or SERIAL.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the int64 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_int8()

KUZU_C_API kuzu_state kuzu_value_get_int8 ( kuzu_value * value,
int8_t * out_result )

Returns the int8 value of the given value. The value must be of type INT8.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the int8 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_internal_id()

KUZU_C_API kuzu_state kuzu_value_get_internal_id ( kuzu_value * value,
kuzu_internal_id_t * out_result )

Returns the internal id value of the given value. The value must be of type INTERNAL_ID.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the internal id value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_interval()

KUZU_C_API kuzu_state kuzu_value_get_interval ( kuzu_value * value,
kuzu_interval_t * out_result )

Returns the interval value of the given value. The value must be of type INTERVAL.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the interval value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_list_element()

KUZU_C_API kuzu_state kuzu_value_get_list_element ( kuzu_value * value,
uint64_t index,
kuzu_value * out_value )

Returns the element at index of the given value. The value must be of type LIST.

Parameters
valueThe LIST value to return.
indexThe index of the element to return.
[out]out_valueThe output parameter that will hold the element at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_list_size()

KUZU_C_API kuzu_state kuzu_value_get_list_size ( kuzu_value * value,
uint64_t * out_result )

Returns the number of elements per list of the given value. The value must be of type ARRAY.

Parameters
valueThe ARRAY value to get list size.
[out]out_resultThe output parameter that will hold the number of elements per list.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_map_key()

KUZU_C_API kuzu_state kuzu_value_get_map_key ( kuzu_value * value,
uint64_t index,
kuzu_value * out_key )

Returns the key at index of the given map value. The value must be of physical type MAP.

Parameters
valueThe MAP value to get key.
indexThe index of the field name to return.
[out]out_keyThe output parameter that will hold the key at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_map_size()

KUZU_C_API kuzu_state kuzu_value_get_map_size ( kuzu_value * value,
uint64_t * out_result )

Returns the size of the given map value. The value must be of type MAP.

Parameters
valueThe MAP value to get size.
[out]out_resultThe output parameter that will hold the size of the map.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_map_value()

KUZU_C_API kuzu_state kuzu_value_get_map_value ( kuzu_value * value,
uint64_t index,
kuzu_value * out_value )

Returns the field value at index of the given map value. The value must be of physical type MAP.

Parameters
valueThe MAP value to get field value.
indexThe index of the field value to return.
[out]out_valueThe output parameter that will hold the field value at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_recursive_rel_node_list()

KUZU_C_API kuzu_state kuzu_value_get_recursive_rel_node_list ( kuzu_value * value,
kuzu_value * out_value )

Returns the list of nodes for recursive rel value. The value must be of type RECURSIVE_REL.

Parameters
valueThe RECURSIVE_REL value to return.
[out]out_valueThe output parameter that will hold the list of nodes.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_recursive_rel_rel_list()

KUZU_C_API kuzu_state kuzu_value_get_recursive_rel_rel_list ( kuzu_value * value,
kuzu_value * out_value )

Returns the list of rels for recursive rel value. The value must be of type RECURSIVE_REL.

Parameters
valueThe RECURSIVE_REL value to return.
[out]out_valueThe output parameter that will hold the list of rels.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_string()

KUZU_C_API kuzu_state kuzu_value_get_string ( kuzu_value * value,
char ** out_result )

Returns the string value of the given value. The value must be of type STRING.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the string value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_struct_field_name()

KUZU_C_API kuzu_state kuzu_value_get_struct_field_name ( kuzu_value * value,
uint64_t index,
char ** out_result )

Returns the field name at index of the given struct value. The value must be of physical type STRUCT (STRUCT, NODE, REL, RECURSIVE_REL, UNION).

Parameters
valueThe STRUCT value to get field name.
indexThe index of the field name to return.
[out]out_resultThe output parameter that will hold the field name at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_struct_field_value()

KUZU_C_API kuzu_state kuzu_value_get_struct_field_value ( kuzu_value * value,
uint64_t index,
kuzu_value * out_value )

Returns the field value at index of the given struct value. The value must be of physical type STRUCT (STRUCT, NODE, REL, RECURSIVE_REL, UNION).

Parameters
valueThe STRUCT value to get field value.
indexThe index of the field value to return.
[out]out_valueThe output parameter that will hold the field value at index.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_struct_num_fields()

KUZU_C_API kuzu_state kuzu_value_get_struct_num_fields ( kuzu_value * value,
uint64_t * out_result )

Returns the number of fields of the given struct value. The value must be of type STRUCT.

Parameters
valueThe STRUCT value to get number of fields.
[out]out_resultThe output parameter that will hold the number of fields.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_timestamp()

KUZU_C_API kuzu_state kuzu_value_get_timestamp ( kuzu_value * value,
kuzu_timestamp_t * out_result )

Returns the timestamp value of the given value. The value must be of type TIMESTAMP.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the timestamp value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_timestamp_ms()

KUZU_C_API kuzu_state kuzu_value_get_timestamp_ms ( kuzu_value * value,
kuzu_timestamp_ms_t * out_result )

Returns the timestamp_ms value of the given value. The value must be of type TIMESTAMP_MS.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the timestamp_ms value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_timestamp_ns()

KUZU_C_API kuzu_state kuzu_value_get_timestamp_ns ( kuzu_value * value,
kuzu_timestamp_ns_t * out_result )

Returns the timestamp_ns value of the given value. The value must be of type TIMESTAMP_NS.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the timestamp_ns value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_timestamp_sec()

KUZU_C_API kuzu_state kuzu_value_get_timestamp_sec ( kuzu_value * value,
kuzu_timestamp_sec_t * out_result )

Returns the timestamp_sec value of the given value. The value must be of type TIMESTAMP_SEC.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the timestamp_sec value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_timestamp_tz()

KUZU_C_API kuzu_state kuzu_value_get_timestamp_tz ( kuzu_value * value,
kuzu_timestamp_tz_t * out_result )

Returns the timestamp_tz value of the given value. The value must be of type TIMESTAMP_TZ.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the timestamp_tz value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_uint16()

KUZU_C_API kuzu_state kuzu_value_get_uint16 ( kuzu_value * value,
uint16_t * out_result )

Returns the uint16 value of the given value. The value must be of type UINT16.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the uint16 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_uint32()

KUZU_C_API kuzu_state kuzu_value_get_uint32 ( kuzu_value * value,
uint32_t * out_result )

Returns the uint32 value of the given value. The value must be of type UINT32.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the uint32 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_uint64()

KUZU_C_API kuzu_state kuzu_value_get_uint64 ( kuzu_value * value,
uint64_t * out_result )

Returns the uint64 value of the given value. The value must be of type UINT64.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the uint64 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_uint8()

KUZU_C_API kuzu_state kuzu_value_get_uint8 ( kuzu_value * value,
uint8_t * out_result )

Returns the uint8 value of the given value. The value must be of type UINT8.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the uint8 value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_get_uuid()

KUZU_C_API kuzu_state kuzu_value_get_uuid ( kuzu_value * value,
char ** out_result )

Returns the uuid value of the given value. to a string. The value must be of type UUID.

Parameters
valueThe value to return.
[out]out_resultThe output parameter that will hold the uuid value.
Returns
The state indicating the success or failure of the operation.

◆ kuzu_value_is_null()

KUZU_C_API bool kuzu_value_is_null ( kuzu_value * value)

Returns true if the given value is NULL, false otherwise.

Parameters
valueThe value instance to check.

◆ kuzu_value_set_null()

KUZU_C_API void kuzu_value_set_null ( kuzu_value * value,
bool is_null )

Sets the given value to NULL or not.

Parameters
valueThe value instance to set.
is_nullTrue if sets the value to NULL, false otherwise.

◆ kuzu_value_to_string()

KUZU_C_API char * kuzu_value_to_string ( kuzu_value * value)

Converts the given value to string.

Parameters
valueThe value to convert.
Returns
The value as a string.