value.h

Go to the documentation of this file.

/*
 * This file is part of the Fun programming language.
 * https://fun-lang.xyz/
 *
 * Copyright 2025 Johannes Findeisen <you@hanez.org>
 * Licensed under the terms of the Apache-2.0 license.
 * https://opensource.org/license/apache-2-0
 */


#ifndef FUN_VALUE_H
#define FUN_VALUE_H

#include <inttypes.h>

struct Bytecode; /* forward */
struct Array; /* forward */
struct Map; /* forward */

typedef enum {
 VAL_INT,
 VAL_BOOL,
 VAL_STRING,
 VAL_FUNCTION,
 VAL_ARRAY,
 VAL_MAP,
 VAL_NIL,
 VAL_FLOAT
} ValueType;

typedef struct {
 ValueType type;
 union {
 int64_t i;
 double d;
 char *s;
 struct Bytecode *fn;
 struct Array *arr;
 struct Map *map;
 };
} Value;

/* constructors / helpers */
Value make_int(int64_t v);
Value make_bool(int v);
Value make_string(const char *s);
Value make_function(struct Bytecode *fn);
Value make_nil(void);
Value make_float(double v);

/* arrays */
Value make_array_from_values(const Value *vals, int count);
int array_length(const Value *v);
int array_get_copy(const Value *v, int index, Value *out);
int array_set(Value *v, int index, Value newElem);
int array_push(Value *v, Value newElem);
int array_pop(Value *v, Value *out);
int array_insert(Value *v, int index, Value newElem);
int array_remove(Value *v, int index, Value *out);
Value array_slice(const Value *v, int start, int end);
Value array_concat(const Value *a, const Value *b);

/* maps (string keys) */
Value make_map_empty(void);
int map_set(Value *m, const char *key, Value v);
int map_get_copy(const Value *m, const char *key, Value *out);
int map_has(const Value *m, const char *key);
Value map_keys_array(const Value *m);
Value map_values_array(const Value *m);

/* copy/free */
Value copy_value(const Value *v);
Value deep_copy_value(const Value *v);
void free_value(Value v);

/* utilities */
void print_value(const Value *v);
int value_is_truthy(const Value *v);
int value_equals(const Value *a, const Value *b);

/* stringify into a newly-allocated C string; caller must free */
char *value_to_string_alloc(const Value *v);

/* array utils */
int array_contains(const Value *arr, const Value *needle);
int array_index_of(const Value *arr, const Value *needle);
void array_clear(Value *arr);

/* string helpers returning newly allocated C strings or arrays */
char *string_substr(const char *s, int start, int len);
int string_find(const char *hay, const char *needle);
Value string_split_to_array(const char *s, const char *sep);
char *array_join_with_sep(const Value *arr, const char *sep);

#endif