Add a comment for GETMAGIC in accessors
[gitmo/Class-MOP.git] / mop.h
1 #ifndef __MOP_H__
2 #define __MOP_H__
3
4 #define PERL_NO_GET_CONTEXT
5 #include "EXTERN.h"
6 #include "perl.h"
7 #include "XSUB.h"
8
9 #include "ppport.h"
10
11 #define MOP_CALL_BOOT(name)  mop_call_xs(aTHX_ name, cv, mark);
12
13 #ifndef XSPROTO
14 #define XSPROTO(name) XS(name)
15 #endif
16
17 void mop_call_xs (pTHX_ XSPROTO(subaddr), CV *cv, SV **mark);
18
19
20 #define MAKE_KEYSV(name) newSVpvn_share(#name, sizeof(#name)-1, 0U)
21
22 XS(mop_xs_simple_accessor);
23 XS(mop_xs_simple_reader);
24 XS(mop_xs_simple_writer);
25 XS(mop_xs_simple_predicate);
26 XS(mop_xs_simple_predicate_for_metaclass);
27 XS(mop_xs_simple_clearer);
28
29 extern SV *mop_method_metaclass;
30 extern SV *mop_associated_metaclass;
31 extern SV *mop_associated_attribute;
32 extern SV *mop_wrap;
33 extern SV *mop_methods;
34 extern SV *mop_name;
35 extern SV *mop_body;
36 extern SV *mop_package;
37 extern SV *mop_package_name;
38 extern SV *mop_package_cache_flag;
39 extern SV *mop_VERSION;
40 extern SV *mop_ISA;
41
42 UV mop_check_package_cache_flag(pTHX_ HV *stash);
43 int mop_get_code_info (SV *coderef, char **pkg, char **name);
44 SV *mop_call0(pTHX_ SV *const self, SV *const method);
45 SV *mop_call1(pTHX_ SV *const self, SV *const method, SV *const arg1);
46
47 #define mop_call0_pvs(o, m)    mop_call0(aTHX_ o, newSVpvs_flags(m, SVs_TEMP))
48 #define mop_call1_pvs(o, m, a) mop_call1(aTHX_ o, newSVpvs_flags(m, SVs_TEMP), a)
49
50
51 typedef enum {
52     TYPE_FILTER_NONE,
53     TYPE_FILTER_CODE,
54     TYPE_FILTER_ARRAY,
55     TYPE_FILTER_IO,
56     TYPE_FILTER_HASH,
57     TYPE_FILTER_SCALAR,
58 } type_filter_t;
59
60 typedef bool (*get_package_symbols_cb_t) (const char *, STRLEN, SV *, void *);
61
62 void mop_get_package_symbols(HV *stash, type_filter_t filter, get_package_symbols_cb_t cb, void *ud);
63 HV  *mop_get_all_package_symbols (HV *stash, type_filter_t filter);
64
65
66 /* Class::MOP::Instance stuff */
67
68 /* MI: Meta Instance object of Class::MOP::Method */
69
70 /* All the MOP_mg_* macros require MAGIC* mg for the first argument */
71 /* All the MOP_mi_* macros require AV* mi    for the first argument */
72
73 typedef struct {
74     SV*  (*create_instance)(pTHX_ MAGIC* const mg);
75     bool (*has_slot)       (pTHX_ MAGIC* const mg, SV* const instance);
76     SV*  (*get_slot)       (pTHX_ MAGIC* const mg, SV* const instance);
77     SV*  (*set_slot)       (pTHX_ MAGIC* const mg, SV* const instance, SV* const value);
78     SV*  (*delete_slot)    (pTHX_ MAGIC* const mg, SV* const instance);
79     void (*weaken_slot)    (pTHX_ MAGIC* const mg, SV* const instance);
80 } mop_instance_vtbl;
81
82 const mop_instance_vtbl* mop_get_default_instance_vtbl(pTHX);
83
84 #define MOP_MI_SLOT   0
85 #define MOP_MI_last   1
86
87 #define MOP_mg_mi(mg)    ((AV*)(mg)->mg_obj)
88 #define MOP_mg_vtbl(mg)  ((const mop_instance_vtbl*)(mg)->mg_ptr)
89 #define MOP_mg_flags(mg) ((mg)->mg_private)
90
91 #ifdef DEBUGGING
92 #define MOP_mi_access(mi, a)  *mop_debug_mi_access(aTHX_ (mi) , (a))
93 SV** mop_debug_mi_access(pTHX_ AV* const mi, I32 const attr_ix);
94 #else
95 #define MOP_mi_access(mi, a)  AvARRAY((mi))[(a)]
96 #endif
97
98 #define MOP_mi_slot(mi)   MOP_mi_access((mi), MOP_MI_SLOT)
99 #define MOP_mg_slot(mg)   MOP_mi_slot(MOP_mg_mi(mg))
100
101 #define MOP_mg_create_instance(mg) MOP_mg_vtbl(mg)->create_instance (aTHX_ (mg))
102 #define MOP_mg_has_slot(mg, o)     MOP_mg_vtbl(mg)->has_slot        (aTHX_ (mg), (o))
103 #define MOP_mg_get_slot(mg, o)     MOP_mg_vtbl(mg)->get_slot        (aTHX_ (mg), (o))
104 #define MOP_mg_set_slot(mg, o, v)  MOP_mg_vtbl(mg)->set_slot        (aTHX_ (mg), (o), (v))
105 #define MOP_mg_delete_slot(mg, o)  MOP_mg_vtbl(mg)->delete_slot     (aTHX_ (mg), (o))
106 #define MOP_mg_weaken_slot(mg, o)  MOP_mg_vtbl(mg)->weaken_slot     (aTHX_ (mg), (o))
107
108
109 /* Class::MOP::Method::Accessor stuff */
110
111 #define dMOP_self      SV* const self = mop_accessor_get_self(aTHX_ ax, items, cv)
112 #define dMOP_mg(xsub)  MAGIC* mg      = (MAGIC*)CvXSUBANY(xsub).any_ptr
113 #define dMOP_METHOD_COMMON  dMOP_self; dMOP_mg(cv)
114
115
116 SV*    mop_accessor_get_self(pTHX_ I32 const ax, I32 const items, CV* const cv);
117 MAGIC* mop_accessor_get_mg(pTHX_ CV* const cv);
118
119 CV*    mop_install_accessor(pTHX_ const char* const fq_name, const char* const key, I32 const keylen, XSPROTO(accessor_impl), const mop_instance_vtbl* vtbl);
120
121 #define INSTALL_SIMPLE_READER(klass, name)                  INSTALL_SIMPLE_READER_WITH_KEY(klass, name, name)
122 #define INSTALL_SIMPLE_READER_WITH_KEY(klass, name, key)    (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::" #name, #key, sizeof(#key)-1, mop_xs_simple_reader, NULL)
123
124 #define INSTALL_SIMPLE_WRITER(klass, name)                  INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, name)
125 #define INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, key)    (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::" #name, #key, sizeof(#key)-1, mop_xs_simple_writer, NULL)
126
127 #define INSTALL_SIMPLE_PREDICATE(klass, name)                INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, name)
128 #define INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, key) (void)mop_install_accessor(aTHX_ "Class::MOP::" #klass "::has_" #name, #key, sizeof(#key)-1, mop_xs_simple_predicate_for_metaclass, NULL)
129
130 #define MOPf_DIE_ON_FAIL 0x01
131 MAGIC* mop_mg_find(pTHX_ SV* const sv, const MGVTBL* const vtbl, I32 const flags);
132
133 #endif