3 * Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4 * 2005, 2006, 2007 by Larry Wall and others
6 * You may distribute under the terms of either the GNU General Public
7 * License or the Artistic License, as specified in the README file.
12 * "The roots of those mountains must be roots indeed; there must be
13 * great secrets buried there which have not been discovered since the
14 * beginning." --Gandalf, relating Gollum's story
17 /* This file contains the code that implements the functions in Perl's
18 * UNIVERSAL package, such as UNIVERSAL->can().
22 #define PERL_IN_UNIVERSAL_C
26 #include "perliol.h" /* For the PERLIO_F_XXX */
30 * Contributed by Graham Barr <Graham.Barr@tiuk.ti.com>
31 * The main guts of traverse_isa was actually copied from gv_fetchmeth
35 S_isa_lookup(pTHX_ HV *stash, const char *name, const HV* const name_stash,
46 /* A stash/class can go by many names (ie. User == main::User), so
47 we compare the stash itself just in case */
48 if (name_stash && ((const HV *)stash == name_stash))
51 hvname = HvNAME_get(stash);
53 if (strEQ(hvname, name))
56 if (strEQ(name, "UNIVERSAL"))
60 Perl_croak(aTHX_ "Recursive inheritance detected in package '%s'",
63 gvp = (GV**)hv_fetchs(stash, "::ISA::CACHE::", FALSE);
65 if (gvp && (gv = *gvp) && isGV_with_GP(gv) && (subgen = GvSV(gv))
68 if (SvIV(subgen) == (IV)PL_sub_generation) {
69 SV** const svp = (SV**)hv_fetch(hv, name, len, FALSE);
73 if (sv != &PL_sv_undef)
74 DEBUG_o( Perl_deb(aTHX_ "Using cached ISA %s for package %s\n",
77 return (sv == &PL_sv_yes);
81 DEBUG_o( Perl_deb(aTHX_ "ISA Cache in package %s is stale\n",
84 sv_setiv(subgen, PL_sub_generation);
88 gvp = (GV**)hv_fetchs(stash, "ISA", FALSE);
90 if (gvp && (gv = *gvp) && isGV_with_GP(gv) && (av = GvAV(gv))) {
92 gvp = (GV**)hv_fetchs(stash, "::ISA::CACHE::", TRUE);
96 if (SvTYPE(gv) != SVt_PVGV)
97 gv_init(gv, stash, "::ISA::CACHE::", 14, TRUE);
102 subgen = newSViv(PL_sub_generation);
107 SV** svp = AvARRAY(av);
108 /* NOTE: No support for tied ISA */
109 I32 items = AvFILLp(av) + 1;
111 SV* const sv = *svp++;
112 HV* const basestash = gv_stashsv(sv, 0);
114 if (ckWARN(WARN_MISC))
115 Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
116 "Can't locate package %"SVf" for @%s::ISA",
120 if (isa_lookup(basestash, name, name_stash, len, level + 1)) {
121 (void)hv_store(hv,name,len,&PL_sv_yes,0);
125 (void)hv_store(hv,name,len,&PL_sv_no,0);
132 =head1 SV Manipulation Functions
134 =for apidoc sv_derived_from
136 Returns a boolean indicating whether the SV is derived from the specified class
137 I<at the C level>. To check derivation at the Perl level, call C<isa()> as a
144 Perl_sv_derived_from(pTHX_ SV *sv, const char *name)
154 type = sv_reftype(sv,0);
155 if (type && strEQ(type,name))
157 stash = SvOBJECT(sv) ? SvSTASH(sv) : NULL;
160 stash = gv_stashsv(sv, 0);
164 HV * const name_stash = gv_stashpv(name, 0);
165 return isa_lookup(stash, name, name_stash, strlen(name), 0);
175 Returns a boolean indicating whether the SV performs a specific, named role.
176 The SV can be a Perl object or the name of a Perl class.
184 Perl_sv_does(pTHX_ SV *sv, const char *name)
186 const char *classname;
195 if (!SvOK(sv) || !(SvROK(sv) || (SvPOK(sv) && SvCUR(sv))
196 || (SvGMAGICAL(sv) && SvPOKp(sv) && SvCUR(sv))))
199 if (sv_isobject(sv)) {
200 classname = sv_reftype(SvRV(sv),TRUE);
202 classname = SvPV_nolen(sv);
205 if (strEQ(name,classname))
210 XPUSHs(sv_2mortal(newSVpv(name, 0)));
213 call_method("isa", G_SCALAR);
216 does_it = SvTRUE( TOPs );
224 Perl_get_re_arg( pTHX_ SV *sv, U32 flags, MAGIC **mgp) {
230 (sv = (SV*)SvRV(sv)) && /* assign deliberate */
231 SvTYPE(sv) == SVt_PVMG &&
232 (mg = mg_find(sv, PERL_MAGIC_qr))) /* assign deliberate */
235 return (regexp *)mg->mg_obj;
238 if (mgp) *mgp = NULL;
239 return ((flags && PL_curpm) ? PM_GETRE(PL_curpm) : NULL);
243 PERL_XS_EXPORT_C void XS_UNIVERSAL_isa(pTHX_ CV *cv);
244 PERL_XS_EXPORT_C void XS_UNIVERSAL_can(pTHX_ CV *cv);
245 PERL_XS_EXPORT_C void XS_UNIVERSAL_DOES(pTHX_ CV *cv);
246 PERL_XS_EXPORT_C void XS_UNIVERSAL_VERSION(pTHX_ CV *cv);
248 XS(XS_version_stringify);
249 XS(XS_version_numify);
250 XS(XS_version_normal);
252 XS(XS_version_boolean);
253 #ifdef HASATTRIBUTE_NORETURN
254 XS(XS_version_noop) __attribute__noreturn__;
258 XS(XS_version_is_alpha);
265 XS(XS_utf8_downgrade);
266 XS(XS_utf8_unicode_to_native);
267 XS(XS_utf8_native_to_unicode);
268 XS(XS_Internals_SvREADONLY);
269 XS(XS_Internals_SvREFCNT);
270 XS(XS_Internals_hv_clear_placehold);
271 XS(XS_PerlIO_get_layers);
272 XS(XS_Regexp_DESTROY);
273 XS(XS_Internals_hash_seed);
274 XS(XS_Internals_rehash_seed);
275 XS(XS_Internals_HvREHASH);
276 XS(XS_Internals_inc_sub_generation);
280 XS(XS_re_regnames_iterinit);
281 XS(XS_re_regnames_iternext);
282 XS(XS_re_regnames_count);
285 Perl_boot_core_UNIVERSAL(pTHX)
288 static const char file[] = __FILE__;
290 newXS("UNIVERSAL::isa", XS_UNIVERSAL_isa, file);
291 newXS("UNIVERSAL::can", XS_UNIVERSAL_can, file);
292 newXS("UNIVERSAL::DOES", XS_UNIVERSAL_DOES, file);
293 newXS("UNIVERSAL::VERSION", XS_UNIVERSAL_VERSION, file);
295 /* register the overloading (type 'A') magic */
296 PL_amagic_generation++;
297 /* Make it findable via fetchmethod */
298 newXS("version::()", XS_version_noop, file);
299 newXS("version::new", XS_version_new, file);
300 newXS("version::(\"\"", XS_version_stringify, file);
301 newXS("version::stringify", XS_version_stringify, file);
302 newXS("version::(0+", XS_version_numify, file);
303 newXS("version::numify", XS_version_numify, file);
304 newXS("version::normal", XS_version_normal, file);
305 newXS("version::(cmp", XS_version_vcmp, file);
306 newXS("version::(<=>", XS_version_vcmp, file);
307 newXS("version::vcmp", XS_version_vcmp, file);
308 newXS("version::(bool", XS_version_boolean, file);
309 newXS("version::boolean", XS_version_boolean, file);
310 newXS("version::(nomethod", XS_version_noop, file);
311 newXS("version::noop", XS_version_noop, file);
312 newXS("version::is_alpha", XS_version_is_alpha, file);
313 newXS("version::qv", XS_version_qv, file);
315 newXS("utf8::is_utf8", XS_utf8_is_utf8, file);
316 newXS("utf8::valid", XS_utf8_valid, file);
317 newXS("utf8::encode", XS_utf8_encode, file);
318 newXS("utf8::decode", XS_utf8_decode, file);
319 newXS("utf8::upgrade", XS_utf8_upgrade, file);
320 newXS("utf8::downgrade", XS_utf8_downgrade, file);
321 newXS("utf8::native_to_unicode", XS_utf8_native_to_unicode, file);
322 newXS("utf8::unicode_to_native", XS_utf8_unicode_to_native, file);
323 newXSproto("Internals::SvREADONLY",XS_Internals_SvREADONLY, file, "\\[$%@];$");
324 newXSproto("Internals::SvREFCNT",XS_Internals_SvREFCNT, file, "\\[$%@];$");
325 newXSproto("Internals::hv_clear_placeholders",
326 XS_Internals_hv_clear_placehold, file, "\\%");
327 newXSproto("PerlIO::get_layers",
328 XS_PerlIO_get_layers, file, "*;@");
329 newXS("Regexp::DESTROY", XS_Regexp_DESTROY, file);
330 newXSproto("Internals::hash_seed",XS_Internals_hash_seed, file, "");
331 newXSproto("Internals::rehash_seed",XS_Internals_rehash_seed, file, "");
332 newXSproto("Internals::HvREHASH", XS_Internals_HvREHASH, file, "\\%");
333 newXSproto("Internals::inc_sub_generation",XS_Internals_inc_sub_generation,
335 newXSproto("re::is_regexp", XS_re_is_regexp, file, "$");
336 newXSproto("re::regname", XS_re_regname, file, ";$$");
337 newXSproto("re::regnames", XS_re_regnames, file, ";$");
338 newXSproto("re::regnames_iterinit", XS_re_regnames_iterinit, file, "");
339 newXSproto("re::regnames_iternext", XS_re_regnames_iternext, file, ";$");
340 newXSproto("re::regnames_count", XS_re_regnames_count, file, "");
351 Perl_croak(aTHX_ "Usage: UNIVERSAL::isa(reference, kind)");
353 SV * const sv = ST(0);
358 if (!SvOK(sv) || !(SvROK(sv) || (SvPOK(sv) && SvCUR(sv))
359 || (SvGMAGICAL(sv) && SvPOKp(sv) && SvCUR(sv))))
362 name = SvPV_nolen_const(ST(1));
364 ST(0) = boolSV(sv_derived_from(sv, name));
380 Perl_croak(aTHX_ "Usage: UNIVERSAL::can(object-ref, method)");
386 if (!SvOK(sv) || !(SvROK(sv) || (SvPOK(sv) && SvCUR(sv))
387 || (SvGMAGICAL(sv) && SvPOKp(sv) && SvCUR(sv))))
390 name = SvPV_nolen_const(ST(1));
399 pkg = gv_stashsv(sv, 0);
403 GV * const gv = gv_fetchmethod_autoload(pkg, name, FALSE);
405 rv = sv_2mortal(newRV((SV*)GvCV(gv)));
412 XS(XS_UNIVERSAL_DOES)
419 Perl_croak(aTHX_ "Usage: invocant->does(kind)");
421 SV * const sv = ST(0);
424 name = SvPV_nolen_const(ST(1));
425 if (sv_does( sv, name ))
432 XS(XS_UNIVERSAL_VERSION)
444 sv = (SV*)SvRV(ST(0));
446 Perl_croak(aTHX_ "Cannot find version of an unblessed reference");
450 pkg = gv_stashsv(ST(0), 0);
453 gvp = pkg ? (GV**)hv_fetchs(pkg, "VERSION", FALSE) : NULL;
455 if (gvp && isGV(gv = *gvp) && (sv = GvSV(gv)) && SvOK(sv)) {
456 SV * const nsv = sv_newmortal();
459 if ( !sv_derived_from(sv, "version"))
460 upg_version(sv, FALSE);
464 sv = (SV*)&PL_sv_undef;
473 const char * const name = HvNAME_get(pkg);
475 "%s does not define $%s::VERSION--version check failed",
479 "%s defines neither package nor VERSION--version check failed",
480 SvPVx_nolen_const(ST(0)) );
484 if ( !sv_derived_from(req, "version")) {
485 /* req may very well be R/O, so create a new object */
486 req = sv_2mortal( new_version(req) );
489 if ( vcmp( req, sv ) > 0 ) {
490 if ( hv_exists((HV*)SvRV(req), "qv", 2 ) ) {
491 Perl_croak(aTHX_ "%s version %"SVf" required--"
492 "this is only version %"SVf"", HvNAME_get(pkg),
493 SVfARG(vnormal(req)),
494 SVfARG(vnormal(sv)));
496 Perl_croak(aTHX_ "%s version %"SVf" required--"
497 "this is only version %"SVf"", HvNAME_get(pkg),
498 SVfARG(vnumify(req)),
499 SVfARG(vnumify(sv)));
505 if ( SvOK(sv) && sv_derived_from(sv, "version") ) {
520 Perl_croak(aTHX_ "Usage: version::new(class, version)");
525 const char * const classname =
526 sv_isobject(ST(0)) /* get the class if called as an object method */
527 ? HvNAME(SvSTASH(SvRV(ST(0))))
528 : (char *)SvPV_nolen(ST(0));
530 if ( items == 1 || vs == &PL_sv_undef ) { /* no param or explicit undef */
531 /* create empty object */
535 else if ( items == 3 ) {
537 Perl_sv_setpvf(aTHX_ vs,"v%s",SvPV_nolen_const(ST(2)));
540 rv = new_version(vs);
541 if ( strcmp(classname,"version") != 0 ) /* inherited new() */
542 sv_bless(rv, gv_stashpv(classname, GV_ADD));
544 PUSHs(sv_2mortal(rv));
550 XS(XS_version_stringify)
556 Perl_croak(aTHX_ "Usage: version::stringify(lobj, ...)");
561 if (sv_derived_from(ST(0), "version")) {
565 Perl_croak(aTHX_ "lobj is not of type version");
567 PUSHs(sv_2mortal(vstringify(lobj)));
574 XS(XS_version_numify)
580 Perl_croak(aTHX_ "Usage: version::numify(lobj, ...)");
585 if (sv_derived_from(ST(0), "version")) {
589 Perl_croak(aTHX_ "lobj is not of type version");
591 PUSHs(sv_2mortal(vnumify(lobj)));
598 XS(XS_version_normal)
604 Perl_croak(aTHX_ "Usage: version::normal(lobj, ...)");
609 if (sv_derived_from(ST(0), "version")) {
613 Perl_croak(aTHX_ "lobj is not of type version");
615 PUSHs(sv_2mortal(vnormal(lobj)));
628 Perl_croak(aTHX_ "Usage: version::vcmp(lobj, ...)");
633 if (sv_derived_from(ST(0), "version")) {
637 Perl_croak(aTHX_ "lobj is not of type version");
643 const IV swap = (IV)SvIV(ST(2));
645 if ( ! sv_derived_from(robj, "version") )
647 robj = new_version(robj);
653 rs = newSViv(vcmp(rvs,lobj));
657 rs = newSViv(vcmp(lobj,rvs));
660 PUSHs(sv_2mortal(rs));
668 XS(XS_version_boolean)
674 Perl_croak(aTHX_ "Usage: version::boolean(lobj, ...)");
676 if (sv_derived_from(ST(0), "version")) {
677 SV * const lobj = SvRV(ST(0));
678 SV * const rs = newSViv( vcmp(lobj,new_version(newSVpvs("0"))) );
679 PUSHs(sv_2mortal(rs));
684 Perl_croak(aTHX_ "lobj is not of type version");
693 Perl_croak(aTHX_ "Usage: version::noop(lobj, ...)");
694 if (sv_derived_from(ST(0), "version"))
695 Perl_croak(aTHX_ "operation not supported with version object");
697 Perl_croak(aTHX_ "lobj is not of type version");
698 #ifndef HASATTRIBUTE_NORETURN
703 XS(XS_version_is_alpha)
709 Perl_croak(aTHX_ "Usage: version::is_alpha(lobj)");
711 if (sv_derived_from(ST(0), "version")) {
712 SV * const lobj = ST(0);
713 if ( hv_exists((HV*)SvRV(lobj), "alpha", 5 ) )
721 Perl_croak(aTHX_ "lobj is not of type version");
730 Perl_croak(aTHX_ "Usage: version::qv(ver)");
734 if ( !SvVOK(ver) ) { /* only need to do with if not already v-string */
735 SV * const rv = sv_newmortal();
736 sv_setsv(rv,ver); /* make a duplicate */
737 upg_version(rv, TRUE);
742 PUSHs(sv_2mortal(new_version(ver)));
756 Perl_croak(aTHX_ "Usage: utf8::is_utf8(sv)");
758 const SV * const sv = ST(0);
773 Perl_croak(aTHX_ "Usage: utf8::valid(sv)");
775 SV * const sv = ST(0);
777 const char * const s = SvPV_const(sv,len);
778 if (!SvUTF8(sv) || is_utf8_string((const U8*)s,len))
792 Perl_croak(aTHX_ "Usage: utf8::encode(sv)");
793 sv_utf8_encode(ST(0));
803 Perl_croak(aTHX_ "Usage: utf8::decode(sv)");
805 SV * const sv = ST(0);
806 const bool RETVAL = sv_utf8_decode(sv);
807 ST(0) = boolSV(RETVAL);
819 Perl_croak(aTHX_ "Usage: utf8::upgrade(sv)");
821 SV * const sv = ST(0);
825 RETVAL = sv_utf8_upgrade(sv);
826 XSprePUSH; PUSHi((IV)RETVAL);
831 XS(XS_utf8_downgrade)
836 if (items < 1 || items > 2)
837 Perl_croak(aTHX_ "Usage: utf8::downgrade(sv, failok=0)");
839 SV * const sv = ST(0);
840 const bool failok = (items < 2) ? 0 : (int)SvIV(ST(1));
841 const bool RETVAL = sv_utf8_downgrade(sv, failok);
843 ST(0) = boolSV(RETVAL);
849 XS(XS_utf8_native_to_unicode)
853 const UV uv = SvUV(ST(0));
857 Perl_croak(aTHX_ "Usage: utf8::native_to_unicode(sv)");
859 ST(0) = sv_2mortal(newSViv(NATIVE_TO_UNI(uv)));
863 XS(XS_utf8_unicode_to_native)
867 const UV uv = SvUV(ST(0));
871 Perl_croak(aTHX_ "Usage: utf8::unicode_to_native(sv)");
873 ST(0) = sv_2mortal(newSViv(UNI_TO_NATIVE(uv)));
877 XS(XS_Internals_SvREADONLY) /* This is dangerous stuff. */
881 SV * const sv = SvRV(ST(0));
890 else if (items == 2) {
896 /* I hope you really know what you are doing. */
901 XSRETURN_UNDEF; /* Can't happen. */
904 XS(XS_Internals_SvREFCNT) /* This is dangerous stuff. */
908 SV * const sv = SvRV(ST(0));
912 XSRETURN_IV(SvREFCNT(sv) - 1); /* Minus the ref created for us. */
913 else if (items == 2) {
914 /* I hope you really know what you are doing. */
915 SvREFCNT(sv) = SvIV(ST(1));
916 XSRETURN_IV(SvREFCNT(sv));
918 XSRETURN_UNDEF; /* Can't happen. */
921 XS(XS_Internals_hv_clear_placehold)
928 Perl_croak(aTHX_ "Usage: UNIVERSAL::hv_clear_placeholders(hv)");
930 HV * const hv = (HV *) SvRV(ST(0));
931 hv_clear_placeholders(hv);
936 XS(XS_Regexp_DESTROY)
942 XS(XS_PerlIO_get_layers)
947 if (items < 1 || items % 2 == 0)
948 Perl_croak(aTHX_ "Usage: PerlIO_get_layers(filehandle[,args])");
955 bool details = FALSE;
959 for (svp = MARK + 2; svp <= SP; svp += 2) {
960 SV * const * const varp = svp;
961 SV * const * const valp = svp + 1;
963 const char * const key = SvPV_const(*varp, klen);
967 if (klen == 5 && memEQ(key, "input", 5)) {
968 input = SvTRUE(*valp);
973 if (klen == 6 && memEQ(key, "output", 6)) {
974 input = !SvTRUE(*valp);
979 if (klen == 7 && memEQ(key, "details", 7)) {
980 details = SvTRUE(*valp);
987 "get_layers: unknown argument '%s'",
999 if (SvROK(sv) && isGV(SvRV(sv)))
1001 else if (SvPOKp(sv))
1002 gv = gv_fetchsv(sv, 0, SVt_PVIO);
1005 if (gv && (io = GvIO(gv))) {
1007 AV* const av = PerlIO_get_layers(aTHX_ input ?
1008 IoIFP(io) : IoOFP(io));
1010 const I32 last = av_len(av);
1013 for (i = last; i >= 0; i -= 3) {
1014 SV * const * const namsvp = av_fetch(av, i - 2, FALSE);
1015 SV * const * const argsvp = av_fetch(av, i - 1, FALSE);
1016 SV * const * const flgsvp = av_fetch(av, i, FALSE);
1018 const bool namok = namsvp && *namsvp && SvPOK(*namsvp);
1019 const bool argok = argsvp && *argsvp && SvPOK(*argsvp);
1020 const bool flgok = flgsvp && *flgsvp && SvIOK(*flgsvp);
1024 ? newSVpvn(SvPVX_const(*namsvp), SvCUR(*namsvp))
1027 ? newSVpvn(SvPVX_const(*argsvp), SvCUR(*argsvp))
1030 XPUSHi(SvIVX(*flgsvp));
1032 XPUSHs(&PL_sv_undef);
1037 XPUSHs(Perl_newSVpvf(aTHX_ "%"SVf"(%"SVf")",
1041 XPUSHs(Perl_newSVpvf(aTHX_ "%"SVf,
1044 XPUSHs(&PL_sv_undef);
1047 const IV flags = SvIVX(*flgsvp);
1049 if (flags & PERLIO_F_UTF8) {
1050 XPUSHs(newSVpvs("utf8"));
1067 XS(XS_Internals_hash_seed)
1070 /* Using dXSARGS would also have dITEM and dSP,
1071 * which define 2 unused local variables. */
1073 PERL_UNUSED_ARG(cv);
1074 PERL_UNUSED_VAR(mark);
1075 XSRETURN_UV(PERL_HASH_SEED);
1078 XS(XS_Internals_rehash_seed)
1081 /* Using dXSARGS would also have dITEM and dSP,
1082 * which define 2 unused local variables. */
1084 PERL_UNUSED_ARG(cv);
1085 PERL_UNUSED_VAR(mark);
1086 XSRETURN_UV(PL_rehash_seed);
1089 XS(XS_Internals_HvREHASH) /* Subject to change */
1093 PERL_UNUSED_ARG(cv);
1095 const HV * const hv = (HV *) SvRV(ST(0));
1096 if (items == 1 && SvTYPE(hv) == SVt_PVHV) {
1103 Perl_croak(aTHX_ "Internals::HvREHASH $hashref");
1106 XS(XS_Internals_inc_sub_generation)
1109 /* Using dXSARGS would also have dITEM and dSP,
1110 * which define 2 unused local variables. */
1112 PERL_UNUSED_ARG(cv);
1113 PERL_UNUSED_VAR(mark);
1114 ++PL_sub_generation;
1123 Perl_croak(aTHX_ "Usage: %s(%s)", "re::is_regexp", "sv");
1124 PERL_UNUSED_VAR(cv); /* -W */
1125 PERL_UNUSED_VAR(ax); /* -Wall */
1129 if ( Perl_get_re_arg( aTHX_ sv, 0, NULL ) )
1146 if (items < 1 || items > 2)
1147 Perl_croak(aTHX_ "Usage: %s(%s)", "re::regname", "name[, all ]");
1148 PERL_UNUSED_VAR(cv); /* -W */
1149 PERL_UNUSED_VAR(ax); /* -Wall */
1154 regexp *re = PL_curpm ? PM_GETRE(PL_curpm) : NULL;
1163 if (SvPOK(sv) && re && re->paren_names) {
1164 bufs = CALLREG_NAMEDBUF(re,sv,all && SvTRUE(all));
1166 if (all && SvTRUE(all))
1167 XPUSHs(newRV(bufs));
1169 XPUSHs(SvREFCNT_inc(bufs));
1184 if (items < 0 || items > 1)
1185 Perl_croak(aTHX_ "Usage: %s(%s)", "re::regnames", "[all]");
1186 PERL_UNUSED_VAR(cv); /* -W */
1187 PERL_UNUSED_VAR(ax); /* -Wall */
1191 regexp *re = PL_curpm ? PM_GETRE(PL_curpm) : NULL;
1200 if (re && re->paren_names) {
1201 HV *hv= re->paren_names;
1202 (void)hv_iterinit(hv);
1204 HE *temphe = hv_iternext_flags(hv,0);
1208 SV* sv_dat = HeVAL(temphe);
1209 I32 *nums = (I32*)SvPVX(sv_dat);
1210 for ( i = 0; i < SvIVX(sv_dat); i++ ) {
1211 if ((I32)(re->lastcloseparen) >= nums[i] &&
1212 re->offs[nums[i]].start != -1 &&
1213 re->offs[nums[i]].end != -1)
1219 if (parno || (all && SvTRUE(all))) {
1221 char *pv = HePV(temphe, len);
1222 if ( GIMME_V == G_ARRAY )
1223 XPUSHs(newSVpvn(pv,len));
1231 if ( GIMME_V == G_ARRAY )
1242 XS(XS_re_regnames_iterinit)
1247 Perl_croak(aTHX_ "Usage: re::regnames_iterinit()");
1248 PERL_UNUSED_VAR(cv); /* -W */
1249 PERL_UNUSED_VAR(ax); /* -Wall */
1252 regexp *re = PL_curpm ? PM_GETRE(PL_curpm) : NULL;
1253 if (re && re->paren_names) {
1254 (void)hv_iterinit(re->paren_names);
1255 XPUSHs(newSViv(HvTOTALKEYS(re->paren_names)));
1265 XS(XS_re_regnames_iternext)
1269 if (items < 0 || items > 1)
1270 Perl_croak(aTHX_ "Usage: %s(%s)", "re::regnames_iternext", "[all]");
1271 PERL_UNUSED_VAR(cv); /* -W */
1272 PERL_UNUSED_VAR(ax); /* -Wall */
1276 regexp *re = PL_curpm ? PM_GETRE(PL_curpm) : NULL;
1283 if (re && re->paren_names) {
1284 HV *hv= re->paren_names;
1286 HE *temphe = hv_iternext_flags(hv,0);
1290 SV* sv_dat = HeVAL(temphe);
1291 I32 *nums = (I32*)SvPVX(sv_dat);
1292 for ( i = 0; i < SvIVX(sv_dat); i++ ) {
1293 if ((I32)(re->lastcloseparen) >= nums[i] &&
1294 re->offs[nums[i]].start != -1 &&
1295 re->offs[nums[i]].end != -1)
1301 if (parno || (all && SvTRUE(all))) {
1303 char *pv = HePV(temphe, len);
1304 XPUSHs(newSVpvn(pv,len));
1319 XS(XS_re_regnames_count)
1321 regexp *re = PL_curpm ? PM_GETRE(PL_curpm) : NULL;
1326 Perl_croak(aTHX_ "Usage: %s(%s)", "re::regnames_count", "");
1327 PERL_UNUSED_VAR(cv); /* -W */
1328 PERL_UNUSED_VAR(ax); /* -Wall */
1331 if (re && re->paren_names) {
1332 XPUSHs(newSViv(HvTOTALKEYS(re->paren_names)));
1343 * c-indentation-style: bsd
1345 * indent-tabs-mode: t
1348 * ex: set ts=8 sts=4 sw=4 noet: