1 files changed, 128 insertions, 0 deletions
diff --git a/examples/execute-string.c b/examples/execute-string.c
new file mode 100644
index 0000000..c51a600
--- /dev/null
+++ b/examples/execute-string.c
@@ -0,0 +1,128 @@
+/*
+ * Copyright (C) 2021 Jo-Philipp Wich <jo@mein.io>
+ *
+ * Permission to use, copy, modify, and/or distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ */
+
+/*
+ * Example to compile a C string into an ucode program.
+ * Build with  gcc -o execute-string -lucode execute-string.c
+ */
+
+#include <stdio.h>
+
+#include <ucode/compiler.h>
+#include <ucode/lib.h>
+#include <ucode/vm.h>
+
+
+#define MULTILINE_STRING(...) #__VA_ARGS__
+
+static const char *program = MULTILINE_STRING(
+	{%
+		function add(a, b) {
+			c = a + b;
+
+			return c;
+		}
+
+		result = add(x, y);
+
+		printf('%d + %d is %d\n', x, y, result);
+
+		return result;
+	%}
+);
+
+static uc_parse_config_t config = {
+	.strict_declarations = false,
+	.lstrip_blocks = true,
+	.trim_blocks = true
+};
+
+int main(int argc, char **argv)
+{
+	int exit_code = 0;
+
+	/* create a source buffer containing the program code */
+	uc_source_t *src = uc_source_new_buffer("my program", strdup(program), strlen(program));
+
+	/* compile source buffer into function */
+	char *syntax_error = NULL;
+	uc_function_t *progfunc = uc_compile(&config, src, &syntax_error);
+
+	/* release source buffer */
+	uc_source_put(src);
+
+	/* check if compilation failed */
+	if (!progfunc) {
+		fprintf(stderr, "Failed to compile program: %s\n", syntax_error);
+
+		return 1;
+	}
+
+	/* initialize VM context */
+	uc_vm_t vm = { 0 };
+	uc_vm_init(&vm, &config);
+
+	/* load standard library into global VM scope */
+	uc_load_stdlib(uc_vm_scope_get(&vm));
+
+	/* add global variables x and y to VM scope */
+	ucv_object_add(uc_vm_scope_get(&vm), "x", ucv_int64_new(123));
+	ucv_object_add(uc_vm_scope_get(&vm), "y", ucv_int64_new(456));
+
+	/* execute compiled program function */
+	uc_value_t *last_expression_result = NULL;
+	int return_code = uc_vm_execute(&vm, progfunc, &last_expression_result);
+
+	/* handle return status */
+	switch (return_code) {
+	case STATUS_OK:
+		exit_code = 0;
+
+		char *s = ucv_to_string(&vm, last_expression_result);
+
+		printf("Program finished successfully.\n");
+		printf("Function return value is %s\n", s);
+		free(s);
+		break;
+
+	case STATUS_EXIT:
+		exit_code = (int)ucv_int64_get(last_expression_result);
+
+		printf("The invoked program called exit().\n");
+		printf("Exit code is %d\n", exit_code);
+		break;
+
+	case ERROR_COMPILE:
+		exit_code = 1;
+
+		printf("A compilation error occurred while running the program\n");
+		break;
+
+	case ERROR_RUNTIME:
+		exit_code = 2;
+
+		printf("A runtime error occurred while running the program\n");
+		break;
+	}
+
+	/* free last expression result */
+	ucv_put(last_expression_result);
+
+	/* free VM context */
+	uc_vm_free(&vm);
+
+	return exit_code;
+}