363 lines
12 KiB
C
363 lines
12 KiB
C
/**
|
|
* Copyright (c) 2013-2017 Picrin developers.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining
|
|
* a copy of this software and associated documentation files (the
|
|
* "Software"), to deal in the Software without restriction, including
|
|
* without limitation the rights to use, copy, modify, merge, publish,
|
|
* distribute, sublicense, and/or sell copies of the Software, and to
|
|
* permit persons to whom the Software is furnished to do so, subject to
|
|
* the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
|
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
|
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*/
|
|
|
|
#ifndef PICRIN_H
|
|
#define PICRIN_H
|
|
|
|
#if defined(__cplusplus)
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stddef.h>
|
|
#include <limits.h>
|
|
#include <stdarg.h>
|
|
|
|
#include "picrin/setup.h"
|
|
|
|
typedef struct pic_state pic_state;
|
|
|
|
typedef struct {
|
|
#if PIC_NAN_BOXING
|
|
uint64_t v;
|
|
#else
|
|
union {
|
|
void *data;
|
|
double f;
|
|
int i;
|
|
char c;
|
|
} u;
|
|
unsigned char type;
|
|
#endif
|
|
} pic_value;
|
|
|
|
|
|
#include "picrin/value.h" /* inline definitions */
|
|
|
|
|
|
/*
|
|
* state manipulation
|
|
*/
|
|
|
|
typedef void *(*pic_allocf)(void *userdata, void *ptr, size_t n);
|
|
pic_state *pic_open(pic_allocf f, void *userdata);
|
|
void pic_close(pic_state *);
|
|
|
|
|
|
/*
|
|
* memory management
|
|
*/
|
|
|
|
void *pic_malloc(pic_state *, size_t);
|
|
void *pic_realloc(pic_state *, void *, size_t);
|
|
void *pic_calloc(pic_state *, size_t, size_t);
|
|
void pic_free(pic_state *, void *);
|
|
/* for managed area: */
|
|
size_t pic_enter(pic_state *);
|
|
void pic_leave(pic_state *, size_t);
|
|
pic_value pic_protect(pic_state *, pic_value);
|
|
void *pic_alloca(pic_state *, size_t);
|
|
void pic_gc(pic_state *);
|
|
|
|
|
|
/*
|
|
* comparison
|
|
*/
|
|
|
|
bool pic_eq_p(pic_state *, pic_value, pic_value);
|
|
bool pic_eqv_p(pic_state *, pic_value, pic_value);
|
|
bool pic_equal_p(pic_state *, pic_value, pic_value);
|
|
|
|
|
|
/*
|
|
* number, boolean, character, string, bytevector, and userdata
|
|
*/
|
|
|
|
typedef struct {
|
|
const char *type_name;
|
|
void (*dtor)(pic_state *, void *);
|
|
} pic_data_type;
|
|
|
|
bool pic_int_p(pic_state *, pic_value);
|
|
bool pic_float_p(pic_state *, pic_value);
|
|
bool pic_char_p(pic_state *, pic_value);
|
|
bool pic_true_p(pic_state *, pic_value);
|
|
bool pic_false_p(pic_state *, pic_value);
|
|
bool pic_bool_p(pic_state *, pic_value);
|
|
bool pic_str_p(pic_state *, pic_value);
|
|
bool pic_blob_p(pic_state *, pic_value);
|
|
bool pic_data_p(pic_state *, pic_value, const pic_data_type *);
|
|
/* constructors */
|
|
pic_value pic_undef_value(pic_state *);
|
|
pic_value pic_int_value(pic_state *, int);
|
|
pic_value pic_float_value(pic_state *, double);
|
|
pic_value pic_char_value(pic_state *, char);
|
|
pic_value pic_bool_value(pic_state *, bool);
|
|
pic_value pic_true_value(pic_state *);
|
|
pic_value pic_false_value(pic_state *);
|
|
pic_value pic_str_value(pic_state *, const char *str, int len);
|
|
pic_value pic_cstr_value(pic_state *, const char *str);
|
|
#define pic_lit_value(pic, lit) pic_str_value(pic, "" lit, -((int)sizeof lit - 1))
|
|
pic_value pic_strf_value(pic_state *, const char *fmt, ...);
|
|
pic_value pic_vstrf_value(pic_state *, const char *fmt, va_list ap);
|
|
pic_value pic_blob_value(pic_state *, const unsigned char *buf, int len);
|
|
pic_value pic_data_value(pic_state *, void *ptr, const pic_data_type *type);
|
|
/* destructors */
|
|
int pic_int(pic_state *, pic_value i);
|
|
double pic_float(pic_state *, pic_value f);
|
|
char pic_char(pic_state *, pic_value c);
|
|
#define pic_bool(pic,b) (! pic_false_p(pic, b))
|
|
const char *pic_str(pic_state *, pic_value str, int *len);
|
|
unsigned char *pic_blob(pic_state *, pic_value blob, int *len);
|
|
void *pic_data(pic_state *, pic_value data);
|
|
|
|
|
|
/*
|
|
* pair
|
|
*/
|
|
|
|
bool pic_pair_p(pic_state *, pic_value);
|
|
pic_value pic_cons(pic_state *, pic_value car, pic_value cdr);
|
|
pic_value pic_car(pic_state *, pic_value pair);
|
|
pic_value pic_cdr(pic_state *, pic_value pair);
|
|
void pic_set_car(pic_state *, pic_value pair, pic_value car);
|
|
void pic_set_cdr(pic_state *, pic_value pair, pic_value cdr);
|
|
pic_value pic_caar(pic_state *, pic_value);
|
|
pic_value pic_cadr(pic_state *, pic_value);
|
|
pic_value pic_cdar(pic_state *, pic_value);
|
|
pic_value pic_cddr(pic_state *, pic_value);
|
|
|
|
|
|
/*
|
|
* list
|
|
*/
|
|
|
|
bool pic_nil_p(pic_state *, pic_value);
|
|
bool pic_list_p(pic_state *, pic_value);
|
|
pic_value pic_nil_value(pic_state *);
|
|
pic_value pic_make_list(pic_state *, int n, pic_value *argv);
|
|
pic_value pic_list(pic_state *, int n, ...);
|
|
pic_value pic_vlist(pic_state *, int n, va_list);
|
|
pic_value pic_list_ref(pic_state *, pic_value list, int i);
|
|
void pic_list_set(pic_state *, pic_value list, int i, pic_value v);
|
|
pic_value pic_list_tail(pic_state *, pic_value list, int i);
|
|
int pic_length(pic_state *, pic_value list);
|
|
pic_value pic_reverse(pic_state *, pic_value list);
|
|
pic_value pic_append(pic_state *, pic_value xs, pic_value ys);
|
|
|
|
|
|
/*
|
|
* vector
|
|
*/
|
|
|
|
bool pic_vec_p(pic_state *, pic_value);
|
|
pic_value pic_make_vec(pic_state *, int n, pic_value *argv);
|
|
pic_value pic_vec_ref(pic_state *, pic_value vec, int i);
|
|
void pic_vec_set(pic_state *, pic_value vec, int i, pic_value v);
|
|
int pic_vec_len(pic_state *, pic_value vec);
|
|
|
|
|
|
/*
|
|
* dictionary
|
|
*/
|
|
|
|
bool pic_dict_p(pic_state *, pic_value);
|
|
pic_value pic_make_dict(pic_state *);
|
|
pic_value pic_dict_ref(pic_state *, pic_value dict, pic_value key);
|
|
void pic_dict_set(pic_state *, pic_value dict, pic_value key, pic_value);
|
|
void pic_dict_del(pic_state *, pic_value dict, pic_value key);
|
|
bool pic_dict_has(pic_state *, pic_value dict, pic_value key);
|
|
int pic_dict_size(pic_state *, pic_value dict);
|
|
bool pic_dict_next(pic_state *, pic_value dict, int *iter, pic_value *key, pic_value *val);
|
|
|
|
|
|
/*
|
|
* ephemeron table
|
|
*/
|
|
|
|
bool pic_weak_p(pic_state *, pic_value);
|
|
pic_value pic_make_weak(pic_state *);
|
|
pic_value pic_weak_ref(pic_state *, pic_value weak, pic_value key);
|
|
void pic_weak_set(pic_state *, pic_value weak, pic_value key, pic_value val);
|
|
void pic_weak_del(pic_state *, pic_value weak, pic_value key);
|
|
bool pic_weak_has(pic_state *, pic_value weak, pic_value key);
|
|
|
|
|
|
/*
|
|
* string
|
|
*/
|
|
|
|
int pic_str_len(pic_state *, pic_value str);
|
|
pic_value pic_str_cat(pic_state *, pic_value str1, pic_value str2);
|
|
pic_value pic_str_sub(pic_state *, pic_value str, int i, int j);
|
|
|
|
|
|
/*
|
|
* symbol
|
|
*/
|
|
|
|
bool pic_sym_p(pic_state *, pic_value);
|
|
pic_value pic_intern(pic_state *, pic_value str);
|
|
#define pic_intern_str(pic,s,i) pic_intern(pic, pic_str_value(pic, (s), (i)))
|
|
#define pic_intern_cstr(pic,s) pic_intern(pic, pic_cstr_value(pic, (s)))
|
|
#define pic_intern_lit(pic,lit) pic_intern(pic, pic_lit_value(pic, lit))
|
|
pic_value pic_sym_name(pic_state *, pic_value sym);
|
|
|
|
|
|
/*
|
|
* procedure
|
|
*/
|
|
|
|
typedef pic_value (*pic_func_t)(pic_state *);
|
|
bool pic_proc_p(pic_state *, pic_value);
|
|
pic_value pic_lambda(pic_state *, pic_func_t f, int n, ...);
|
|
pic_value pic_vlambda(pic_state *, pic_func_t f, int n, va_list);
|
|
int pic_get_args(pic_state *, const char *fmt, ...);
|
|
pic_value pic_closure_ref(pic_state *, int i);
|
|
void pic_closure_set(pic_state *, int i, pic_value v);
|
|
pic_value pic_call(pic_state *, pic_value proc, int, ...);
|
|
pic_value pic_vcall(pic_state *, pic_value proc, int, va_list);
|
|
pic_value pic_apply(pic_state *, pic_value proc, int n, pic_value *argv);
|
|
pic_value pic_applyk(pic_state *, pic_value proc, int n, pic_value *argv);
|
|
|
|
|
|
/*
|
|
* port
|
|
*/
|
|
|
|
typedef struct {
|
|
int (*read)(pic_state *, void *, char *, int);
|
|
int (*write)(pic_state *, void *, const char *, int);
|
|
long (*seek)(pic_state *, void *, long, int);
|
|
int (*close)(pic_state *, void *);
|
|
} pic_port_type;
|
|
|
|
#define PIC_SEEK_CUR 0
|
|
#define PIC_SEEK_END 1
|
|
#define PIC_SEEK_SET 2
|
|
|
|
#define pic_stdin(pic) pic_funcall(pic, "current-input-port", 0)
|
|
#define pic_stdout(pic) pic_funcall(pic, "current-output-port", 0)
|
|
#define pic_stderr(pic) pic_funcall(pic, "current-error-port", 0)
|
|
bool pic_eof_p(pic_state *, pic_value);
|
|
pic_value pic_eof_object(pic_state *);
|
|
bool pic_port_p(pic_state *, pic_value, const pic_port_type *type);
|
|
pic_value pic_funopen(pic_state *, void *cookie, const pic_port_type *type);
|
|
size_t pic_fread(pic_state *, void *ptr, size_t size, size_t count, pic_value port);
|
|
size_t pic_fwrite(pic_state *, const void *ptr, size_t size, size_t count, pic_value port);
|
|
long pic_fseek(pic_state *, pic_value port, long offset, int whence);
|
|
int pic_fclose(pic_state *, pic_value port);
|
|
/* error */
|
|
void pic_clearerr(pic_state *, pic_value port);
|
|
int pic_feof(pic_state *, pic_value port);
|
|
int pic_ferror(pic_state *, pic_value port);
|
|
/* basic I/O */
|
|
int pic_fputc(pic_state *, int c, pic_value port);
|
|
int pic_fgetc(pic_state *, pic_value port);
|
|
int pic_fputs(pic_state *, const char *s, pic_value port);
|
|
char *pic_fgets(pic_state *, char *s, int size, pic_value port);
|
|
int pic_ungetc(pic_state *, int c, pic_value port);
|
|
int pic_fflush(pic_state *, pic_value port);
|
|
/* formatted output */
|
|
int pic_printf(pic_state *, const char *fmt, ...);
|
|
int pic_fprintf(pic_state *, pic_value port, const char *fmt, ...);
|
|
int pic_vfprintf(pic_state *, pic_value port, const char *fmt, va_list ap);
|
|
/* string buffer */
|
|
pic_value pic_fmemopen(pic_state *, const char *buf, int len, const char *mode); /* deprecated */
|
|
int pic_fgetbuf(pic_state *, pic_value port, const char **buf, int *len); /* deprecated */
|
|
|
|
|
|
/*
|
|
* error handling
|
|
*/
|
|
|
|
typedef void (*pic_panicf)(pic_state *, const char *msg);
|
|
pic_panicf pic_atpanic(pic_state *, pic_panicf f);
|
|
PIC_NORETURN void pic_panic(pic_state *, const char *msg);
|
|
pic_value pic_raise_continuable(pic_state *pic, pic_value err);
|
|
PIC_NORETURN void pic_raise(pic_state *, pic_value v);
|
|
PIC_NORETURN void pic_error(pic_state *, const char *msg, int n, ...);
|
|
pic_value pic_make_error(pic_state *, const char *type, const char *msg, pic_value irrs);
|
|
pic_value pic_get_backtrace(pic_state *); /* deprecated */
|
|
#define pic_try pic_try_(PIC_GENSYM(cont), PIC_GENSYM(jmp))
|
|
#define pic_try_(cont, jmp) \
|
|
do { \
|
|
extern void pic_start_try(pic_state *, PIC_JMPBUF *); \
|
|
extern void pic_end_try(pic_state *); \
|
|
extern pic_value pic_err(pic_state *); \
|
|
PIC_JMPBUF jmp; \
|
|
if (PIC_SETJMP(pic, jmp) == 0) { \
|
|
pic_start_try(pic, &jmp);
|
|
#define pic_catch(e) pic_catch_(e, PIC_GENSYM(label))
|
|
#define pic_catch_(e, label) \
|
|
pic_end_try(pic); \
|
|
} else { \
|
|
e = pic_err(pic); \
|
|
goto label; \
|
|
} \
|
|
} while (0); \
|
|
if (0) \
|
|
label:
|
|
|
|
|
|
/*
|
|
* core language features
|
|
*/
|
|
|
|
void pic_add_feature(pic_state *, const char *feature);
|
|
void pic_define(pic_state *, const char *name, pic_value v);
|
|
pic_value pic_ref(pic_state *, const char *name);
|
|
void pic_set(pic_state *, const char *name, pic_value v);
|
|
pic_value pic_make_var(pic_state *, pic_value init, pic_value conv);
|
|
void pic_defun(pic_state *, const char *name, pic_func_t f);
|
|
void pic_defvar(pic_state *, const char *name, pic_value v);
|
|
pic_value pic_funcall(pic_state *, const char *name, int n, ...);
|
|
pic_value pic_values(pic_state *, int n, ...);
|
|
pic_value pic_vvalues(pic_state *, int n, va_list);
|
|
int pic_receive(pic_state *, int n, pic_value *retv);
|
|
|
|
|
|
/*
|
|
* utility macros
|
|
*/
|
|
|
|
#define pic_for_each(var, list, it) \
|
|
for (it = (list); ! pic_nil_p(pic, it); it = pic_cdr(pic, it)) \
|
|
if ((var = pic_car(pic, it)), true)
|
|
|
|
#define pic_push(pic, item, place) (place = pic_cons(pic, item, place))
|
|
#define pic_pop(pic, place) (place = pic_cdr(pic, place))
|
|
|
|
#define pic_void(pic, exec) pic_void_(pic, PIC_GENSYM(ai), exec)
|
|
#define pic_void_(pic,ai,exec) do { \
|
|
size_t ai = pic_enter(pic); \
|
|
exec; \
|
|
pic_leave(pic, ai); \
|
|
} while (0)
|
|
|
|
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif
|