Magic.xs

   1 /* This file is part of the Variable::Magic Perl module.
   2  * See http://search.cpan.org/dist/Variable-Magic/ */
   3
   4 #include <stdio.h>  /* sprintf() */
   5
   6 #define PERL_NO_GET_CONTEXT
   7 #include "EXTERN.h"
   8 #include "perl.h"
   9 #include "XSUB.h"
  10
  11 #define __PACKAGE__ "Variable::Magic"
  12
  13 #define R(S) fprintf(stderr, "R(" #S ") = %d\n", SvREFCNT(S))
  14
  15 #define PERL_VERSION_LE(R, V, S) (PERL_REVISION < (R) || (PERL_REVISION == (R) && (PERL_VERSION < (V) || (PERL_VERSION == (V) && (PERL_SUBVERSION <= (S))))))
  16
  17 #define PERL_API_VERSION_GE(R, V, S) (PERL_API_REVISION > (R) || (PERL_API_REVISION == (R) && (PERL_API_VERSION > (V) || (PERL_API_VERSION == (V) && (PERL_API_SUBVERSION >= (S))))))
  18
  19 /* --- Compatibility ------------------------------------------------------- */
  20
  21 #ifndef Newx
  22 # define Newx(v, n, c) New(0, v, n, c)
  23 #endif
  24
  25 #ifndef SvMAGIC_set
  26 # define SvMAGIC_set(sv, val) (SvMAGIC(sv) = (val))
  27 #endif
  28
  29 #ifndef dMY_CXT
  30 # define MY_CXT vmg_globaldata
  31 # define dMY_CXT
  32 # define START_MY_CXT STATIC my_cxt_t MY_CXT;
  33 # define MY_CXT_INIT
  34 #endif
  35
  36 #ifndef PERL_MAGIC_ext
  37 # define PERL_MAGIC_ext '~'
  38 #endif
  39
  40 #ifndef MGf_COPY
  41 # define MGf_COPY 0
  42 #endif /* !MGf_COPY */
  43
  44 #ifndef MGf_DUP
  45 # define MGf_DUP 0
  46 #endif /* !MGf_DUP */
  47
  48 #ifndef MGf_LOCAL
  49 # define MGf_LOCAL 0
  50 #endif /* !MGf_LOCAL */
  51
  52 /* --- Context-safe global data -------------------------------------------- */
  53
  54 #define MY_CXT_KEY __PACKAGE__ "::_guts" XS_VERSION
  55
  56 typedef struct {
  57  HV *wizz;
  58  U16 count;
  59 } my_cxt_t;
  60
  61 START_MY_CXT
  62
  63 /* --- Signatures ---------------------------------------------------------- */
  64
  65 #define SIG_MIN ((U16) (1u << 8))
  66 #define SIG_MAX ((U16) (1u << 16 - 1))
  67 #define SIG_NBR (SIG_MAX - SIG_MIN + 1)
  68 #define SIG_WIZ ((U16) (1u << 8 - 1))
  69
  70 /* ... Generate signatures ................................................. */
  71
  72 STATIC U16 vmg_gensig(pTHX) {
  73 #define vmg_gensig() vmg_gensig(aTHX)
  74  U16 sig;
  75  char buf[8];
  76  dMY_CXT;
  77
  78  do {
  79   sig = SIG_NBR * Drand01() + SIG_MIN;
  80  } while (hv_exists(MY_CXT.wizz, buf, sprintf(buf, "%u", sig)));
  81
  82  return sig;
  83 }
  84
  85 /* --- MGWIZ structure ----------------------------------------------------- */
  86
  87 typedef struct {
  88  MGVTBL *vtbl;
  89  U16 sig;
  90  int uvar;
  91  SV *cb_data;
  92  SV *cb_get, *cb_set, *cb_len, *cb_clear, *cb_free;
  93 #if MGf_COPY
  94  SV *cb_copy;
  95 #endif /* MGf_COPY */
  96 #if MGf_DUP
  97  SV *cb_dup;
  98 #endif /* MGf_DUP */
  99 #if MGf_LOCAL
 100  SV *cb_local;
 101 #endif /* MGf_LOCAL */
 102  SV *cb_fetch, *cb_store, *cb_exists, *cb_delete;
 103 } MGWIZ;
 104
 105 #define MGWIZ2SV(W) (newSVuv(PTR2UV(W)))
 106 #define SV2MGWIZ(S) (INT2PTR(MGWIZ*, SvUVX((SV *) (S))))
 107
 108 /* ... Construct private data .............................................. */
 109
 110 STATIC SV *vmg_data_new(pTHX_ SV *ctor, SV *sv, AV *args) {
 111 #define vmg_data_new(C, S, A) vmg_data_new(aTHX_ (C), (S), (A))
 112  SV *nsv;
 113
 114  dSP;
 115  int count;
 116
 117  ENTER;
 118  SAVETMPS;
 119
 120  PUSHMARK(SP);
 121  XPUSHs(sv_2mortal(newRV_inc(sv)));
 122  if (args != NULL) {
 123   I32 i, alen = av_len(args);
 124   for (i = 0; i < alen; ++i) { XPUSHs(*av_fetch(args, i, 0)); }
 125  }
 126  PUTBACK;
 127
 128  count = call_sv(ctor, G_SCALAR);
 129
 130  SPAGAIN;
 131
 132  if (count != 1) { croak("Callback needs to return 1 scalar\n"); }
 133  nsv = POPs;
 134 #if PERL_VERSION_LE(5, 8, 2)
 135  nsv = sv_newref(nsv); /* Workaround some bug in SvREFCNT_inc() */
 136 #else
 137  SvREFCNT_inc(nsv);    /* Or it will be destroyed in FREETMPS */
 138 #endif
 139
 140  PUTBACK;
 141
 142  FREETMPS;
 143  LEAVE;
 144
 145  return nsv;
 146 }
 147
 148 STATIC SV *vmg_data_get(SV *sv, U16 sig) {
 149  MAGIC *mg, *moremagic;
 150  MGWIZ *w;
 151
 152  if (SvTYPE(sv) >= SVt_PVMG) {
 153   for (mg = SvMAGIC(sv); mg; mg = moremagic) {
 154    moremagic = mg->mg_moremagic;
 155    if ((mg->mg_type == PERL_MAGIC_ext) && (mg->mg_private == sig)) { break; }
 156   }
 157   if (mg) { return mg->mg_obj; }
 158  }
 159
 160  return NULL;
 161 }
 162
 163 /* ... Magic cast/dispell .................................................. */
 164
 165 STATIC I32 vmg_uf_val(pTHX_ IV idx, SV *sv);
 166
 167 STATIC UV vmg_cast(pTHX_ SV *sv, SV *wiz, AV *args) {
 168 #define vmg_cast(S, W, A) vmg_cast(aTHX_ (S), (W), (A))
 169  int has_uvar = 0;
 170  MAGIC *mg = NULL, *moremagic = NULL;
 171  MGWIZ *w;
 172  SV *data;
 173
 174  w = SV2MGWIZ(wiz);
 175
 176  if ((SvTYPE(sv) >= SVt_PVMG) && (mg = SvMAGIC(sv))) {
 177   if (mg->mg_type == PERL_MAGIC_uvar) { has_uvar = 1; }
 178   do {
 179    if ((mg->mg_type == PERL_MAGIC_ext) && (mg->mg_private == w->sig)) { break;}
 180    mg = mg->mg_moremagic;
 181   } while (mg);
 182   if (mg) { return 1; }
 183  }
 184
 185  if (w->uvar && (SvTYPE(sv) >= SVt_PVHV) && !has_uvar) {
 186   struct ufuncs uf;
 187   uf.uf_val   = vmg_uf_val;
 188   uf.uf_set   = NULL;
 189   uf.uf_index = 0;
 190   sv_magicext(sv, NULL, PERL_MAGIC_uvar, &PL_vtbl_uvar, (char *) &uf, sizeof(uf));
 191  }
 192
 193  data = (w->cb_data) ? vmg_data_new(w->cb_data, sv, args) : NULL;
 194  mg = sv_magicext(sv, data, PERL_MAGIC_ext, w->vtbl, (char *) wiz, HEf_SVKEY);
 195  mg->mg_private = w->sig;
 196  mg->mg_flags   = mg->mg_flags
 197 #if MGf_COPY
 198                 | MGf_COPY
 199 #endif /* MGf_COPY */
 200 #if MGf_DUP
 201                 | MGf_DUP
 202 #endif /* MGf_DUP */
 203 #if MGf_LOCAL
 204                 | MGf_LOCAL
 205 #endif /* MGf_LOCAL */
 206  ;
 207
 208  return 1;
 209 }
 210
 211 STATIC UV vmg_dispell(pTHX_ SV *sv, U16 sig) {
 212 #define vmg_dispell(S, Z) vmg_dispell(aTHX_ (S), (Z))
 213  MAGIC *mg, *prevmagic, *moremagic = NULL;
 214  MGWIZ *w;
 215
 216  if (SvTYPE(sv) < SVt_PVMG) { return 0; }
 217
 218  for (prevmagic = NULL, mg = SvMAGIC(sv); mg; prevmagic = mg, mg = moremagic) {
 219   moremagic = mg->mg_moremagic;
 220   if ((mg->mg_type == PERL_MAGIC_ext) && (mg->mg_private == sig)) { break; }
 221  }
 222  if (!mg) { return 0; }
 223
 224  if (prevmagic) {
 225   prevmagic->mg_moremagic = moremagic;
 226  } else {
 227   SvMAGIC_set(sv, moremagic);
 228  }
 229  mg->mg_moremagic = NULL;
 230
 231  if (mg->mg_obj != sv) { SvREFCNT_dec(mg->mg_obj); } /* Destroy private data */
 232  SvREFCNT_dec((SV *) mg->mg_ptr); /* Unreference the wizard */
 233  Safefree(mg);
 234
 235  return 1;
 236 }
 237
 238 /* ... svt callbacks ....................................................... */
 239
 240 STATIC int vmg_cb_call(pTHX_ SV *cb, SV *sv, SV *data) {
 241 #define vmg_cb_call(I, S, D) vmg_cb_call(aTHX_ (I), (S), (D))
 242  int ret;
 243
 244  dSP;
 245  int count;
 246
 247  ENTER;
 248  SAVETMPS;
 249
 250  PUSHMARK(SP);
 251  XPUSHs(sv_2mortal(newRV_inc(sv)));
 252  if (data) { XPUSHs(data); }
 253  PUTBACK;
 254
 255  count = call_sv(cb, G_SCALAR);
 256
 257  SPAGAIN;
 258
 259  if (count != 1) { croak("Callback needs to return 1 scalar\n"); }
 260  ret = POPi;
 261
 262  PUTBACK;
 263
 264  FREETMPS;
 265  LEAVE;
 266
 267  return ret;
 268 }
 269
 270 STATIC int vmg_cb_call2(pTHX_ SV *cb, SV *sv, SV *data, SV *extra) {
 271 #define vmg_cb_call2(I, S, D, E) vmg_cb_call2(aTHX_ (I), (S), (D), (E))
 272  int ret;
 273
 274  dSP;
 275  int count;
 276
 277  ENTER;
 278  SAVETMPS;
 279
 280  PUSHMARK(SP);
 281  XPUSHs(sv_2mortal(newRV_inc(sv)));
 282  XPUSHs(data ? data : &PL_sv_undef);
 283  if (extra) { XPUSHs(extra); }
 284  PUTBACK;
 285
 286  count = call_sv(cb, G_SCALAR);
 287
 288  SPAGAIN;
 289
 290  if (count != 1) { croak("Callback needs to return 1 scalar\n"); }
 291  ret = POPi;
 292
 293  PUTBACK;
 294
 295  FREETMPS;
 296  LEAVE;
 297
 298  return ret;
 299 }
 300
 301 STATIC int vmg_svt_get(pTHX_ SV *sv, MAGIC *mg) {
 302  return vmg_cb_call(SV2MGWIZ(mg->mg_ptr)->cb_get, sv, mg->mg_obj);
 303 }
 304
 305 STATIC int vmg_svt_set(pTHX_ SV *sv, MAGIC *mg) {
 306  return vmg_cb_call(SV2MGWIZ(mg->mg_ptr)->cb_set, sv, mg->mg_obj);
 307 }
 308
 309 STATIC U32 vmg_svt_len(pTHX_ SV *sv, MAGIC *mg) {
 310  U32 ret;
 311
 312  dSP;
 313  int count;
 314
 315  ENTER;
 316  SAVETMPS;
 317
 318  PUSHMARK(SP);
 319  XPUSHs(sv_2mortal(newRV_inc(sv)));
 320  XPUSHs((mg->mg_obj) ? (mg->mg_obj) : &PL_sv_undef);
 321  if (SvTYPE(sv) == SVt_PVAV) {
 322   XPUSHs(sv_2mortal(newSViv(av_len((AV *) sv) + 1)));
 323  }
 324  PUTBACK;
 325
 326  count = call_sv(SV2MGWIZ(mg->mg_ptr)->cb_len, G_SCALAR);
 327
 328  SPAGAIN;
 329
 330  if (count != 1) { croak("Callback needs to return 1 scalar\n"); }
 331  ret = POPi;
 332
 333  PUTBACK;
 334
 335  FREETMPS;
 336  LEAVE;
 337
 338  return ret - 1;
 339 }
 340
 341 STATIC int vmg_svt_clear(pTHX_ SV *sv, MAGIC *mg) {
 342  return vmg_cb_call(SV2MGWIZ(mg->mg_ptr)->cb_clear, sv, mg->mg_obj);
 343 }
 344
 345 STATIC int vmg_svt_free(pTHX_ SV *sv, MAGIC *mg) {
 346  /* So that it can survive tmp cleanup in vmg_cb_call */
 347  SvREFCNT_inc(sv);
 348  /* Perl_mg_free will get rid of the magic and decrement mg->mg_obj and
 349   * mg->mg_ptr reference count */
 350  return vmg_cb_call(SV2MGWIZ(mg->mg_ptr)->cb_free, sv, mg->mg_obj);
 351 }
 352
 353 #if MGf_COPY
 354 STATIC int vmg_svt_copy(pTHX_ SV *sv, MAGIC *mg, SV *nsv, const char *name, int namelen) {
 355  return vmg_cb_call2(SV2MGWIZ(mg->mg_ptr)->cb_copy, sv, mg->mg_obj, nsv);
 356 }
 357 #endif /* MGf_COPY */
 358
 359 #if MGf_DUP
 360 STATIC int vmg_svt_dup(pTHX_ MAGIC *mg, CLONE_PARAMS *p) {
 361  return 0;
 362 }
 363 #endif /* MGf_DUP */
 364
 365 #if MGf_LOCAL
 366 STATIC int vmg_svt_local(pTHX_ SV *nsv, MAGIC *mg) {
 367  return vmg_cb_call(SV2MGWIZ(mg->mg_ptr)->cb_local, nsv, mg->mg_obj);
 368 }
 369 #endif /* MGf_LOCAL */
 370
 371 STATIC I32 vmg_uf_val(pTHX_ IV idx, SV *sv) {
 372  MAGIC *mg;
 373  SV *key;
 374  for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
 375   if (mg->mg_type == PERL_MAGIC_uvar) { key = mg->mg_obj; break; }
 376  }
 377  if (!key) { return 0; }
 378  for (mg = SvMAGIC(sv); mg; mg = mg->mg_moremagic) {
 379   MGWIZ *w;
 380   if ((mg->mg_type != PERL_MAGIC_ext) ||
 381       (mg->mg_private < SIG_MIN) || (mg->mg_private > SIG_MAX)) { continue; }
 382   w = SV2MGWIZ(mg->mg_ptr);
 383   if (!w->uvar) { continue; }
 384   switch (idx & (HV_FETCH_ISSTORE|HV_FETCH_ISEXISTS|HV_FETCH_LVALUE|HV_DELETE)){
 385    case 0:
 386     if (w->cb_fetch) { return vmg_cb_call2(w->cb_fetch, sv, mg->mg_obj, key); }
 387     break;
 388    case HV_FETCH_ISSTORE:
 389    case HV_FETCH_LVALUE:
 390    case (HV_FETCH_ISSTORE|HV_FETCH_LVALUE):
 391     if (w->cb_store) { return vmg_cb_call2(w->cb_store, sv, mg->mg_obj, key); }
 392     break;
 393    case HV_FETCH_ISEXISTS:
 394     if (w->cb_exists) { return vmg_cb_call2(w->cb_exists, sv, mg->mg_obj, key);}
 395     break;
 396    case HV_DELETE:
 397     if (w->cb_delete) { return vmg_cb_call2(w->cb_delete, sv, mg->mg_obj, key);}
 398     break;
 399   }
 400  }
 401  return 0;
 402 }
 403
 404 /* ... Wizard destructor ................................................... */
 405
 406 STATIC int vmg_wizard_free(pTHX_ SV *wiz, MAGIC *mg) {
 407  char buf[8];
 408  MGWIZ *w;
 409  dMY_CXT;
 410
 411  w = SV2MGWIZ(wiz);
 412
 413  SvREFCNT_inc(wiz); /* Fake survival - it's gonna be deleted anyway */
 414 #if PERL_API_VERSION_GE(5, 9, 5)
 415  SvREFCNT_inc(wiz); /* One more push */
 416 #endif
 417  if (hv_delete(MY_CXT.wizz, buf, sprintf(buf, "%u", w->sig), 0)) {
 418   --MY_CXT.count;
 419  }
 420
 421  if (w->cb_data  != NULL) { SvREFCNT_dec(SvRV(w->cb_data)); }
 422  if (w->cb_get   != NULL) { SvREFCNT_dec(SvRV(w->cb_get)); }
 423  if (w->cb_set   != NULL) { SvREFCNT_dec(SvRV(w->cb_set)); }
 424  if (w->cb_len   != NULL) { SvREFCNT_dec(SvRV(w->cb_len)); }
 425  if (w->cb_clear != NULL) { SvREFCNT_dec(SvRV(w->cb_clear)); }
 426  if (w->cb_free  != NULL) { SvREFCNT_dec(SvRV(w->cb_free)); }
 427 #if MGf_COPY
 428  if (w->cb_copy  != NULL) { SvREFCNT_dec(SvRV(w->cb_copy)); }
 429 #endif /* MGf_COPY */
 430 #if MGf_DUP
 431  if (w->cb_dup   != NULL) { SvREFCNT_dec(SvRV(w->cb_dup)); }
 432 #endif /* MGf_DUP */
 433 #if MGf_LOCAL
 434  if (w->cb_local != NULL) { SvREFCNT_dec(SvRV(w->cb_local)); }
 435 #endif /* MGf_LOCAL */
 436  if (w->cb_fetch != NULL) { SvREFCNT_dec(SvRV(w->cb_fetch)); }
 437  if (w->cb_store != NULL) { SvREFCNT_dec(SvRV(w->cb_store)); }
 438  if (w->cb_exists != NULL) { SvREFCNT_dec(SvRV(w->cb_exists)); }
 439  if (w->cb_delete != NULL) { SvREFCNT_dec(SvRV(w->cb_delete)); }
 440  Safefree(w->vtbl);
 441  Safefree(w);
 442
 443  return 0;
 444 }
 445
 446 STATIC MGVTBL vmg_wizard_vtbl = {
 447  NULL,            /* get */
 448  NULL,            /* set */
 449  NULL,            /* len */
 450  NULL,            /* clear */
 451  vmg_wizard_free, /* free */
 452 #if MGf_COPY
 453  NULL,            /* copy */
 454 #endif /* MGf_COPY */
 455 #if MGf_DUP
 456  NULL,            /* dup */
 457 #endif /* MGf_DUP */
 458 #if MGf_LOCAL
 459  NULL,            /* local */
 460 #endif /* MGf_LOCAL */
 461 };
 462
 463 /* --- Error messages and misc helpers ------------------------------------- */
 464
 465 STATIC const char vmg__wizard_args[]   = "_wizard() called with a wrong number of arguments - use wizard() instead";
 466 STATIC const char vmg_invalid_wiz[]    = "Invalid wizard object";
 467 STATIC const char vmg_invalid_sv[]     = "Invalid variable";
 468 STATIC const char vmg_invalid_sig[]    = "Invalid numeric signature";
 469 STATIC const char vmg_toomanysigs[]    = "Too many magic signatures used";
 470 STATIC const char vmg_argstorefailed[] = "Error while storing arguments";
 471
 472 STATIC U16 vmg_sv2sig(pTHX_ SV *sv) {
 473 #define vmg_sv2sig(S) vmg_sv2sig(aTHX_ (S))
 474  U16 sig;
 475
 476  if (SvIOK(sv)) {
 477   sig = SvUVX(sv);
 478  } else if (SvNOK(sv)) {
 479   sig = SvNVX(sv);
 480  } else if ((SvPOK(sv) && grok_number(SvPVX(sv), SvCUR(sv), NULL))) {
 481   sig = SvUV(sv);
 482  } else {
 483   croak(vmg_invalid_sig);
 484  }
 485  if (sig < SIG_MIN) { sig += SIG_MIN; }
 486  if (sig > SIG_MAX) { sig %= SIG_MAX + 1; }
 487
 488  return sig;
 489 }
 490
 491 #define VMG_SET_CB(T, M, CB) \
 492  cb = (CB); \
 493  (M)->cb_##T = (SvROK(cb)) ? newRV_inc(SvRV(cb)) : NULL;
 494
 495 #define VMG_SET_CB_SVT(T, V, M, CB) \
 496  cb = (CB); \
 497  if (SvROK(cb)) { \
 498   (V)->svt_##T = vmg_svt_##T; (M)->cb_##T = newRV_inc(SvRV(cb)); \
 499  } else { \
 500   (V)->svt_##T = NULL;        (M)->cb_##T = NULL; \
 501  }
 502
 503 /* --- XS ------------------------------------------------------------------ */
 504
 505 MODULE = Variable::Magic            PACKAGE = Variable::Magic
 506
 507 PROTOTYPES: ENABLE
 508
 509 BOOT:
 510 {
 511  HV *stash;
 512  MY_CXT_INIT;
 513  MY_CXT.wizz = newHV();
 514  MY_CXT.count = 0;
 515  stash = gv_stashpv(__PACKAGE__, 1);
 516  newCONSTSUB(stash, "SIG_MIN",   newSVuv(SIG_MIN));
 517  newCONSTSUB(stash, "SIG_MAX",   newSVuv(SIG_MAX));
 518  newCONSTSUB(stash, "SIG_NBR",   newSVuv(SIG_NBR));
 519  newCONSTSUB(stash, "MGf_COPY",  newSVuv(MGf_COPY));
 520  newCONSTSUB(stash, "MGf_DUP",   newSVuv(MGf_DUP));
 521  newCONSTSUB(stash, "MGf_LOCAL", newSVuv(MGf_LOCAL));
 522 }
 523
 524 SV *_wizard(SV *svsig, ...)
 525 PROTOTYPE: $@
 526 PREINIT:
 527  U16 sig;
 528  I32 i;
 529  char buf[8];
 530  MGWIZ *w;
 531  MGVTBL *t;
 532  MAGIC *mg;
 533  SV *cb, *sv;
 534 CODE:
 535  dMY_CXT;
 536
 537  if (items != 14) { croak(vmg__wizard_args); }
 538
 539  if (SvOK(svsig)) {
 540   SV **old;
 541   sig = vmg_sv2sig(svsig);
 542   if (old = hv_fetch(MY_CXT.wizz, buf, sprintf(buf, "%u", sig), 0)) {
 543    ST(0) = sv_2mortal(newRV_inc(*old));
 544    XSRETURN(1);
 545   }
 546  } else {
 547   if (MY_CXT.count >= SIG_NBR) { croak(vmg_toomanysigs); }
 548   sig = vmg_gensig();
 549  }
 550
 551  Newx(t, 1, MGVTBL);
 552  Newx(w, 1, MGWIZ);
 553  w->vtbl = t;
 554  w->sig  = sig;
 555
 556  VMG_SET_CB(data,         w, ST(1));
 557  VMG_SET_CB_SVT(get,   t, w, ST(2));
 558  VMG_SET_CB_SVT(set,   t, w, ST(3));
 559  VMG_SET_CB_SVT(len,   t, w, ST(4));
 560  VMG_SET_CB_SVT(clear, t, w, ST(5));
 561  VMG_SET_CB_SVT(free,  t, w, ST(6));
 562 #if MGf_COPY
 563  VMG_SET_CB_SVT(copy,  t, w, ST(7));
 564 #endif /* MGf_COPY */
 565 #if MGf_DUP
 566  VMG_SET_CB_SVT(dup,   t, w, ST(8));
 567 #endif /* MGf_DUP */
 568 #if MGf_LOCAL
 569  VMG_SET_CB_SVT(local, t, w, ST(9));
 570 #endif /* MGf_LOCAL */
 571  VMG_SET_CB(fetch,        w, ST(10));
 572  VMG_SET_CB(store,        w, ST(11));
 573  VMG_SET_CB(exists,       w, ST(12));
 574  VMG_SET_CB(delete,       w, ST(13));
 575
 576  w->uvar = (w->cb_fetch || w->cb_store || w->cb_exists || w->cb_delete);
 577
 578  sv = MGWIZ2SV(w);
 579  mg = sv_magicext(sv, NULL, PERL_MAGIC_ext, &vmg_wizard_vtbl, NULL, -1);
 580  mg->mg_private = SIG_WIZ;
 581 #if MGf_COPY
 582  if (t->svt_copy)  { mg->mg_flags |= MGf_COPY; }
 583 #endif /* MGf_COPY */
 584 #if MGf_DUP
 585  if (t->svt_dup)   { mg->mg_flags |= MGf_DUP; }
 586 #endif /* MGf_DUP */
 587 #if MGf_LOCAL
 588  if (t->svt_local) { mg->mg_flags |= MGf_LOCAL; }
 589 #endif /* MGf_LOCAL */
 590
 591  hv_store(MY_CXT.wizz, buf, sprintf(buf, "%u", sig), sv, 0);
 592  ++MY_CXT.count;
 593
 594  RETVAL = newRV_noinc(sv);
 595 OUTPUT:
 596  RETVAL
 597
 598 SV *gensig()
 599 PROTOTYPE:
 600 CODE:
 601  dMY_CXT;
 602  if (MY_CXT.count >= SIG_NBR) { croak(vmg_toomanysigs); }
 603  RETVAL = newSVuv(vmg_gensig());
 604 OUTPUT:
 605  RETVAL
 606
 607 SV *getsig(SV *wiz)
 608 PROTOTYPE: $
 609 CODE:
 610  if (!SvROK(wiz)) { croak(vmg_invalid_wiz); }
 611  RETVAL = newSVuv(SV2MGWIZ(SvRV(wiz))->sig);
 612 OUTPUT:
 613  RETVAL
 614
 615 SV *cast(SV *sv, SV *wiz, ...)
 616 PROTOTYPE: \[$@%&*]$@
 617 PREINIT:
 618  AV *args = NULL;
 619  SV *ret;
 620 CODE:
 621  dMY_CXT;
 622  if (SvROK(wiz)) {
 623   wiz = SvRV(wiz);
 624  } else if (SvOK(wiz)) {
 625   char buf[8];
 626   SV **old;
 627   U16 sig = vmg_sv2sig(wiz);
 628   if (old = hv_fetch(MY_CXT.wizz, buf, sprintf(buf, "%u", sig), 0)) {
 629    wiz = *old;
 630   } else {
 631    XSRETURN_UNDEF;
 632   }
 633  } else {
 634   croak(vmg_invalid_sig);
 635  }
 636  if (items > 2) {
 637   I32 i;
 638   args = newAV();
 639   av_fill(args, items - 2);
 640   for (i = 2; i < items; ++i) {
 641    SV *arg = ST(i);
 642    SvREFCNT_inc(arg);
 643    if (av_store(args, i - 2, arg) == NULL) { croak(vmg_argstorefailed); }
 644   }
 645  }
 646  ret = newSVuv(vmg_cast(SvRV(sv), wiz, args));
 647  SvREFCNT_dec(args);
 648  RETVAL = ret;
 649 OUTPUT:
 650  RETVAL
 651
 652 SV *getdata(SV *sv, SV *wiz)
 653 PROTOTYPE: \[$@%&*]$
 654 PREINIT:
 655  SV *data;
 656  U16 sig;
 657 CODE:
 658  dMY_CXT;
 659  if (SvROK(wiz)) {
 660   sig = SV2MGWIZ(SvRV(wiz))->sig;
 661  } else if (SvOK(wiz)) {
 662   char buf[8];
 663   sig = vmg_sv2sig(wiz);
 664   if (!hv_fetch(MY_CXT.wizz, buf, sprintf(buf, "%u", sig), 0)) {
 665    XSRETURN_UNDEF;
 666   }
 667  } else {
 668   croak(vmg_invalid_wiz);
 669  }
 670  data = vmg_data_get(SvRV(sv), sig);
 671  if (!data) { XSRETURN_UNDEF; }
 672  ST(0) = newSVsv(data);
 673  XSRETURN(1);
 674
 675 SV *dispell(SV *sv, SV *wiz)
 676 PROTOTYPE: \[$@%&*]$
 677 PREINIT:
 678  U16 sig;
 679 CODE:
 680  dMY_CXT;
 681  if (SvROK(wiz)) {
 682   sig = SV2MGWIZ(SvRV(wiz))->sig;
 683  } else if (SvOK(wiz)) {
 684   char buf[8];
 685   sig = vmg_sv2sig(wiz);
 686   if (!hv_fetch(MY_CXT.wizz, buf, sprintf(buf, "%u", sig), 0)) {
 687    XSRETURN_UNDEF;
 688   }
 689  } else {
 690   croak(vmg_invalid_wiz);
 691  }
 692  RETVAL = newSVuv(vmg_dispell(SvRV(sv), sig));
 693 OUTPUT:
 694  RETVAL