[p5sagit/p5-mst-13.2.git] / universal.c

/*    universal.c
 *
 *    Copyright (c) 1997-2002, Larry Wall
 *
 *    You may distribute under the terms of either the GNU General Public
 *    License or the Artistic License, as specified in the README file.
 *
 */

/*
 * "The roots of those mountains must be roots indeed; there must be
 * great secrets buried there which have not been discovered since the
 * beginning." --Gandalf, relating Gollum's story
 */

#include "EXTERN.h"
#define PERL_IN_UNIVERSAL_C
#include "perl.h"

/*
 * Contributed by Graham Barr  <Graham.Barr@tiuk.ti.com>
 * The main guts of traverse_isa was actually copied from gv_fetchmeth
 */

STATIC SV *
S_isa_lookup(pTHX_ HV *stash, const char *name, HV* name_stash,
             int len, int level)
{
    AV* av;
    GV* gv;
    GV** gvp;
    HV* hv = Nullhv;
    SV* subgen = Nullsv;

    /* A stash/class can go by many names (ie. User == main::User), so 
       we compare the stash itself just in case */
    if (name_stash && (stash == name_stash))
        return &PL_sv_yes;

    if (strEQ(HvNAME(stash), name))
	return &PL_sv_yes;

    if (level > 100)
	Perl_croak(aTHX_ "Recursive inheritance detected in package '%s'",
		   HvNAME(stash));

    gvp = (GV**)hv_fetch(stash, "::ISA::CACHE::", 14, FALSE);

    if (gvp && (gv = *gvp) != (GV*)&PL_sv_undef && (subgen = GvSV(gv))
	&& (hv = GvHV(gv)))
    {
	if (SvIV(subgen) == PL_sub_generation) {
	    SV* sv;
	    SV** svp = (SV**)hv_fetch(hv, name, len, FALSE);
	    if (svp && (sv = *svp) != (SV*)&PL_sv_undef) {
	        DEBUG_o( Perl_deb(aTHX_ "Using cached ISA %s for package %s\n",
				  name, HvNAME(stash)) );
		return sv;
	    }
	}
	else {
	    DEBUG_o( Perl_deb(aTHX_ "ISA Cache in package %s is stale\n",
			      HvNAME(stash)) );
	    hv_clear(hv);
	    sv_setiv(subgen, PL_sub_generation);
	}
    }

    gvp = (GV**)hv_fetch(stash,"ISA",3,FALSE);

    if (gvp && (gv = *gvp) != (GV*)&PL_sv_undef && (av = GvAV(gv))) {
	if (!hv || !subgen) {
	    gvp = (GV**)hv_fetch(stash, "::ISA::CACHE::", 14, TRUE);

	    gv = *gvp;

	    if (SvTYPE(gv) != SVt_PVGV)
		gv_init(gv, stash, "::ISA::CACHE::", 14, TRUE);

	    if (!hv)
		hv = GvHVn(gv);
	    if (!subgen) {
		subgen = newSViv(PL_sub_generation);
		GvSV(gv) = subgen;
	    }
	}
	if (hv) {
	    SV** svp = AvARRAY(av);
	    /* NOTE: No support for tied ISA */
	    I32 items = AvFILLp(av) + 1;
	    while (items--) {
		SV* sv = *svp++;
		HV* basestash = gv_stashsv(sv, FALSE);
		if (!basestash) {
		    if (ckWARN(WARN_MISC))
			Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
		             "Can't locate package %s for @%s::ISA",
			    SvPVX(sv), HvNAME(stash));
		    continue;
		}
		if (&PL_sv_yes == isa_lookup(basestash, name, name_stash, 
                                             len, level + 1)) {
		    (void)hv_store(hv,name,len,&PL_sv_yes,0);
		    return &PL_sv_yes;
		}
	    }
	    (void)hv_store(hv,name,len,&PL_sv_no,0);
	}
    }

    return boolSV(strEQ(name, "UNIVERSAL"));
}

/*
=head1 SV Manipulation Functions

=for apidoc sv_derived_from

Returns a boolean indicating whether the SV is derived from the specified
class.  This is the function that implements C<UNIVERSAL::isa>.  It works
for class names as well as for objects.

=cut
*/

bool
Perl_sv_derived_from(pTHX_ SV *sv, const char *name)
{
    char *type;
    HV *stash;
    HV *name_stash;

    stash = Nullhv;
    type = Nullch;

    if (SvGMAGICAL(sv))
        mg_get(sv) ;

    if (SvROK(sv)) {
        sv = SvRV(sv);
        type = sv_reftype(sv,0);
        if (SvOBJECT(sv))
            stash = SvSTASH(sv);
    }
    else {
        stash = gv_stashsv(sv, FALSE);
    }

    name_stash = gv_stashpv(name, FALSE);

    return (type && strEQ(type,name)) ||
            (stash && isa_lookup(stash, name, name_stash, strlen(name), 0) 
             == &PL_sv_yes)
        ? TRUE
        : FALSE ;
}

#include "XSUB.h"

void XS_UNIVERSAL_isa(pTHX_ CV *cv);
void XS_UNIVERSAL_can(pTHX_ CV *cv);
void XS_UNIVERSAL_VERSION(pTHX_ CV *cv);
XS(XS_utf8_valid);
XS(XS_utf8_encode);
XS(XS_utf8_decode);
XS(XS_utf8_upgrade);
XS(XS_utf8_downgrade);
XS(XS_utf8_unicode_to_native);
XS(XS_utf8_native_to_unicode);

void
Perl_boot_core_UNIVERSAL(pTHX)
{
    char *file = __FILE__;

    newXS("UNIVERSAL::isa",             XS_UNIVERSAL_isa,         file);
    newXS("UNIVERSAL::can",             XS_UNIVERSAL_can,         file);
    newXS("UNIVERSAL::VERSION", 	XS_UNIVERSAL_VERSION, 	  file);
    newXS("utf8::valid", XS_utf8_valid, file);
    newXS("utf8::encode", XS_utf8_encode, file);
    newXS("utf8::decode", XS_utf8_decode, file);
    newXS("utf8::upgrade", XS_utf8_upgrade, file);
    newXS("utf8::downgrade", XS_utf8_downgrade, file);
    newXS("utf8::native_to_unicode", XS_utf8_native_to_unicode, file);
    newXS("utf8::unicode_to_native", XS_utf8_unicode_to_native, file);
}


XS(XS_UNIVERSAL_isa)
{
    dXSARGS;
    SV *sv;
    char *name;
    STRLEN n_a;

    if (items != 2)
	Perl_croak(aTHX_ "Usage: UNIVERSAL::isa(reference, kind)");

    sv = ST(0);

    if (SvGMAGICAL(sv))
	mg_get(sv);

    if (!SvOK(sv) || !(SvROK(sv) || (SvPOK(sv) && SvCUR(sv))))
	XSRETURN_UNDEF;

    name = (char *)SvPV(ST(1),n_a);

    ST(0) = boolSV(sv_derived_from(sv, name));
    XSRETURN(1);
}

XS(XS_UNIVERSAL_can)
{
    dXSARGS;
    SV   *sv;
    char *name;
    SV   *rv;
    HV   *pkg = NULL;
    STRLEN n_a;

    if (items != 2)
	Perl_croak(aTHX_ "Usage: UNIVERSAL::can(object-ref, method)");

    sv = ST(0);

    if (SvGMAGICAL(sv))
	mg_get(sv);

    if (!SvOK(sv) || !(SvROK(sv) || (SvPOK(sv) && SvCUR(sv))))
	XSRETURN_UNDEF;

    name = (char *)SvPV(ST(1),n_a);
    rv = &PL_sv_undef;

    if (SvROK(sv)) {
        sv = (SV*)SvRV(sv);
        if (SvOBJECT(sv))
            pkg = SvSTASH(sv);
    }
    else {
        pkg = gv_stashsv(sv, FALSE);
    }

    if (pkg) {
        GV *gv = gv_fetchmethod_autoload(pkg, name, FALSE);
        if (gv && isGV(gv))
	    rv = sv_2mortal(newRV((SV*)GvCV(gv)));
    }

    ST(0) = rv;
    XSRETURN(1);
}

XS(XS_UNIVERSAL_VERSION)
{
    dXSARGS;
    HV *pkg;
    GV **gvp;
    GV *gv;
    SV *sv;
    char *undef;

    if (SvROK(ST(0))) {
        sv = (SV*)SvRV(ST(0));
        if (!SvOBJECT(sv))
            Perl_croak(aTHX_ "Cannot find version of an unblessed reference");
        pkg = SvSTASH(sv);
    }
    else {
        pkg = gv_stashsv(ST(0), FALSE);
    }

    gvp = pkg ? (GV**)hv_fetch(pkg,"VERSION",7,FALSE) : Null(GV**);

    if (gvp && isGV(gv = *gvp) && SvOK(sv = GvSV(gv))) {
        SV *nsv = sv_newmortal();
        sv_setsv(nsv, sv);
        sv = nsv;
        undef = Nullch;
    }
    else {
        sv = (SV*)&PL_sv_undef;
        undef = "(undef)";
    }

    if (items > 1) {
	STRLEN len;
	SV *req = ST(1);

	if (undef) {
	     if (pkg)
		  Perl_croak(aTHX_
			     "%s does not define $%s::VERSION--version check failed",
			     HvNAME(pkg), HvNAME(pkg));
	     else {
		  char *str = SvPVx(ST(0), len);

		  Perl_croak(aTHX_
			     "%s defines neither package nor VERSION--version check failed", str);
	     }
	}
	if (!SvNIOK(sv) && SvPOK(sv)) {
	    char *str = SvPVx(sv,len);
	    while (len) {
		--len;
		/* XXX could DWIM "1.2.3" here */
		if (!isDIGIT(str[len]) && str[len] != '.' && str[len] != '_')
		    break;
	    }
	    if (len) {
		if (SvNOK(req) && SvPOK(req)) {
		    /* they said C<use Foo v1.2.3> and $Foo::VERSION
		     * doesn't look like a float: do string compare */
		    if (sv_cmp(req,sv) == 1) {
			Perl_croak(aTHX_ "%s v%"VDf" required--"
				   "this is only v%"VDf,
				   HvNAME(pkg), req, sv);
		    }
		    goto finish;
		}
		/* they said C<use Foo 1.002_003> and $Foo::VERSION
		 * doesn't look like a float: force numeric compare */
		(void)SvUPGRADE(sv, SVt_PVNV);
		SvNVX(sv) = str_to_version(sv);
		SvPOK_off(sv);
		SvNOK_on(sv);
	    }
	}
	/* if we get here, we're looking for a numeric comparison,
	 * so force the required version into a float, even if they
	 * said C<use Foo v1.2.3> */
	if (SvNOK(req) && SvPOK(req)) {
	    NV n = SvNV(req);
	    req = sv_newmortal();
	    sv_setnv(req, n);
	}

	if (SvNV(req) > SvNV(sv))
	    Perl_croak(aTHX_ "%s version %s required--this is only version %s",
		       HvNAME(pkg), SvPV_nolen(req), SvPV_nolen(sv));
    }

finish:
    ST(0) = sv;

    XSRETURN(1);
}

XS(XS_utf8_valid)
{
    dXSARGS;
    if (items != 1)
	Perl_croak(aTHX_ "Usage: utf8::valid(sv)");
    {
	SV *	sv = ST(0);
 {
  STRLEN len;
  char *s = SvPV(sv,len);
  if (!SvUTF8(sv) || is_utf8_string((U8*)s,len))
   XSRETURN_YES;
  else
   XSRETURN_NO;
 }
    }
    XSRETURN_EMPTY;
}

XS(XS_utf8_encode)
{
    dXSARGS;
    if (items != 1)
	Perl_croak(aTHX_ "Usage: utf8::encode(sv)");
    {
	SV *	sv = ST(0);

	sv_utf8_encode(sv);
    }
    XSRETURN_EMPTY;
}

XS(XS_utf8_decode)
{
    dXSARGS;
    if (items != 1)
	Perl_croak(aTHX_ "Usage: utf8::decode(sv)");
    {
	SV *	sv = ST(0);
	bool	RETVAL;

	RETVAL = sv_utf8_decode(sv);
	ST(0) = boolSV(RETVAL);
	sv_2mortal(ST(0));
    }
    XSRETURN(1);
}

XS(XS_utf8_upgrade)
{
    dXSARGS;
    if (items != 1)
	Perl_croak(aTHX_ "Usage: utf8::upgrade(sv)");
    {
	SV *	sv = ST(0);
	STRLEN	RETVAL;
	dXSTARG;

	RETVAL = sv_utf8_upgrade(sv);
	XSprePUSH; PUSHi((IV)RETVAL);
    }
    XSRETURN(1);
}

XS(XS_utf8_downgrade)
{
    dXSARGS;
    if (items < 1 || items > 2)
	Perl_croak(aTHX_ "Usage: utf8::downgrade(sv, failok=0)");
    {
	SV *	sv = ST(0);
	bool	failok;
	bool	RETVAL;

	if (items < 2)
	    failok = 0;
	else {
	    failok = (int)SvIV(ST(1));
	}

	RETVAL = sv_utf8_downgrade(sv, failok);
	ST(0) = boolSV(RETVAL);
	sv_2mortal(ST(0));
    }
    XSRETURN(1);
}

XS(XS_utf8_native_to_unicode)
{
 dXSARGS;
 UV uv = SvUV(ST(0));

 if (items > 1)
     Perl_croak(aTHX_ "Usage: utf8::native_to_unicode(sv)");

 ST(0) = sv_2mortal(newSViv(NATIVE_TO_UNI(uv)));
 XSRETURN(1);
}

XS(XS_utf8_unicode_to_native)
{
 dXSARGS;
 UV uv = SvUV(ST(0));

 if (items > 1)
     Perl_croak(aTHX_ "Usage: utf8::unicode_to_native(sv)");

 ST(0) = sv_2mortal(newSViv(UNI_TO_NATIVE(uv)));
 XSRETURN(1);
}
Commit	Line	Data
d6376244	1	/* universal.c
	2	*
	3	* Copyright (c) 1997-2002, Larry Wall
	4	*
	5	* You may distribute under the terms of either the GNU General Public
	6	* License or the Artistic License, as specified in the README file.
	7	*
	8	*/
	9
d31a8517	10	/*
	11	* "The roots of those mountains must be roots indeed; there must be
	12	* great secrets buried there which have not been discovered since the
	13	* beginning." --Gandalf, relating Gollum's story
	14	*/
	15
6d4a7be2	16	#include "EXTERN.h"
864dbfa3	17	#define PERL_IN_UNIVERSAL_C
6d4a7be2	18	#include "perl.h"
6d4a7be2	19
	20	/*
	21	* Contributed by Graham Barr <Graham.Barr@tiuk.ti.com>
	22	* The main guts of traverse_isa was actually copied from gv_fetchmeth
	23	*/
	24
76e3520e	25	STATIC SV *
301daebc	26	S_isa_lookup(pTHX_ HV stash, const char name, HV* name_stash,
301daebc	27	int len, int level)
6d4a7be2	28	{
	29	AV* av;
	30	GV* gv;
	31	GV** gvp;
	32	HV* hv = Nullhv;
46e4b22b	33	SV* subgen = Nullsv;
6d4a7be2	34
301daebc	35	/* A stash/class can go by many names (ie. User == main::User), so
	36	we compare the stash itself just in case */
	37	if (name_stash && (stash == name_stash))
	38	return &PL_sv_yes;
6d4a7be2	39
46e4b22b	40	if (strEQ(HvNAME(stash), name))
3280af22	41	return &PL_sv_yes;
6d4a7be2	42
6d4a7be2	43	if (level > 100)
46e4b22b	44	Perl_croak(aTHX_ "Recursive inheritance detected in package '%s'",
46e4b22b	45	HvNAME(stash));
6d4a7be2	46
	47	gvp = (GV**)hv_fetch(stash, "::ISA::CACHE::", 14, FALSE);
	48
46e4b22b	49	if (gvp && (gv = gvp) != (GV)&PL_sv_undef && (subgen = GvSV(gv))
	50	&& (hv = GvHV(gv)))
	51	{
	52	if (SvIV(subgen) == PL_sub_generation) {
	53	SV* sv;
	54	SV svp = (SV)hv_fetch(hv, name, len, FALSE);
	55	if (svp && (sv = svp) != (SV)&PL_sv_undef) {
	56	DEBUG_o( Perl_deb(aTHX_ "Using cached ISA %s for package %s\n",
	57	name, HvNAME(stash)) );
	58	return sv;
	59	}
	60	}
	61	else {
	62	DEBUG_o( Perl_deb(aTHX_ "ISA Cache in package %s is stale\n",
	63	HvNAME(stash)) );
	64	hv_clear(hv);
	65	sv_setiv(subgen, PL_sub_generation);
	66	}
6d4a7be2	67	}
	68
	69	gvp = (GV**)hv_fetch(stash,"ISA",3,FALSE);
46e4b22b	70
3280af22	71	if (gvp && (gv = gvp) != (GV)&PL_sv_undef && (av = GvAV(gv))) {
46e4b22b	72	if (!hv \|\| !subgen) {
6d4a7be2	73	gvp = (GV**)hv_fetch(stash, "::ISA::CACHE::", 14, TRUE);
	74
	75	gv = *gvp;
	76
	77	if (SvTYPE(gv) != SVt_PVGV)
	78	gv_init(gv, stash, "::ISA::CACHE::", 14, TRUE);
	79
46e4b22b	80	if (!hv)
	81	hv = GvHVn(gv);
	82	if (!subgen) {
	83	subgen = newSViv(PL_sub_generation);
	84	GvSV(gv) = subgen;
	85	}
6d4a7be2	86	}
46e4b22b	87	if (hv) {
6d4a7be2	88	SV** svp = AvARRAY(av);
93965878	89	/* NOTE: No support for tied ISA */
93965878	90	I32 items = AvFILLp(av) + 1;
6d4a7be2	91	while (items--) {
	92	SV* sv = *svp++;
	93	HV* basestash = gv_stashsv(sv, FALSE);
	94	if (!basestash) {
599cee73	95	if (ckWARN(WARN_MISC))
9014280d	96	Perl_warner(aTHX_ packWARN(WARN_SYNTAX),
599cee73	97	"Can't locate package %s for @%s::ISA",
6d4a7be2	98	SvPVX(sv), HvNAME(stash));
	99	continue;
	100	}
301daebc	101	if (&PL_sv_yes == isa_lookup(basestash, name, name_stash,
301daebc	102	len, level + 1)) {
3280af22	103	(void)hv_store(hv,name,len,&PL_sv_yes,0);
3280af22	104	return &PL_sv_yes;
6d4a7be2	105	}
6d4a7be2	106	}
3280af22	107	(void)hv_store(hv,name,len,&PL_sv_no,0);
6d4a7be2	108	}
	109	}
	110
e09f3e01	111	return boolSV(strEQ(name, "UNIVERSAL"));
6d4a7be2	112	}
6d4a7be2	113
954c1994	114	/*
ccfc67b7	115	=head1 SV Manipulation Functions
ccfc67b7	116
954c1994	117	=for apidoc sv_derived_from
	118
	119	Returns a boolean indicating whether the SV is derived from the specified
	120	class. This is the function that implements C<UNIVERSAL::isa>. It works
	121	for class names as well as for objects.
	122
	123	=cut
	124	*/
	125
55497cff	126	bool
864dbfa3	127	Perl_sv_derived_from(pTHX_ SV sv, const char name)
55497cff	128	{
55497cff	129	char *type;
55497cff	130	HV *stash;
301daebc	131	HV *name_stash;
46e4b22b	132
55497cff	133	stash = Nullhv;
55497cff	134	type = Nullch;
46e4b22b	135
55497cff	136	if (SvGMAGICAL(sv))
	137	mg_get(sv) ;
	138
	139	if (SvROK(sv)) {
	140	sv = SvRV(sv);
	141	type = sv_reftype(sv,0);
46e4b22b	142	if (SvOBJECT(sv))
55497cff	143	stash = SvSTASH(sv);
	144	}
	145	else {
	146	stash = gv_stashsv(sv, FALSE);
	147	}
46e4b22b	148
301daebc	149	name_stash = gv_stashpv(name, FALSE);
301daebc	150
55497cff	151	return (type && strEQ(type,name)) \|\|
301daebc	152	(stash && isa_lookup(stash, name, name_stash, strlen(name), 0)
301daebc	153	== &PL_sv_yes)
55497cff	154	? TRUE
55497cff	155	: FALSE ;
55497cff	156	}
55497cff	157
1b026014	158	#include "XSUB.h"
1b026014	159
acfe0abc	160	void XS_UNIVERSAL_isa(pTHX_ CV *cv);
	161	void XS_UNIVERSAL_can(pTHX_ CV *cv);
	162	void XS_UNIVERSAL_VERSION(pTHX_ CV *cv);
1b026014	163	XS(XS_utf8_valid);
	164	XS(XS_utf8_encode);
	165	XS(XS_utf8_decode);
	166	XS(XS_utf8_upgrade);
	167	XS(XS_utf8_downgrade);
	168	XS(XS_utf8_unicode_to_native);
	169	XS(XS_utf8_native_to_unicode);
0cb96387	170
	171	void
	172	Perl_boot_core_UNIVERSAL(pTHX)
	173	{
	174	char *file = __FILE__;
	175
	176	newXS("UNIVERSAL::isa", XS_UNIVERSAL_isa, file);
	177	newXS("UNIVERSAL::can", XS_UNIVERSAL_can, file);
	178	newXS("UNIVERSAL::VERSION", XS_UNIVERSAL_VERSION, file);
1b026014	179	newXS("utf8::valid", XS_utf8_valid, file);
	180	newXS("utf8::encode", XS_utf8_encode, file);
	181	newXS("utf8::decode", XS_utf8_decode, file);
	182	newXS("utf8::upgrade", XS_utf8_upgrade, file);
	183	newXS("utf8::downgrade", XS_utf8_downgrade, file);
	184	newXS("utf8::native_to_unicode", XS_utf8_native_to_unicode, file);
	185	newXS("utf8::unicode_to_native", XS_utf8_unicode_to_native, file);
0cb96387	186	}
0cb96387	187
55497cff	188
6d4a7be2	189	XS(XS_UNIVERSAL_isa)
	190	{
	191	dXSARGS;
55497cff	192	SV *sv;
55497cff	193	char *name;
2d8e6c8d	194	STRLEN n_a;
6d4a7be2	195
6d4a7be2	196	if (items != 2)
cea2e8a9	197	Perl_croak(aTHX_ "Usage: UNIVERSAL::isa(reference, kind)");
6d4a7be2	198
6d4a7be2	199	sv = ST(0);
f8f70380	200
d3f7f2b2	201	if (SvGMAGICAL(sv))
	202	mg_get(sv);
	203
aca069ec	204	if (!SvOK(sv) \|\| !(SvROK(sv) \|\| (SvPOK(sv) && SvCUR(sv))))
f8f70380	205	XSRETURN_UNDEF;
f8f70380	206
2d8e6c8d	207	name = (char *)SvPV(ST(1),n_a);
6d4a7be2	208
54310121	209	ST(0) = boolSV(sv_derived_from(sv, name));
6d4a7be2	210	XSRETURN(1);
	211	}
	212
6d4a7be2	213	XS(XS_UNIVERSAL_can)
	214	{
	215	dXSARGS;
	216	SV *sv;
	217	char *name;
	218	SV *rv;
6f08146e	219	HV *pkg = NULL;
2d8e6c8d	220	STRLEN n_a;
6d4a7be2	221
6d4a7be2	222	if (items != 2)
cea2e8a9	223	Perl_croak(aTHX_ "Usage: UNIVERSAL::can(object-ref, method)");
6d4a7be2	224
6d4a7be2	225	sv = ST(0);
f8f70380	226
d3f7f2b2	227	if (SvGMAGICAL(sv))
	228	mg_get(sv);
	229
aca069ec	230	if (!SvOK(sv) \|\| !(SvROK(sv) \|\| (SvPOK(sv) && SvCUR(sv))))
f8f70380	231	XSRETURN_UNDEF;
f8f70380	232
2d8e6c8d	233	name = (char *)SvPV(ST(1),n_a);
3280af22	234	rv = &PL_sv_undef;
6d4a7be2	235
46e4b22b	236	if (SvROK(sv)) {
6f08146e	237	sv = (SV*)SvRV(sv);
46e4b22b	238	if (SvOBJECT(sv))
6f08146e	239	pkg = SvSTASH(sv);
	240	}
	241	else {
	242	pkg = gv_stashsv(sv, FALSE);
	243	}
	244
	245	if (pkg) {
dc848c6f	246	GV *gv = gv_fetchmethod_autoload(pkg, name, FALSE);
	247	if (gv && isGV(gv))
	248	rv = sv_2mortal(newRV((SV*)GvCV(gv)));
6d4a7be2	249	}
	250
	251	ST(0) = rv;
	252	XSRETURN(1);
	253	}
	254
6d4a7be2	255	XS(XS_UNIVERSAL_VERSION)
	256	{
	257	dXSARGS;
	258	HV *pkg;
	259	GV **gvp;
	260	GV *gv;
	261	SV *sv;
	262	char *undef;
	263
1571675a	264	if (SvROK(ST(0))) {
6d4a7be2	265	sv = (SV*)SvRV(ST(0));
1571675a	266	if (!SvOBJECT(sv))
cea2e8a9	267	Perl_croak(aTHX_ "Cannot find version of an unblessed reference");
6d4a7be2	268	pkg = SvSTASH(sv);
	269	}
	270	else {
	271	pkg = gv_stashsv(ST(0), FALSE);
	272	}
	273
	274	gvp = pkg ? (GV)hv_fetch(pkg,"VERSION",7,FALSE) : Null(GV);
	275
d4bea2fb	276	if (gvp && isGV(gv = *gvp) && SvOK(sv = GvSV(gv))) {
6d4a7be2	277	SV *nsv = sv_newmortal();
	278	sv_setsv(nsv, sv);
	279	sv = nsv;
	280	undef = Nullch;
	281	}
	282	else {
3280af22	283	sv = (SV*)&PL_sv_undef;
6d4a7be2	284	undef = "(undef)";
	285	}
	286
1571675a	287	if (items > 1) {
	288	STRLEN len;
	289	SV *req = ST(1);
	290
62658f4d	291	if (undef) {
	292	if (pkg)
	293	Perl_croak(aTHX_
	294	"%s does not define $%s::VERSION--version check failed",
	295	HvNAME(pkg), HvNAME(pkg));
	296	else {
	297	char *str = SvPVx(ST(0), len);
	298
	299	Perl_croak(aTHX_
	300	"%s defines neither package nor VERSION--version check failed", str);
	301	}
	302	}
1571675a	303	if (!SvNIOK(sv) && SvPOK(sv)) {
	304	char *str = SvPVx(sv,len);
	305	while (len) {
	306	--len;
	307	/* XXX could DWIM "1.2.3" here */
	308	if (!isDIGIT(str[len]) && str[len] != '.' && str[len] != '_')
	309	break;
	310	}
	311	if (len) {
4305d8ab	312	if (SvNOK(req) && SvPOK(req)) {
1571675a	313	/* they said C<use Foo v1.2.3> and $Foo::VERSION
	314	* doesn't look like a float: do string compare */
	315	if (sv_cmp(req,sv) == 1) {
d2560b70	316	Perl_croak(aTHX_ "%s v%"VDf" required--"
d2560b70	317	"this is only v%"VDf,
1571675a	318	HvNAME(pkg), req, sv);
	319	}
	320	goto finish;
	321	}
	322	/* they said C<use Foo 1.002_003> and $Foo::VERSION
	323	* doesn't look like a float: force numeric compare */
155aba94	324	(void)SvUPGRADE(sv, SVt_PVNV);
1571675a	325	SvNVX(sv) = str_to_version(sv);
	326	SvPOK_off(sv);
	327	SvNOK_on(sv);
	328	}
	329	}
	330	/* if we get here, we're looking for a numeric comparison,
	331	* so force the required version into a float, even if they
	332	* said C<use Foo v1.2.3> */
4305d8ab	333	if (SvNOK(req) && SvPOK(req)) {
1571675a	334	NV n = SvNV(req);
	335	req = sv_newmortal();
	336	sv_setnv(req, n);
	337	}
	338
f6eb1a96	339	if (SvNV(req) > SvNV(sv))
1571675a	340	Perl_croak(aTHX_ "%s version %s required--this is only version %s",
f6eb1a96	341	HvNAME(pkg), SvPV_nolen(req), SvPV_nolen(sv));
2d8e6c8d	342	}
6d4a7be2	343
1571675a	344	finish:
6d4a7be2	345	ST(0) = sv;
	346
	347	XSRETURN(1);
	348	}
	349
1b026014	350	XS(XS_utf8_valid)
	351	{
	352	dXSARGS;
	353	if (items != 1)
	354	Perl_croak(aTHX_ "Usage: utf8::valid(sv)");
	355	{
	356	SV * sv = ST(0);
	357	{
	358	STRLEN len;
	359	char *s = SvPV(sv,len);
	360	if (!SvUTF8(sv) \|\| is_utf8_string((U8*)s,len))
	361	XSRETURN_YES;
	362	else
	363	XSRETURN_NO;
	364	}
	365	}
	366	XSRETURN_EMPTY;
	367	}
	368
	369	XS(XS_utf8_encode)
	370	{
	371	dXSARGS;
	372	if (items != 1)
	373	Perl_croak(aTHX_ "Usage: utf8::encode(sv)");
	374	{
	375	SV * sv = ST(0);
	376
	377	sv_utf8_encode(sv);
	378	}
	379	XSRETURN_EMPTY;
	380	}
	381
	382	XS(XS_utf8_decode)
	383	{
	384	dXSARGS;
	385	if (items != 1)
	386	Perl_croak(aTHX_ "Usage: utf8::decode(sv)");
	387	{
	388	SV * sv = ST(0);
	389	bool RETVAL;
	390
	391	RETVAL = sv_utf8_decode(sv);
	392	ST(0) = boolSV(RETVAL);
	393	sv_2mortal(ST(0));
	394	}
	395	XSRETURN(1);
	396	}
	397
	398	XS(XS_utf8_upgrade)
	399	{
	400	dXSARGS;
	401	if (items != 1)
	402	Perl_croak(aTHX_ "Usage: utf8::upgrade(sv)");
	403	{
	404	SV * sv = ST(0);
	405	STRLEN RETVAL;
	406	dXSTARG;
	407
	408	RETVAL = sv_utf8_upgrade(sv);
	409	XSprePUSH; PUSHi((IV)RETVAL);
	410	}
	411	XSRETURN(1);
	412	}
	413
414	XS(XS_utf8_downgrade)
415	{
416	dXSARGS;
417	if (items < 1 \|\| items > 2)
418	Perl_croak(aTHX_ "Usage: utf8::downgrade(sv, failok=0)");
419	{
420	SV * sv = ST(0);
421	bool failok;
422	bool RETVAL;
423
424	if (items < 2)
425	failok = 0;
426	else {
427	failok = (int)SvIV(ST(1));
428	}
429
430	RETVAL = sv_utf8_downgrade(sv, failok);
431	ST(0) = boolSV(RETVAL);
432	sv_2mortal(ST(0));
433	}
434	XSRETURN(1);
435	}
436
437	XS(XS_utf8_native_to_unicode)
438	{
439	dXSARGS;
440	UV uv = SvUV(ST(0));
b7953727	441
	442	if (items > 1)
	443	Perl_croak(aTHX_ "Usage: utf8::native_to_unicode(sv)");
	444
1b026014	445	ST(0) = sv_2mortal(newSViv(NATIVE_TO_UNI(uv)));
	446	XSRETURN(1);
	447	}
	448
	449	XS(XS_utf8_unicode_to_native)
	450	{
	451	dXSARGS;
	452	UV uv = SvUV(ST(0));
b7953727	453
	454	if (items > 1)
	455	Perl_croak(aTHX_ "Usage: utf8::unicode_to_native(sv)");
	456
1b026014	457	ST(0) = sv_2mortal(newSViv(UNI_TO_NATIVE(uv)));
	458	XSRETURN(1);
	459	}
	460