5 #define NEED_newRV_noinc
6 #define NEED_sv_2pv_flags
10 #define gv_fetchsv(n,f,t) gv_fetchpv(SvPV_nolen(n), f, t)
13 #ifndef mro_method_changed_in
14 #define mro_method_changed_in(x) PL_sub_generation++
18 #define newSVhe(he) newSVhek(HeKEY_hek(he))
20 #define newSVhe(he) newSVpv(HePV(he, PL_na), 0)
24 #define savesvpv(s) savepv(SvPV_nolen(s))
27 /* HACK: scalar slots are always populated on perl < 5.10, so treat undef
28 * as nonexistent. this is consistent with the previous behavior of the pure
29 * perl version of this module (since this is the behavior that perl sees
32 #define GvSVOK(g) (GvSV(g) && SvTYPE(GvSV(g)) != SVt_NULL)
34 #define GvSVOK(g) GvSV(g)
37 #define GvAVOK(g) GvAV(g)
38 #define GvHVOK(g) GvHV(g)
39 #define GvCVOK(g) GvCVu(g) /* XXX: should this really be GvCVu? or GvCV? */
40 #define GvIOOK(g) GvIO(g)
42 /* see above - don't let scalar slots become unpopulated, this breaks
43 * assumptions in core */
45 #define GvSetSV(g,v) do { \
47 SvREFCNT_dec(GvSV(g)); \
48 if ((GvSV(g) = _v ? _v : newSV(0))) \
49 GvIMPORTED_SV_on(g); \
52 #define GvSetSV(g,v) do { \
53 SvREFCNT_dec(GvSV(g)); \
54 if ((GvSV(g) = (SV*)(v))) \
55 GvIMPORTED_SV_on(g); \
59 #define GvSetAV(g,v) do { \
60 SvREFCNT_dec(GvAV(g)); \
61 if ((GvAV(g) = (AV*)(v))) \
62 GvIMPORTED_AV_on(g); \
64 #define GvSetHV(g,v) do { \
65 SvREFCNT_dec(GvHV(g)); \
66 if ((GvHV(g) = (HV*)(v))) \
67 GvIMPORTED_HV_on(g); \
69 #define GvSetCV(g,v) do { \
70 SvREFCNT_dec(GvCV(g)); \
71 if ((GvCV(g) = (CV*)(v))) { \
72 GvIMPORTED_CV_on(g); \
76 mro_method_changed_in(GvSTASH(g)); \
78 #define GvSetIO(g,v) do { \
79 SvREFCNT_dec(GvIO(g)); \
80 GvIOp(g) = (IO*)(v); \
90 VAR_GLOB, /* TODO: unimplemented */
91 VAR_FORMAT /* TODO: unimplemented */
99 static U32 name_hash, namespace_hash, type_hash;
100 static SV *name_key, *namespace_key, *type_key;
102 const char *vartype_to_string(vartype_t type)
120 I32 vartype_to_svtype(vartype_t type)
124 return SVt_PV; /* or whatever */
138 vartype_t string_to_vartype(char *vartype)
140 if (strEQ(vartype, "SCALAR")) {
143 else if (strEQ(vartype, "ARRAY")) {
146 else if (strEQ(vartype, "HASH")) {
149 else if (strEQ(vartype, "CODE")) {
152 else if (strEQ(vartype, "IO")) {
156 croak("Type must be one of 'SCALAR', 'ARRAY', 'HASH', 'CODE', or 'IO', not '%s'", vartype);
160 void _deconstruct_variable_name(SV *variable, varspec_t *varspec)
164 if (!SvCUR(variable))
165 croak("You must pass a variable name");
167 varspec->name = sv_2mortal(newSVsv(variable));
169 varpv = SvPV_nolen(varspec->name);
172 varspec->type = VAR_SCALAR;
173 sv_chop(varspec->name, &varpv[1]);
176 varspec->type = VAR_ARRAY;
177 sv_chop(varspec->name, &varpv[1]);
180 varspec->type = VAR_HASH;
181 sv_chop(varspec->name, &varpv[1]);
184 varspec->type = VAR_CODE;
185 sv_chop(varspec->name, &varpv[1]);
188 varspec->type = VAR_IO;
193 void _deconstruct_variable_hash(HV *variable, varspec_t *varspec)
197 val = hv_fetch_ent(variable, name_key, 0, name_hash);
199 croak("The 'name' key is required in variable specs");
201 varspec->name = sv_2mortal(newSVsv(HeVAL(val)));
203 val = hv_fetch_ent(variable, type_key, 0, type_hash);
205 croak("The 'type' key is required in variable specs");
207 varspec->type = string_to_vartype(SvPV_nolen(HeVAL(val)));
210 int _valid_for_type(SV *value, vartype_t type)
212 svtype sv_type = SvROK(value) ? SvTYPE(SvRV(value)) : SVt_NULL;
216 return SvROK(value) ? SvOK(SvRV(value)) : SvOK(value);
218 return sv_type == SVt_PVAV;
220 return sv_type == SVt_PVHV;
222 return sv_type == SVt_PVCV;
224 return sv_type == SVt_PVIO;
230 HV *_get_namespace(SV *self)
239 call_method("namespace", G_SCALAR);
245 return (HV*)SvRV(ret);
248 SV *_get_name(SV *self)
257 call_method("name", G_SCALAR);
266 void _expand_glob(SV *self, SV *varname)
270 name = newSVsv(_get_name(self));
271 sv_catpvs(name, "::");
272 sv_catsv(name, varname);
274 /* can't use gv_init here, because it screws up @ISA in a way that I
275 * can't reproduce, but that CMOP triggers */
276 gv_fetchsv(name, GV_ADD, SVt_NULL);
280 SV *_get_symbol(SV *self, varspec_t *variable, int vivify)
286 namespace = _get_namespace(self);
287 entry = hv_fetch_ent(namespace, variable->name, vivify, 0);
291 glob = (GV*)(HeVAL(entry));
293 _expand_glob(self, variable->name);
296 switch (variable->type) {
299 GvSetSV(glob, newSV(0));
303 GvSetAV(glob, newAV());
307 GvSetHV(glob, newHV());
310 croak("Don't know how to vivify CODE variables");
313 GvSetIO(glob, newIO());
316 croak("Unknown type in vivication");
320 switch (variable->type) {
324 return (SV*)GvAV(glob);
326 return (SV*)GvHV(glob);
328 return (SV*)GvCV(glob);
330 return (SV*)GvIO(glob);
336 MODULE = Package::Stash::XS PACKAGE = Package::Stash::XS
341 new(class, package_name)
349 if (!SvPOK(package_name))
350 croak("The constructor argument must be the name of a package");
354 if (!hv_store(instance, "name", 4, SvREFCNT_inc_simple_NN(package_name), 0)) {
355 SvREFCNT_dec(package_name);
356 SvREFCNT_dec(instance);
357 croak("Couldn't initialize the 'name' key, hv_store failed");
359 namespace = gv_stashpv(SvPV_nolen(package_name), GV_ADD);
360 nsref = newRV_inc((SV*)namespace);
361 if (!hv_store(instance, "namespace", 9, nsref, 0)) {
363 SvREFCNT_dec(instance);
364 croak("Couldn't initialize the 'namespace' key, hv_store failed");
367 RETVAL = sv_bless(newRV_noinc((SV*)instance), gv_stashsv(class, 0));
377 if (!sv_isobject(self))
378 croak("Can't call name as a class method");
379 slot = hv_fetch_ent((HV*)SvRV(self), name_key, 0, name_hash);
380 RETVAL = slot ? SvREFCNT_inc_simple_NN(HeVAL(slot)) : &PL_sv_undef;
390 if (!sv_isobject(self))
391 croak("Can't call namespace as a class method");
392 slot = hv_fetch_ent((HV*)SvRV(self), namespace_key, 0, namespace_hash);
393 RETVAL = slot ? SvREFCNT_inc_simple_NN(HeVAL(slot)) : &PL_sv_undef;
398 add_symbol(self, variable, initial=NULL, ...)
406 if (initial && !_valid_for_type(initial, variable.type))
407 croak("%s is not of type %s",
408 SvPV_nolen(initial), vartype_to_string(variable.type));
410 name = newSVsv(_get_name(self));
411 sv_catpvs(name, "::");
412 sv_catsv(name, variable.name);
414 if (items > 2 && (PL_perldb & 0x10) && variable.type == VAR_CODE) {
416 char *filename = NULL;
417 I32 first_line_num = -1, last_line_num = -1;
423 croak("add_symbol: Odd number of elements in %%opts");
425 for (i = 3; i < items; i += 2) {
427 key = SvPV_nolen(ST(i));
428 if (strEQ(key, "filename")) {
429 if (!SvPOK(ST(i + 1)))
430 croak("add_symbol: filename must be a string");
431 filename = SvPV_nolen(ST(i + 1));
433 else if (strEQ(key, "first_line_num")) {
434 if (!SvIOK(ST(i + 1)))
435 croak("add_symbol: first_line_num must be an integer");
436 first_line_num = SvIV(ST(i + 1));
438 else if (strEQ(key, "last_line_num")) {
439 if (!SvIOK(ST(i + 1)))
440 croak("add_symbol: last_line_num must be an integer");
441 last_line_num = SvIV(ST(i + 1));
445 if (!filename || first_line_num == -1) {
447 filename = CopFILE(PL_curcop);
448 if (first_line_num == -1)
449 first_line_num = PL_curcop->cop_line;
452 if (last_line_num == -1)
453 last_line_num = first_line_num;
455 /* http://perldoc.perl.org/perldebguts.html#Debugger-Internals */
456 dbsub = get_hv("DB::sub", 1);
457 dbval = newSVpvf("%s:%d-%d", filename, first_line_num, last_line_num);
458 if (!hv_store_ent(dbsub, name, dbval, 0)) {
459 warn("Failed to update $DB::sub for subroutine %s",
465 /* GV_ADDMULTI rather than GV_ADD because otherwise you get 'used only
466 * once' warnings in some situations... i can't reproduce this, but CMOP
468 glob = gv_fetchsv(name, GV_ADDMULTI, vartype_to_svtype(variable.type));
473 if (SvROK(initial)) {
475 SvREFCNT_inc_simple_void_NN(val);
478 val = newSVsv(initial);
481 switch (variable.type) {
503 remove_glob(self, name)
507 hv_delete_ent(_get_namespace(self), name, G_DISCARD, 0);
510 has_symbol(self, variable)
518 namespace = _get_namespace(self);
519 entry = hv_fetch_ent(namespace, variable.name, 0, 0);
526 switch (variable.type) {
528 RETVAL = GvSVOK(glob) ? 1 : 0;
531 RETVAL = GvAVOK(glob) ? 1 : 0;
534 RETVAL = GvHVOK(glob) ? 1 : 0;
537 RETVAL = GvCVOK(glob) ? 1 : 0;
540 RETVAL = GvIOOK(glob) ? 1 : 0;
545 RETVAL = (variable.type == VAR_CODE);
551 get_symbol(self, variable)
557 val = _get_symbol(self, &variable, 0);
560 RETVAL = newRV_inc(val);
565 get_or_add_symbol(self, variable)
571 val = _get_symbol(self, &variable, 1);
574 RETVAL = newRV_inc(val);
579 remove_symbol(self, variable)
587 namespace = _get_namespace(self);
588 entry = hv_fetch_ent(namespace, variable.name, 0, 0);
595 switch (variable.type) {
614 if (variable.type == VAR_CODE) {
615 hv_delete_ent(namespace, variable.name, G_DISCARD, 0);
620 list_all_symbols(self, vartype=VAR_NONE)
624 if (vartype == VAR_NONE) {
629 namespace = _get_namespace(self);
630 keys = hv_iterinit(namespace);
632 while ((entry = hv_iternext(namespace))) {
633 mPUSHs(newSVhe(entry));
642 namespace = _get_namespace(self);
643 hv_iterinit(namespace);
644 while ((val = hv_iternextsv(namespace, &key, &len))) {
670 else if (vartype == VAR_CODE) {
677 get_all_symbols(self, vartype=VAR_NONE)
686 namespace = _get_namespace(self);
689 hv_iterinit(namespace);
690 while ((val = hv_iternextsv(namespace, &key, &len))) {
694 SV *keysv = newSVpvn(key, len);
695 _expand_glob(self, keysv);
702 hv_store(ret, key, len, newRV_inc(GvSV(gv)), 0);
706 hv_store(ret, key, len, newRV_inc((SV*)GvAV(gv)), 0);
710 hv_store(ret, key, len, newRV_inc((SV*)GvHV(gv)), 0);
714 hv_store(ret, key, len, newRV_inc((SV*)GvCV(gv)), 0);
718 hv_store(ret, key, len, newRV_inc((SV*)GvIO(gv)), 0);
721 hv_store(ret, key, len, SvREFCNT_inc_simple_NN(val), 0);
726 mPUSHs(newRV_noinc((SV*)ret));
730 name_key = newSVpvs("name");
731 PERL_HASH(name_hash, "name", 4);
733 namespace_key = newSVpvs("namespace");
734 PERL_HASH(namespace_hash, "namespace", 9);
736 type_key = newSVpvs("type");
737 PERL_HASH(type_hash, "type", 4);