mruby 3.3.0
mruby is the lightweight implementation of the Ruby language
Loading...
Searching...
No Matches
proc.h File Reference

More...

#include "common.h"
#include <mruby/irep.h>
#include <mruby/khash.h>
Include dependency graph for proc.h:

Go to the source code of this file.

Classes

struct  REnv
 Proc class. More...
 
struct  RProc
 

Macros

#define MRB_ENV_SET_LEN(e, len)
 
#define MRB_ENV_LEN(e)
 
#define MRB_ENV_CLOSED   (1<<20)
 
#define MRB_ENV_CLOSE(e)
 
#define MRB_ENV_ONSTACK_P(e)
 
#define MRB_ENV_BIDX(e)
 
#define MRB_ENV_SET_BIDX(e, idx)
 
#define MRB_ASPEC_REQ(a)
 
#define MRB_ASPEC_OPT(a)
 
#define MRB_ASPEC_REST(a)
 
#define MRB_ASPEC_POST(a)
 
#define MRB_ASPEC_KEY(a)
 
#define MRB_ASPEC_KDICT(a)
 
#define MRB_ASPEC_BLOCK(a)
 
#define MRB_PROC_CFUNC_FL   128
 
#define MRB_PROC_CFUNC_P(p)
 
#define MRB_PROC_CFUNC(p)
 
#define MRB_PROC_STRICT   256
 
#define MRB_PROC_STRICT_P(p)
 
#define MRB_PROC_ORPHAN   512
 
#define MRB_PROC_ORPHAN_P(p)
 
#define MRB_PROC_ENVSET   1024
 
#define MRB_PROC_ENV_P(p)
 
#define MRB_PROC_ENV(p)
 
#define MRB_PROC_TARGET_CLASS(p)
 
#define MRB_PROC_SET_TARGET_CLASS(p, tc)
 
#define MRB_PROC_SCOPE   2048
 
#define MRB_PROC_SCOPE_P(p)
 
#define MRB_PROC_NOARG   4096 /* for MRB_PROC_CFUNC_FL, it would be something like MRB_ARGS_NONE() or MRB_METHOD_NOARG_FL */
 
#define MRB_PROC_NOARG_P(p)
 
#define MRB_PROC_ALIAS   8192
 
#define MRB_PROC_ALIAS_P(p)
 
#define mrb_proc_ptr(v)
 
#define mrb_cfunc_env_get(mrb, idx)
 
#define MRB_METHOD_FUNC_FL   1
 
#define MRB_METHOD_NOARG_FL   2
 
#define MRB_METHOD_FUNC_P(m)
 
#define MRB_METHOD_NOARG_P(m)
 
#define MRB_METHOD_NOARG_SET(m)
 
#define MRB_METHOD_FUNC(m)
 
#define MRB_METHOD_FROM_FUNC(m, fn)
 
#define MRB_METHOD_FROM_PROC(m, pr)
 
#define MRB_METHOD_PROC_P(m)
 
#define MRB_METHOD_PROC(m)
 
#define MRB_METHOD_UNDEF_P(m)
 
#define MRB_METHOD_CFUNC_P(m)
 
#define MRB_METHOD_CFUNC(m)
 

Functions

mrb_bool mrb_env_unshare (mrb_state *, struct REnv *, mrb_bool noraise)
 
struct RProcmrb_proc_new (mrb_state *, const mrb_irep *)
 
struct RProcmrb_proc_new_cfunc (mrb_state *, mrb_func_t)
 
struct RProcmrb_closure_new_cfunc (mrb_state *mrb, mrb_func_t func, int nlocals)
 
struct RProcmrb_proc_new_cfunc_with_env (mrb_state *mrb, mrb_func_t func, mrb_int argc, const mrb_value *argv)
 
mrb_value mrb_proc_cfunc_env_get (mrb_state *mrb, mrb_int idx)
 
mrb_value mrb_load_proc (mrb_state *mrb, const struct RProc *proc)
 
void mrb_vm_ci_env_clear (mrb_state *mrb, mrb_callinfo *ci)
 It can be used to isolate top-level scopes referenced by blocks generated by mrb_load_string_cxt() or similar called before entering the mruby VM (e.g.
 
void mrb_vm_ci_proc_set (mrb_callinfo *ci, const struct RProc *p)
 
struct RClassmrb_vm_ci_target_class (const mrb_callinfo *ci)
 
void mrb_vm_ci_target_class_set (mrb_callinfo *ci, struct RClass *tc)
 
struct REnvmrb_vm_ci_env (const mrb_callinfo *ci)
 
void mrb_vm_ci_env_set (mrb_callinfo *ci, struct REnv *e)
 

Detailed Description

  • Proc class

See Copyright Notice in mruby.h

Macro Definition Documentation

◆ MRB_ASPEC_BLOCK

#define MRB_ASPEC_BLOCK ( a)
Value:
((a) & 1)

◆ MRB_ASPEC_KDICT

#define MRB_ASPEC_KDICT ( a)
Value:
(((a) >> 1) & 0x1)

◆ MRB_ASPEC_KEY

#define MRB_ASPEC_KEY ( a)
Value:
(((a) >> 2) & 0x1f)

◆ MRB_ASPEC_OPT

#define MRB_ASPEC_OPT ( a)
Value:
(((a) >> 13) & 0x1f)

◆ MRB_ASPEC_POST

#define MRB_ASPEC_POST ( a)
Value:
(((a) >> 7) & 0x1f)

◆ MRB_ASPEC_REQ

#define MRB_ASPEC_REQ ( a)
Value:
(((a) >> 18) & 0x1f)

◆ MRB_ASPEC_REST

#define MRB_ASPEC_REST ( a)
Value:
(((a) >> 12) & 0x1)

◆ mrb_cfunc_env_get

#define mrb_cfunc_env_get ( mrb,
idx )
Value:
mrb_proc_cfunc_env_get(mrb, idx)

◆ MRB_ENV_BIDX

#define MRB_ENV_BIDX ( e)
Value:
(((e)->flags >> 8) & 0xff)

◆ MRB_ENV_CLOSE

#define MRB_ENV_CLOSE ( e)
Value:
((e)->flags |= MRB_ENV_CLOSED)

◆ MRB_ENV_LEN

#define MRB_ENV_LEN ( e)
Value:
((mrb_int)((e)->flags & 0xff))

◆ MRB_ENV_ONSTACK_P

#define MRB_ENV_ONSTACK_P ( e)
Value:
(((e)->flags & MRB_ENV_CLOSED) == 0)

◆ MRB_ENV_SET_BIDX

#define MRB_ENV_SET_BIDX ( e,
idx )
Value:
((e)->flags = (((e)->flags & ~(0xff<<8))|((unsigned int)(idx) & 0xff)<<8))

◆ MRB_ENV_SET_LEN

#define MRB_ENV_SET_LEN ( e,
len )
Value:
((e)->flags = (((e)->flags & ~0xff)|((unsigned int)(len) & 0xff)))

◆ MRB_METHOD_CFUNC

#define MRB_METHOD_CFUNC ( m)
Value:
(MRB_METHOD_FUNC_P(m)?MRB_METHOD_FUNC(m):((MRB_METHOD_PROC(m)&&MRB_PROC_CFUNC_P(MRB_METHOD_PROC(m)))?MRB_PROC_CFUNC(MRB_METHOD_PROC(m)):NULL))

◆ MRB_METHOD_CFUNC_P

#define MRB_METHOD_CFUNC_P ( m)
Value:
(MRB_METHOD_FUNC_P(m)?TRUE:(MRB_METHOD_PROC(m)?(MRB_PROC_CFUNC_P(MRB_METHOD_PROC(m))):FALSE))

◆ MRB_METHOD_FROM_FUNC

#define MRB_METHOD_FROM_FUNC ( m,
fn )
Value:
((m)=(mrb_method_t)((((uintptr_t)(fn))<<2)|MRB_METHOD_FUNC_FL))

◆ MRB_METHOD_FROM_PROC

#define MRB_METHOD_FROM_PROC ( m,
pr )
Value:
((m)=(mrb_method_t)(pr))

◆ MRB_METHOD_FUNC

#define MRB_METHOD_FUNC ( m)
Value:
((mrb_func_t)((uintptr_t)(m)>>2))
mrb_value(* mrb_func_t)(struct mrb_state *mrb, mrb_value self)
Function pointer type for a function callable by mruby.
Definition mruby.h:230

◆ MRB_METHOD_FUNC_P

#define MRB_METHOD_FUNC_P ( m)
Value:
(((uintptr_t)(m))&MRB_METHOD_FUNC_FL)

◆ MRB_METHOD_NOARG_P

#define MRB_METHOD_NOARG_P ( m)
Value:
((((uintptr_t)(m))&MRB_METHOD_NOARG_FL)?1:0)

◆ MRB_METHOD_NOARG_SET

#define MRB_METHOD_NOARG_SET ( m)
Value:
((m)=(mrb_method_t)(((uintptr_t)(m))|MRB_METHOD_NOARG_FL))

◆ MRB_METHOD_PROC

#define MRB_METHOD_PROC ( m)
Value:
((struct RProc*)(m))
Definition proc.h:42

◆ MRB_METHOD_PROC_P

#define MRB_METHOD_PROC_P ( m)
Value:
(!MRB_METHOD_FUNC_P(m))

◆ MRB_METHOD_UNDEF_P

#define MRB_METHOD_UNDEF_P ( m)
Value:
((m)==0)

◆ MRB_PROC_ALIAS_P

#define MRB_PROC_ALIAS_P ( p)
Value:
(((p)->flags & MRB_PROC_ALIAS) != 0)

◆ MRB_PROC_CFUNC

#define MRB_PROC_CFUNC ( p)
Value:
(p)->body.func

◆ MRB_PROC_CFUNC_P

#define MRB_PROC_CFUNC_P ( p)
Value:
(((p)->flags & MRB_PROC_CFUNC_FL) != 0)

◆ MRB_PROC_ENV

#define MRB_PROC_ENV ( p)
Value:
(MRB_PROC_ENV_P(p) ? (p)->e.env : NULL)

◆ MRB_PROC_ENV_P

#define MRB_PROC_ENV_P ( p)
Value:
(((p)->flags & MRB_PROC_ENVSET) != 0)

◆ MRB_PROC_NOARG_P

#define MRB_PROC_NOARG_P ( p)
Value:
(((p)->flags & MRB_PROC_NOARG) != 0)

◆ MRB_PROC_ORPHAN_P

#define MRB_PROC_ORPHAN_P ( p)
Value:
(((p)->flags & MRB_PROC_ORPHAN) != 0)

◆ mrb_proc_ptr

#define mrb_proc_ptr ( v)
Value:
((struct RProc*)(mrb_ptr(v)))

◆ MRB_PROC_SCOPE_P

#define MRB_PROC_SCOPE_P ( p)
Value:
(((p)->flags & MRB_PROC_SCOPE) != 0)

◆ MRB_PROC_SET_TARGET_CLASS

#define MRB_PROC_SET_TARGET_CLASS ( p,
tc )
Value:
do {\
if (MRB_PROC_ENV_P(p)) {\
(p)->e.env->c = (tc);\
mrb_field_write_barrier(mrb, (struct RBasic*)(p)->e.env, (struct RBasic*)(tc));\
}\
else {\
(p)->e.target_class = (tc);\
mrb_field_write_barrier(mrb, (struct RBasic*)p, (struct RBasic*)(tc));\
}\
} while (0)
Definition object.h:19

◆ MRB_PROC_STRICT_P

#define MRB_PROC_STRICT_P ( p)
Value:
(((p)->flags & MRB_PROC_STRICT) != 0)

◆ MRB_PROC_TARGET_CLASS

#define MRB_PROC_TARGET_CLASS ( p)
Value:
(MRB_PROC_ENV_P(p) ? (p)->e.env->c : (p)->e.target_class)

Function Documentation

◆ mrb_vm_ci_env_clear()

void mrb_vm_ci_env_clear ( mrb_state * mrb,
mrb_callinfo * ci )
extern

It can be used to isolate top-level scopes referenced by blocks generated by mrb_load_string_cxt() or similar called before entering the mruby VM (e.g.

from main()). In that case, the ci parameter should be mrb->c->cibase.

#include <mruby.h>
#include <mruby/compile.h>
#include <mruby/proc.h>

int
main(int argc, char **argv)
{
  mrb_state *mrb;
  mrb_ccontext *cxt;
  mrb_value blk, ret;

  mrb = mrb_open();
  cxt = mrb_ccontext_new(mrb);
  blk = mrb_load_string_cxt(mrb, "x, y, z = 1, 2, 3; proc { [x, y, z] }", cxt);
  mrb_vm_ci_env_clear(mrb, mrb->c->cibase);
  mrb_load_string_cxt(mrb, "x, y, z = 4, 5, 6", cxt);
  ret = mrb_funcall(mrb, blk, "call", 0);
  mrb_p(mrb, ret);  // => [1, 2, 3]
                    // => [4, 5, 6] if `mrb_vm_ci_env_clear()` is commented out
  mrb_ccontext_free(mrb, cxt);
  mrb_close(mrb);

  return 0;
}

The top-level local variable names stored in mrb_ccontext are retained. Use also mrb_ccontext_cleanup_local_variables() at the same time, if necessary.