Use shortnames for mouse_instance_*
[gitmo/Mouse.git] / mouse.h
1 #ifndef MOUSE_H
2 #define MOUSE_H
3
4 #define PERL_NO_GET_CONTEXT
5 #include <EXTERN.h>
6 #include <perl.h>
7 #include <XSUB.h>
8
9 #define  NEED_newSVpvn_flags
10 #include "ppport.h"
11
12 /* for portability */
13 #ifndef newSVpvs_share
14 #define newSVpvs_share(s) Perl_newSVpvn_share(aTHX_ s, sizeof(s)-1, 0U)
15 #endif
16
17 #ifndef GvNAME_get
18 #define GvNAME_get GvNAME
19 #endif
20 #ifndef GvNAMELEN_get
21 #define GvNAMELEN_get GvNAMELEN
22 #endif
23
24 #ifndef mro_get_linear_isa
25 #define no_mro_get_linear_isa
26 #define mro_get_linear_isa(stash) mouse_mro_get_linear_isa(aTHX_ stash)
27 AV* mouse_mro_get_linear_isa(pTHX_ HV* const stash);
28 #endif /* !mro_get_linear_isa */
29
30 #ifndef mro_get_pkg_gen
31 #ifdef no_mro_get_linear_isa
32 #define mro_get_pkg_gen(stash) ((void)stash, PL_sub_generation)
33 #else
34 #define mro_get_pkg_gen(stash) (HvAUX(stash)->xhv_mro_meta ? HvAUX(stash)->xhv_mro_meta->pkg_gen : (U32)0)
35 #endif /* !no_mro_get_linear_isa */
36 #endif /* mro_get_package_gen */
37
38 #define MOUSE_CALL_BOOT(name) STMT_START {      \
39         EXTERN_C XS(CAT2(boot_, name));         \
40         PUSHMARK(SP);                           \
41         CALL_FPTR(CAT2(boot_, name))(aTHX_ cv); \
42     } STMT_END
43
44 extern SV* mouse_package;
45 extern SV* mouse_namespace;
46 extern SV* mouse_methods;
47 extern SV* mouse_name;
48
49 void
50 mouse_throw_error(SV* const metaobject, SV* const data /* not used */, const char* const fmt, ...)
51 #ifdef __attribute__format__
52     __attribute__format__(__printf__, 3, 4);
53 #else
54     ;
55 #endif
56
57 #define is_class_loaded(sv) mouse_is_class_loaded(aTHX_ sv)
58 bool mouse_is_class_loaded(pTHX_ SV*);
59
60 #define is_an_instance_of(klass, sv) mouse_is_an_instance_of(aTHX_ gv_stashpvs(klass, GV_ADD), (sv))
61
62 #define IsObject(sv) (SvROK(sv) && SvOBJECT(SvRV(sv)))
63
64 #define mcall0(invocant, m)        mouse_call0(aTHX_ (invocant), (m))
65 #define mcall1(invocant, m, arg1)  mouse_call1(aTHX_ (invocant), (m), (arg1))
66 #define mcall0s(invocant, m)       mcall0((invocant), newSVpvs_flags(m, SVs_TEMP))
67 #define mcall1s(invocant, m, arg1) mcall1((invocant), newSVpvs_flags(m, SVs_TEMP), (arg1))
68
69 SV* mouse_call0(pTHX_ SV *const self, SV *const method);
70 SV* mouse_call1(pTHX_ SV *const self, SV *const method, SV* const arg1);
71
72 #define MOUSEf_DIE_ON_FAIL 0x01
73 MAGIC* mouse_mg_find(pTHX_ SV* const sv, const MGVTBL* const vtbl, I32 const flags);
74
75 /* MOUSE_av_at(av, ix) is the safer version of AvARRAY(av)[ix] if perl is compiled with -DDEBUGGING */
76 #ifdef DEBUGGING
77 #define MOUSE_av_at(av, ix)  *mouse_av_at_safe(aTHX_ (av) , (ix))
78 SV** mouse_av_at_safe(pTHX_ AV* const mi, I32 const ix);
79 #else
80 #define MOUSE_av_at(av, ix)  AvARRAY(av)[ix]
81 #endif
82
83 #define dMOUSE_self  SV* const self = mouse_accessor_get_self(aTHX_ ax, items, cv)
84 SV* mouse_accessor_get_self(pTHX_ I32 const ax, I32 const items, CV* const cv);
85
86 #define MOUSE_mg_obj(mg)     ((mg)->mg_obj)
87 #define MOUSE_mg_ptr(mg)     ((mg)->mg_ptr)
88 #define MOUSE_mg_flags(mg)   ((mg)->mg_private)
89 #define MOUSE_mg_virtual(mg) ((mg)->mg_virtual)
90
91 #define MOUSE_mg_slot(mg)   MOUSE_mg_obj(mg)
92 #define MOUSE_mg_xa(mg)    ((AV*)MOUSE_mg_ptr(mg))
93
94
95 /* mouse_instance.xs stuff */
96 SV*  mouse_instance_create     (pTHX_ HV* const stash);
97 SV*  mouse_instance_clone      (pTHX_ SV* const instance);
98 bool mouse_instance_has_slot   (pTHX_ SV* const instance, SV* const slot);
99 SV*  mouse_instance_get_slot   (pTHX_ SV* const instance, SV* const slot);
100 SV*  mouse_instance_set_slot   (pTHX_ SV* const instance, SV* const slot, SV* const value);
101 SV*  mouse_instance_delete_slot(pTHX_ SV* const instance, SV* const slot);
102 void mouse_instance_weaken_slot(pTHX_ SV* const instance, SV* const slot);
103
104 #define has_slot(self, key)         mouse_instance_has_slot(aTHX_ self, key)
105 #define get_slot(self, key)         mouse_instance_get_slot(aTHX_ self, key)
106 #define set_slot(self, key, value)  mouse_instance_set_slot(aTHX_ self, key, value)
107 #define delete_slot(self, key)      mouse_instance_delete_slot(aTHX_ self, key)
108 #define weaken_slot(self, key)      mouse_instance_weaken_slot(aTHX_ self, key)
109
110 #define has_slots(self, key)        has_slot(self, sv_2mortal(newSVpvs_share(key)))
111 #define get_slots(self, key)        get_slot(self, sv_2mortal(newSVpvs_share(key)))
112 #define set_slots(self, key, value) set_slot(self, sv_2mortal(newSVpvs_share(key)), value)
113
114 /* mouse_simle_accessor.xs */
115 #define INSTALL_SIMPLE_READER(klass, name)                  INSTALL_SIMPLE_READER_WITH_KEY(klass, name, name)
116 #define INSTALL_SIMPLE_READER_WITH_KEY(klass, name, key)    (void)mouse_install_simple_accessor(aTHX_ "Mouse::Meta::" #klass "::" #name, #key, sizeof(#key)-1, mouse_xs_simple_reader)
117
118 #define INSTALL_SIMPLE_WRITER(klass, name)                  INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, name)
119 #define INSTALL_SIMPLE_WRITER_WITH_KEY(klass, name, key)    (void)mouse_install_simple_accessor(aTHX_ "Mouse::Meta::" #klass "::" #name, #key, sizeof(#key)-1, mouse_xs_simple_writer)
120
121 #define INSTALL_SIMPLE_PREDICATE(klass, name)                INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, name)
122 #define INSTALL_SIMPLE_PREDICATE_WITH_KEY(klass, name, key) (void)mouse_install_simple_accessor(aTHX_ "Mouse::Meta::" #klass "::" #name, #key, sizeof(#key)-1, mouse_xs_simple_predicate)
123
124 CV* mouse_install_simple_accessor(pTHX_ const char* const fq_name, const char* const key, I32 const keylen, XSUBADDR_t const accessor_impl);
125
126 XS(mouse_xs_simple_reader);
127 XS(mouse_xs_simple_writer);
128 XS(mouse_xs_simple_clearer);
129 XS(mouse_xs_simple_predicate);
130
131 CV* mouse_instantiate_xs_accessor(pTHX_ SV* const attr, XSUBADDR_t const accessor_impl);
132
133 XS(mouse_xs_accessor);
134 XS(mouse_xs_reader);
135 XS(mouse_xs_writer);
136
137 typedef enum mouse_tc{
138      MOUSE_TC_ANY,
139      MOUSE_TC_ITEM,
140      MOUSE_TC_MAYBE,
141      MOUSE_TC_UNDEF,
142      MOUSE_TC_DEFINED,
143      MOUSE_TC_BOOL,
144      MOUSE_TC_VALUE,
145      MOUSE_TC_REF,
146      MOUSE_TC_STR,
147      MOUSE_TC_NUM,
148      MOUSE_TC_INT,
149      MOUSE_TC_SCALAR_REF,
150      MOUSE_TC_ARRAY_REF,
151      MOUSE_TC_HASH_REF,
152      MOUSE_TC_CODE_REF,
153      MOUSE_TC_GLOB_REF,
154      MOUSE_TC_FILEHANDLE,
155      MOUSE_TC_REGEXP_REF,
156      MOUSE_TC_OBJECT,
157      MOUSE_TC_CLASS_NAME,
158      MOUSE_TC_ROLE_NAME,
159
160      MOUSE_TC_last
161 } mouse_tc;
162
163 /* type constraints */
164
165 int mouse_tc_check(pTHX_ SV* const tc, SV* const sv);
166 int mouse_builtin_tc_check(pTHX_ mouse_tc const tc, SV* const sv);
167
168 int mouse_tc_Any       (pTHX_ SV* const sv);
169 int mouse_tc_Bool      (pTHX_ SV* const sv);
170 int mouse_tc_Undef     (pTHX_ SV* const sv);
171 int mouse_tc_Defined   (pTHX_ SV* const sv);
172 int mouse_tc_Value     (pTHX_ SV* const sv);
173 int mouse_tc_Num       (pTHX_ SV* const sv);
174 int mouse_tc_Int       (pTHX_ SV* const sv);
175 int mouse_tc_Str       (pTHX_ SV* const sv);
176 int mouse_tc_ClassName (pTHX_ SV* const sv);
177 int mouse_tc_RoleName  (pTHX_ SV* const sv);
178 int mouse_tc_Ref       (pTHX_ SV* const sv);
179 int mouse_tc_ScalarRef (pTHX_ SV* const sv);
180 int mouse_tc_ArrayRef  (pTHX_ SV* const sv);
181 int mouse_tc_HashRef   (pTHX_ SV* const sv);
182 int mouse_tc_CodeRef   (pTHX_ SV* const sv);
183 int mouse_tc_RegexpRef (pTHX_ SV* const sv);
184 int mouse_tc_GlobRef   (pTHX_ SV* const sv);
185 int mouse_tc_FileHandle(pTHX_ SV* const sv);
186 int mouse_tc_Object    (pTHX_ SV* const sv);
187
188 CV* mouse_generate_isa_predicate_for(pTHX_ SV* const klass, const char* const predicate_name);
189
190 int mouse_is_an_instance_of(pTHX_ HV* const stash, SV* const instance);
191
192 XS(XS_Mouse_parameterized_check);
193
194 XS(XS_Mouse__Util__TypeConstraints_Item);
195
196 #endif /* !MOUSE_H */
197