This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Part of the MakeMaker 5.21 update.
[perl5.git] / XSUB.h
1 #define ST(off) stack_base[ax + (off)]
2
3 #ifdef CAN_PROTOTYPE
4 #define XS(name) void name(CV* cv)
5 #else
6 #define XS(name) void name(cv) CV* cv;
7 #endif
8
9 #define dXSARGS                         \
10         dSP; dMARK;                     \
11         I32 ax = mark - stack_base + 1; \
12         I32 items = sp - mark
13
14 #define XSANY CvXSUBANY(cv)
15
16 #define dXSI32 I32 ix = XSANY.any_i32
17
18 #define XSRETURN(off) stack_sp = stack_base + ax + ((off) - 1); return
19
20 /* Simple macros to put new mortal values onto the stack.   */
21 /* Typically used to return values from XS functions.       */
22 #define XST_mIV(i,v)  (ST(i) = sv_2mortal(newSViv(v))  )
23 #define XST_mNV(i,v)  (ST(i) = sv_2mortal(newSVnv(v))  )
24 #define XST_mPV(i,v)  (ST(i) = sv_2mortal(newSVpv(v,0)))
25 #define XST_mNO(i)    (ST(i) = &sv_no   )
26 #define XST_mYES(i)   (ST(i) = &sv_yes  )
27 #define XST_mUNDEF(i) (ST(i) = &sv_undef)
28  
29 #define XSRETURN_IV(v) do { XST_mIV(0,v);  XSRETURN(1); } while (0)
30 #define XSRETURN_NV(v) do { XST_mNV(0,v);  XSRETURN(1); } while (0)
31 #define XSRETURN_PV(v) do { XST_mPV(0,v);  XSRETURN(1); } while (0)
32 #define XSRETURN_NO    do { XST_mNO(0);    XSRETURN(1); } while (0)
33 #define XSRETURN_YES   do { XST_mYES(0);   XSRETURN(1); } while (0)
34 #define XSRETURN_UNDEF do { XST_mUNDEF(0); XSRETURN(1); } while (0)
35 #define XSRETURN_EMPTY do {                XSRETURN(0); } while (0)
36
37 #define newXSproto(a,b,c,d)     sv_setpv((SV*)newXS(a,b,c), d)
38
39 #ifdef XS_VERSION
40 # define XS_VERSION_BOOTCHECK \
41     do {                                                                      \
42         char vn[255], *module = SvPV(ST(0),na);                               \
43         if (items >= 2)         /* version supplied as bootstrap arg */       \
44             Sv=ST(1);                                                         \
45         else {                  /* read version from module::VERSION */       \
46             sprintf(vn,"%s::VERSION", module);                                \
47             Sv = perl_get_sv(vn, FALSE);   /* XXX GV_ADDWARN */               \
48         }                                                                     \
49         if (Sv && (!SvOK(Sv) || strNE(XS_VERSION, SvPV(Sv,na))) )             \
50             croak("%s object version %s does not match %s.pm $VERSION %s",    \
51               module,XS_VERSION, module,(Sv && SvOK(Sv))?SvPV(Sv,na):"(undef)");\
52     } while (0)
53 #else
54 # define XS_VERSION_BOOTCHECK
55 #endif
56