12 VAR_GLOB, /* TODO: unimplemented */
13 VAR_FORMAT /* TODO: unimplemented */
22 const char *vartype_to_string(vartype_t type)
40 I32 vartype_to_svtype(vartype_t type)
44 return SVt_PV; /* or whatever */
58 vartype_t string_to_vartype(char *vartype)
60 if (strEQ(vartype, "SCALAR")) {
63 else if (strEQ(vartype, "ARRAY")) {
66 else if (strEQ(vartype, "HASH")) {
69 else if (strEQ(vartype, "CODE")) {
72 else if (strEQ(vartype, "IO")) {
76 croak("Type must be one of 'SCALAR', 'ARRAY', 'HASH', 'CODE', or 'IO'");
80 void _deconstruct_variable_name(char *variable, varspec_t *varspec)
82 if (!variable || !variable[0])
83 croak("You must pass a variable name");
85 varspec->type = VAR_NONE;
87 switch (variable[0]) {
89 varspec->type = VAR_SCALAR;
92 varspec->type = VAR_ARRAY;
95 varspec->type = VAR_HASH;
98 varspec->type = VAR_CODE;
102 if (varspec->type != VAR_NONE) {
103 varspec->sigil = variable[0];
104 varspec->name = &variable[1];
107 varspec->type = VAR_IO;
108 varspec->sigil = '\0';
109 varspec->name = variable;
113 void _deconstruct_variable_hash(HV *variable, varspec_t *varspec)
117 val = hv_fetch(variable, "name", 4, 0);
119 croak("The 'name' key is required in variable specs");
121 varspec->name = savesvpv(*val);
122 SAVEFREEPV(varspec->name);
124 val = hv_fetch(variable, "sigil", 5, 0);
126 croak("The 'sigil' key is required in variable specs");
128 varspec->sigil = (SvPV_nolen(*val))[0];
130 val = hv_fetch(variable, "type", 4, 0);
132 croak("The 'type' key is required in variable specs");
134 varspec->type = string_to_vartype(SvPV_nolen(*val));
137 int _valid_for_type(SV *value, vartype_t type)
139 svtype sv_type = SvROK(value) ? SvTYPE(SvRV(value)) : SVt_NULL;
143 return sv_type == SVt_NULL ||
149 return sv_type == SVt_PVAV;
151 return sv_type == SVt_PVHV;
153 return sv_type == SVt_PVCV;
155 return sv_type == SVt_PVIO;
161 HV *_get_namespace(SV *self)
170 call_method("namespace", G_SCALAR);
176 return (HV*)SvRV(ret);
179 SV *_get_name(SV *self)
188 call_method("name", G_SCALAR);
197 SV *_get_package_symbol(SV *self, varspec_t *variable, int vivify)
203 namespace = _get_namespace(self);
204 entry = hv_fetch(namespace, variable->name, strlen(variable->name), vivify);
208 glob = (GV*)(*entry);
212 namesv = newSVsv(_get_name(self));
213 sv_catpvs(namesv, "::");
214 sv_catpv(namesv, variable->name);
216 /* can't use gv_init here, because it screws up @ISA in a way that I
217 * can't reproduce, but that CMOP triggers */
218 gv_fetchsv(namesv, GV_ADD, vartype_to_svtype(variable->type));
219 SvREFCNT_dec(namesv);
223 switch (variable->type) {
226 GvSV(glob) = newSV(0);
230 GvAV(glob) = newAV();
234 GvHV(glob) = newHV();
237 croak("Don't know how to vivify CODE variables");
240 GvIOp(glob) = newIO();
243 croak("Unknown type in vivication");
247 switch (variable->type) {
251 return (SV*)GvAV(glob);
253 return (SV*)GvHV(glob);
255 return (SV*)GvCV(glob);
257 return (SV*)GvIO(glob);
263 MODULE = Package::Stash PACKAGE = Package::Stash
268 new(class, package_name)
275 if (!SvPOK(package_name))
276 croak("The constructor argument must be the name of a package");
280 hv_store(instance, "name", 4, SvREFCNT_inc(package_name), 0);
281 namespace = gv_stashpv(SvPV_nolen(package_name), GV_ADD);
282 hv_store(instance, "namespace", 9, newRV_inc((SV*)namespace), 0);
284 RETVAL = sv_bless(newRV_noinc((SV*)instance), gv_stashpv(class, 0));
294 if (!sv_isobject(self))
295 croak("Can't call name as a class method");
296 slot = hv_fetch((HV*)SvRV(self), "name", 4, 0);
297 RETVAL = slot ? SvREFCNT_inc(*slot) : &PL_sv_undef;
307 if (!sv_isobject(self))
308 croak("Can't call namespace as a class method");
309 slot = hv_fetch((HV*)SvRV(self), "namespace", 9, 0);
310 RETVAL = slot ? SvREFCNT_inc(*slot) : &PL_sv_undef;
315 add_package_symbol(self, variable, initial=NULL, ...)
323 if (initial && !_valid_for_type(initial, variable.type))
324 croak("%s is not of type %s",
325 SvPV_nolen(initial), vartype_to_string(variable.type));
327 name = newSVsv(_get_name(self));
328 sv_catpvs(name, "::");
329 sv_catpv(name, variable.name);
331 /* XXX: come back to this when i feel like reimplementing caller() */
333 my $filename = $opts{filename};
334 my $first_line_num = $opts{first_line_num};
336 (undef, $filename, $first_line_num) = caller
337 if not defined $filename;
339 my $last_line_num = $opts{last_line_num} || ($first_line_num ||= 0);
341 # http://perldoc.perl.org/perldebguts.html#Debugger-Internals
342 $DB::sub{$pkg . '::' . $name} = "$filename:$first_line_num-$last_line_num";
345 if (items > 2 && (PL_perldb & 0x10) && variable.type == VAR_CODE) {
347 char *filename = NULL, *name;
348 I32 first_line_num, last_line_num;
351 croak("add_package_symbol: Odd number of elements in %%opts");
353 for (i = 3; i < items; i += 2) {
355 key = SvPV_nolen(ST(i));
356 if (strEQ(key, "filename")) {
357 if (!SvPOK(ST(i + 1)))
358 croak("add_package_symbol: filename must be a string");
359 filename = SvPV_nolen(ST(i + 1));
361 else if (strEQ(key, "first_line_num")) {
362 if (!SvIOK(ST(i + 1)))
363 croak("add_package_symbol: first_line_num must be an integer");
364 first_line_num = SvIV(ST(i + 1));
366 else if (strEQ(key, "last_line_num")) {
367 if (!SvIOK(ST(i + 1)))
368 croak("add_package_symbol: last_line_num must be an integer");
369 last_line_num = SvIV(ST(i + 1));
378 glob = gv_fetchsv(name, GV_ADDMULTI, vartype_to_svtype(variable.type));
383 if (SvROK(initial)) {
388 val = newSVsv(initial);
391 switch (variable.type) {
394 SvREFCNT_dec(GvSV(glob));
399 SvREFCNT_dec((SV*)GvAV(glob));
400 GvAV(glob) = (AV*)val;
404 SvREFCNT_dec((SV*)GvHV(glob));
405 GvHV(glob) = (HV*)val;
409 SvREFCNT_dec((SV*)GvCV(glob));
410 GvCV(glob) = (CV*)val;
414 SvREFCNT_dec((SV*)GvIO(glob));
415 GvIOp(glob) = (IO*)val;
423 remove_package_glob(self, name)
427 hv_delete(_get_namespace(self), name, strlen(name), G_DISCARD);
430 has_package_symbol(self, variable)
437 namespace = _get_namespace(self);
438 entry = hv_fetch(namespace, variable.name, strlen(variable.name), 0);
443 GV *glob = (GV*)(*entry);
444 switch (variable.type) {
446 RETVAL = GvSV(glob) ? 1 : 0;
449 RETVAL = GvAV(glob) ? 1 : 0;
452 RETVAL = GvHV(glob) ? 1 : 0;
455 RETVAL = GvCV(glob) ? 1 : 0;
458 RETVAL = GvIO(glob) ? 1 : 0;
463 RETVAL = (variable.type == VAR_CODE);
469 get_package_symbol(self, variable)
475 val = _get_package_symbol(self, &variable, 0);
478 RETVAL = newRV_inc(val);
483 get_or_add_package_symbol(self, variable)
489 val = _get_package_symbol(self, &variable, 1);
492 RETVAL = newRV_inc(val);
497 remove_package_symbol(self, variable)
504 namespace = _get_namespace(self);
505 entry = hv_fetch(namespace, variable.name, strlen(variable.name), 0);
510 GV *glob = (GV*)(*entry);
511 switch (variable.type) {
513 GvSV(glob) = (SV *)NULL;
516 GvAV(glob) = (AV *)NULL;
519 GvHV(glob) = (HV *)NULL;
522 GvCV(glob) = (CV *)NULL;
525 GvIOp(glob) = (IO *)NULL;
530 if (variable.type == VAR_CODE) {
531 hv_delete(namespace, variable.name, strlen(variable.name), G_DISCARD);
536 list_all_package_symbols(self, vartype=VAR_NONE)
540 if (vartype == VAR_NONE) {
545 namespace = _get_namespace(self);
546 keys = hv_iterinit(namespace);
548 while ((entry = hv_iternext(namespace))) {
549 mPUSHs(newSVhek(HeKEY_hek(entry)));
558 namespace = _get_namespace(self);
559 hv_iterinit(namespace);
560 while ((val = hv_iternextsv(namespace, &key, &len))) {
586 else if (vartype == VAR_CODE) {