This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Latch LC_NUMERIC during critical sections
[perl5.git] / vutil.c
1 /* This file is part of the "version" CPAN distribution.  Please avoid
2    editing it in the perl core. */
3
4 #ifdef PERL_CORE
5 #  include "vutil.h"
6 #endif
7
8 #define VERSION_MAX 0x7FFFFFFF
9
10 /*
11 =for apidoc prescan_version
12
13 Validate that a given string can be parsed as a version object, but doesn't
14 actually perform the parsing.  Can use either strict or lax validation rules.
15 Can optionally set a number of hint variables to save the parsing code
16 some time when tokenizing.
17
18 =cut
19 */
20 const char *
21 #ifdef VUTIL_REPLACE_CORE
22 Perl_prescan_version2(pTHX_ const char *s, bool strict,
23 #else
24 Perl_prescan_version(pTHX_ const char *s, bool strict,
25 #endif
26                      const char **errstr,
27                      bool *sqv, int *ssaw_decimal, int *swidth, bool *salpha) {
28     bool qv = (sqv ? *sqv : FALSE);
29     int width = 3;
30     int saw_decimal = 0;
31     bool alpha = FALSE;
32     const char *d = s;
33
34     PERL_ARGS_ASSERT_PRESCAN_VERSION;
35     PERL_UNUSED_CONTEXT;
36
37     if (qv && isDIGIT(*d))
38         goto dotted_decimal_version;
39
40     if (*d == 'v') { /* explicit v-string */
41         d++;
42         if (isDIGIT(*d)) {
43             qv = TRUE;
44         }
45         else { /* degenerate v-string */
46             /* requires v1.2.3 */
47             BADVERSION(s,errstr,"Invalid version format (dotted-decimal versions require at least three parts)");
48         }
49
50 dotted_decimal_version:
51         if (strict && d[0] == '0' && isDIGIT(d[1])) {
52             /* no leading zeros allowed */
53             BADVERSION(s,errstr,"Invalid version format (no leading zeros)");
54         }
55
56         while (isDIGIT(*d))     /* integer part */
57             d++;
58
59         if (*d == '.')
60         {
61             saw_decimal++;
62             d++;                /* decimal point */
63         }
64         else
65         {
66             if (strict) {
67                 /* require v1.2.3 */
68                 BADVERSION(s,errstr,"Invalid version format (dotted-decimal versions require at least three parts)");
69             }
70             else {
71                 goto version_prescan_finish;
72             }
73         }
74
75         {
76             int i = 0;
77             int j = 0;
78             while (isDIGIT(*d)) {       /* just keep reading */
79                 i++;
80                 while (isDIGIT(*d)) {
81                     d++; j++;
82                     /* maximum 3 digits between decimal */
83                     if (strict && j > 3) {
84                         BADVERSION(s,errstr,"Invalid version format (maximum 3 digits between decimals)");
85                     }
86                 }
87                 if (*d == '_') {
88                     if (strict) {
89                         BADVERSION(s,errstr,"Invalid version format (no underscores)");
90                     }
91                     if ( alpha ) {
92                         BADVERSION(s,errstr,"Invalid version format (multiple underscores)");
93                     }
94                     d++;
95                     alpha = TRUE;
96                 }
97                 else if (*d == '.') {
98                     if (alpha) {
99                         BADVERSION(s,errstr,"Invalid version format (underscores before decimal)");
100                     }
101                     saw_decimal++;
102                     d++;
103                 }
104                 else if (!isDIGIT(*d)) {
105                     break;
106                 }
107                 j = 0;
108             }
109
110             if (strict && i < 2) {
111                 /* requires v1.2.3 */
112                 BADVERSION(s,errstr,"Invalid version format (dotted-decimal versions require at least three parts)");
113             }
114         }
115     }                                   /* end if dotted-decimal */
116     else
117     {                                   /* decimal versions */
118         int j = 0;                      /* may need this later */
119         /* special strict case for leading '.' or '0' */
120         if (strict) {
121             if (*d == '.') {
122                 BADVERSION(s,errstr,"Invalid version format (0 before decimal required)");
123             }
124             if (*d == '0' && isDIGIT(d[1])) {
125                 BADVERSION(s,errstr,"Invalid version format (no leading zeros)");
126             }
127         }
128
129         /* and we never support negative versions */
130         if ( *d == '-') {
131             BADVERSION(s,errstr,"Invalid version format (negative version number)");
132         }
133
134         /* consume all of the integer part */
135         while (isDIGIT(*d))
136             d++;
137
138         /* look for a fractional part */
139         if (*d == '.') {
140             /* we found it, so consume it */
141             saw_decimal++;
142             d++;
143         }
144         else if (!*d || *d == ';' || isSPACE(*d) || *d == '{' || *d == '}') {
145             if ( d == s ) {
146                 /* found nothing */
147                 BADVERSION(s,errstr,"Invalid version format (version required)");
148             }
149             /* found just an integer */
150             goto version_prescan_finish;
151         }
152         else if ( d == s ) {
153             /* didn't find either integer or period */
154             BADVERSION(s,errstr,"Invalid version format (non-numeric data)");
155         }
156         else if (*d == '_') {
157             /* underscore can't come after integer part */
158             if (strict) {
159                 BADVERSION(s,errstr,"Invalid version format (no underscores)");
160             }
161             else if (isDIGIT(d[1])) {
162                 BADVERSION(s,errstr,"Invalid version format (alpha without decimal)");
163             }
164             else {
165                 BADVERSION(s,errstr,"Invalid version format (misplaced underscore)");
166             }
167         }
168         else {
169             /* anything else after integer part is just invalid data */
170             BADVERSION(s,errstr,"Invalid version format (non-numeric data)");
171         }
172
173         /* scan the fractional part after the decimal point*/
174
175         if (!isDIGIT(*d) && (strict || ! (!*d || *d == ';' || isSPACE(*d) || *d == '{' || *d == '}') )) {
176                 /* strict or lax-but-not-the-end */
177                 BADVERSION(s,errstr,"Invalid version format (fractional part required)");
178         }
179
180         while (isDIGIT(*d)) {
181             d++; j++;
182             if (*d == '.' && isDIGIT(d[-1])) {
183                 if (alpha) {
184                     BADVERSION(s,errstr,"Invalid version format (underscores before decimal)");
185                 }
186                 if (strict) {
187                     BADVERSION(s,errstr,"Invalid version format (dotted-decimal versions must begin with 'v')");
188                 }
189                 d = (char *)s;          /* start all over again */
190                 qv = TRUE;
191                 goto dotted_decimal_version;
192             }
193             if (*d == '_') {
194                 if (strict) {
195                     BADVERSION(s,errstr,"Invalid version format (no underscores)");
196                 }
197                 if ( alpha ) {
198                     BADVERSION(s,errstr,"Invalid version format (multiple underscores)");
199                 }
200                 if ( ! isDIGIT(d[1]) ) {
201                     BADVERSION(s,errstr,"Invalid version format (misplaced underscore)");
202                 }
203                 width = j;
204                 d++;
205                 alpha = TRUE;
206             }
207         }
208     }
209
210 version_prescan_finish:
211     while (isSPACE(*d))
212         d++;
213
214     if (!isDIGIT(*d) && (! (!*d || *d == ';' || *d == '{' || *d == '}') )) {
215         /* trailing non-numeric data */
216         BADVERSION(s,errstr,"Invalid version format (non-numeric data)");
217     }
218     if (saw_decimal > 1 && d[-1] == '.') {
219         /* no trailing period allowed */
220         BADVERSION(s,errstr,"Invalid version format (trailing decimal)");
221     }
222
223
224     if (sqv)
225         *sqv = qv;
226     if (swidth)
227         *swidth = width;
228     if (ssaw_decimal)
229         *ssaw_decimal = saw_decimal;
230     if (salpha)
231         *salpha = alpha;
232     return d;
233 }
234
235 /*
236 =for apidoc scan_version
237
238 Returns a pointer to the next character after the parsed
239 version string, as well as upgrading the passed in SV to
240 an RV.
241
242 Function must be called with an already existing SV like
243
244     sv = newSV(0);
245     s = scan_version(s, SV *sv, bool qv);
246
247 Performs some preprocessing to the string to ensure that
248 it has the correct characteristics of a version.  Flags the
249 object if it contains an underscore (which denotes this
250 is an alpha version).  The boolean qv denotes that the version
251 should be interpreted as if it had multiple decimals, even if
252 it doesn't.
253
254 =cut
255 */
256
257 const char *
258 #ifdef VUTIL_REPLACE_CORE
259 Perl_scan_version2(pTHX_ const char *s, SV *rv, bool qv)
260 #else
261 Perl_scan_version(pTHX_ const char *s, SV *rv, bool qv)
262 #endif
263 {
264     const char *start = s;
265     const char *pos;
266     const char *last;
267     const char *errstr = NULL;
268     int saw_decimal = 0;
269     int width = 3;
270     bool alpha = FALSE;
271     bool vinf = FALSE;
272     AV * av;
273     SV * hv;
274
275     PERL_ARGS_ASSERT_SCAN_VERSION;
276
277     while (isSPACE(*s)) /* leading whitespace is OK */
278         s++;
279
280     last = PRESCAN_VERSION(s, FALSE, &errstr, &qv, &saw_decimal, &width, &alpha);
281     if (errstr) {
282         /* "undef" is a special case and not an error */
283         if ( ! ( *s == 'u' && strEQ(s+1,"ndef")) ) {
284             Perl_croak(aTHX_ "%s", errstr);
285         }
286     }
287
288     start = s;
289     if (*s == 'v')
290         s++;
291     pos = s;
292
293     /* Now that we are through the prescan, start creating the object */
294     av = newAV();
295     hv = newSVrv(rv, "version"); /* create an SV and upgrade the RV */
296     (void)sv_upgrade(hv, SVt_PVHV); /* needs to be an HV type */
297
298 #ifndef NODEFAULT_SHAREKEYS
299     HvSHAREKEYS_on(hv);         /* key-sharing on by default */
300 #endif
301
302     if ( qv )
303         (void)hv_stores(MUTABLE_HV(hv), "qv", newSViv(qv));
304     if ( alpha )
305         (void)hv_stores(MUTABLE_HV(hv), "alpha", newSViv(alpha));
306     if ( !qv && width < 3 )
307         (void)hv_stores(MUTABLE_HV(hv), "width", newSViv(width));
308
309     while (isDIGIT(*pos) || *pos == '_')
310         pos++;
311     if (!isALPHA(*pos)) {
312         I32 rev;
313
314         for (;;) {
315             rev = 0;
316             {
317                 /* this is atoi() that delimits on underscores */
318                 const char *end = pos;
319                 I32 mult = 1;
320                 I32 orev;
321
322                 /* the following if() will only be true after the decimal
323                  * point of a version originally created with a bare
324                  * floating point number, i.e. not quoted in any way
325                  */
326                 if ( !qv && s > start && saw_decimal == 1 ) {
327                     mult *= 100;
328                     while ( s < end ) {
329                         if (*s == '_')
330                             continue;
331                         orev = rev;
332                         rev += (*s - '0') * mult;
333                         mult /= 10;
334                         if (   (PERL_ABS(orev) > PERL_ABS(rev)) 
335                             || (PERL_ABS(rev) > VERSION_MAX )) {
336                             Perl_ck_warner(aTHX_ packWARN(WARN_OVERFLOW), 
337                                            "Integer overflow in version %d",VERSION_MAX);
338                             s = end - 1;
339                             rev = VERSION_MAX;
340                             vinf = 1;
341                         }
342                         s++;
343                         if ( *s == '_' )
344                             s++;
345                     }
346                 }
347                 else {
348                     while (--end >= s) {
349                         int i;
350                         if (*end == '_')
351                             continue;
352                         i = (*end - '0');
353                         if (   (mult == VERSION_MAX)
354                             || (i > VERSION_MAX / mult)
355                             || (i * mult > VERSION_MAX - rev))
356                         {
357                             Perl_ck_warner(aTHX_ packWARN(WARN_OVERFLOW), 
358                                            "Integer overflow in version");
359                             end = s - 1;
360                             rev = VERSION_MAX;
361                             vinf = 1;
362                         }
363                         else
364                             rev += i * mult;
365
366                         if (mult > VERSION_MAX / 10)
367                             mult = VERSION_MAX;
368                         else
369                             mult *= 10;
370                     }
371                 } 
372             }
373
374             /* Append revision */
375             av_push(av, newSViv(rev));
376             if ( vinf ) {
377                 s = last;
378                 break;
379             }
380             else if ( *pos == '.' ) {
381                 pos++;
382                 if (qv) {
383                     while (*pos == '0')
384                         ++pos;
385                 }
386                 s = pos;
387             }
388             else if ( *pos == '_' && isDIGIT(pos[1]) )
389                 s = ++pos;
390             else if ( *pos == ',' && isDIGIT(pos[1]) )
391                 s = ++pos;
392             else if ( isDIGIT(*pos) )
393                 s = pos;
394             else {
395                 s = pos;
396                 break;
397             }
398             if ( qv ) {
399                 while ( isDIGIT(*pos) || *pos == '_')
400                     pos++;
401             }
402             else {
403                 int digits = 0;
404                 while ( ( isDIGIT(*pos) || *pos == '_' ) && digits < 3 ) {
405                     if ( *pos != '_' )
406                         digits++;
407                     pos++;
408                 }
409             }
410         }
411     }
412     if ( qv ) { /* quoted versions always get at least three terms*/
413         SSize_t len = AvFILLp(av);
414         /* This for loop appears to trigger a compiler bug on OS X, as it
415            loops infinitely. Yes, len is negative. No, it makes no sense.
416            Compiler in question is:
417            gcc version 3.3 20030304 (Apple Computer, Inc. build 1640)
418            for ( len = 2 - len; len > 0; len-- )
419            av_push(MUTABLE_AV(sv), newSViv(0));
420         */
421         len = 2 - len;
422         while (len-- > 0)
423             av_push(av, newSViv(0));
424     }
425
426     /* need to save off the current version string for later */
427     if ( vinf ) {
428         SV * orig = newSVpvn("v.Inf", sizeof("v.Inf")-1);
429         (void)hv_stores(MUTABLE_HV(hv), "original", orig);
430         (void)hv_stores(MUTABLE_HV(hv), "vinf", newSViv(1));
431     }
432     else if ( s > start ) {
433         SV * orig = newSVpvn(start,s-start);
434         if ( qv && saw_decimal == 1 && *start != 'v' ) {
435             /* need to insert a v to be consistent */
436             sv_insert(orig, 0, 0, "v", 1);
437         }
438         (void)hv_stores(MUTABLE_HV(hv), "original", orig);
439     }
440     else {
441         (void)hv_stores(MUTABLE_HV(hv), "original", newSVpvs("0"));
442         av_push(av, newSViv(0));
443     }
444
445     /* And finally, store the AV in the hash */
446     (void)hv_stores(MUTABLE_HV(hv), "version", newRV_noinc(MUTABLE_SV(av)));
447
448     /* fix RT#19517 - special case 'undef' as string */
449     if ( *s == 'u' && strEQ(s+1,"ndef") ) {
450         s += 5;
451     }
452
453     return s;
454 }
455
456 /*
457 =for apidoc new_version
458
459 Returns a new version object based on the passed in SV:
460
461     SV *sv = new_version(SV *ver);
462
463 Does not alter the passed in ver SV.  See "upg_version" if you
464 want to upgrade the SV.
465
466 =cut
467 */
468
469 SV *
470 #ifdef VUTIL_REPLACE_CORE
471 Perl_new_version2(pTHX_ SV *ver)
472 #else
473 Perl_new_version(pTHX_ SV *ver)
474 #endif
475 {
476     SV * const rv = newSV(0);
477     PERL_ARGS_ASSERT_NEW_VERSION;
478     if ( ISA_VERSION_OBJ(ver) ) /* can just copy directly */
479     {
480         SSize_t key;
481         AV * const av = newAV();
482         AV *sav;
483         /* This will get reblessed later if a derived class*/
484         SV * const hv = newSVrv(rv, "version"); 
485         (void)sv_upgrade(hv, SVt_PVHV); /* needs to be an HV type */
486 #ifndef NODEFAULT_SHAREKEYS
487         HvSHAREKEYS_on(hv);         /* key-sharing on by default */
488 #endif
489
490         if ( SvROK(ver) )
491             ver = SvRV(ver);
492
493         /* Begin copying all of the elements */
494         if ( hv_exists(MUTABLE_HV(ver), "qv", 2) )
495             (void)hv_stores(MUTABLE_HV(hv), "qv", newSViv(1));
496
497         if ( hv_exists(MUTABLE_HV(ver), "alpha", 5) )
498             (void)hv_stores(MUTABLE_HV(hv), "alpha", newSViv(1));
499         {
500             SV ** svp = hv_fetchs(MUTABLE_HV(ver), "width", FALSE);
501             if(svp) {
502                 const I32 width = SvIV(*svp);
503                 (void)hv_stores(MUTABLE_HV(hv), "width", newSViv(width));
504             }
505         }
506         {
507             SV ** svp = hv_fetchs(MUTABLE_HV(ver), "original", FALSE);
508             if(svp)
509                 (void)hv_stores(MUTABLE_HV(hv), "original", newSVsv(*svp));
510         }
511         sav = MUTABLE_AV(SvRV(*hv_fetchs(MUTABLE_HV(ver), "version", FALSE)));
512         /* This will get reblessed later if a derived class*/
513         for ( key = 0; key <= av_len(sav); key++ )
514         {
515             SV * const sv = *av_fetch(sav, key, FALSE);
516             const I32 rev = SvIV(sv);
517             av_push(av, newSViv(rev));
518         }
519
520         (void)hv_stores(MUTABLE_HV(hv), "version", newRV_noinc(MUTABLE_SV(av)));
521         return rv;
522     }
523 #ifdef SvVOK
524     {
525         const MAGIC* const mg = SvVSTRING_mg(ver);
526         if ( mg ) { /* already a v-string */
527             const STRLEN len = mg->mg_len;
528             const char * const version = (const char*)mg->mg_ptr;
529             char *raw, *under;
530             static const char underscore[] = "_";
531             sv_setpvn(rv,version,len);
532             raw = SvPV_nolen(rv);
533             under = ninstr(raw, raw+len, underscore, underscore + 1);
534             if (under) {
535                 Move(under + 1, under, raw + len - under - 1, char);
536                 SvCUR(rv)--;
537                 *SvEND(rv) = '\0';
538             }
539             /* this is for consistency with the pure Perl class */
540             if ( isDIGIT(*version) )
541                 sv_insert(rv, 0, 0, "v", 1);
542         }
543         else {
544 #endif
545         SvSetSV_nosteal(rv, ver); /* make a duplicate */
546 #ifdef SvVOK
547         }
548     }
549 #endif
550     sv_2mortal(rv); /* in case upg_version croaks before it returns */
551     return SvREFCNT_inc_NN(UPG_VERSION(rv, FALSE));
552 }
553
554 /*
555 =for apidoc upg_version
556
557 In-place upgrade of the supplied SV to a version object.
558
559     SV *sv = upg_version(SV *sv, bool qv);
560
561 Returns a pointer to the upgraded SV.  Set the boolean qv if you want
562 to force this SV to be interpreted as an "extended" version.
563
564 =cut
565 */
566
567 SV *
568 #ifdef VUTIL_REPLACE_CORE
569 Perl_upg_version2(pTHX_ SV *ver, bool qv)
570 #else
571 Perl_upg_version(pTHX_ SV *ver, bool qv)
572 #endif
573 {
574     const char *version, *s;
575 #ifdef SvVOK
576     const MAGIC *mg;
577 #endif
578
579 #if PERL_VERSION_LT(5,19,8) && defined(USE_ITHREADS)
580     ENTER;
581 #endif
582     PERL_ARGS_ASSERT_UPG_VERSION;
583
584     if ( (SvUOK(ver) && SvUVX(ver) > VERSION_MAX)
585            || (SvIOK(ver) && SvIVX(ver) > VERSION_MAX) ) {
586         /* out of bounds [unsigned] integer */
587         STRLEN len;
588         char tbuf[64];
589         len = my_snprintf(tbuf, sizeof(tbuf), "%d", VERSION_MAX);
590         version = savepvn(tbuf, len);
591         SAVEFREEPV(version);
592         Perl_ck_warner(aTHX_ packWARN(WARN_OVERFLOW),
593                        "Integer overflow in version %d",VERSION_MAX);
594     }
595     else if ( SvUOK(ver) || SvIOK(ver))
596 #if PERL_VERSION_LT(5,17,2)
597 VER_IV:
598 #endif
599     {
600         version = savesvpv(ver);
601         SAVEFREEPV(version);
602     }
603     else if (SvNOK(ver) && !( SvPOK(ver) && SvCUR(ver) == 3 ) )
604 #if PERL_VERSION_LT(5,17,2)
605 VER_NV:
606 #endif
607     {
608         STRLEN len;
609
610         /* may get too much accuracy */ 
611         char tbuf[64];
612         SV *sv = SvNVX(ver) > 10e50 ? newSV(64) : 0;
613         char *buf;
614
615 #if PERL_VERSION_GE(5,19,0)
616         if (SvPOK(ver)) {
617             /* dualvar? */
618             goto VER_PV;
619         }
620 #endif
621 #ifdef USE_LOCALE_NUMERIC
622
623         {
624             /* This may or may not be called from code that has switched
625              * locales without letting perl know, therefore we have to find it
626              * from first principals.  See [perl #121930]. */
627
628             /* if it isn't C, set it to C. */
629             const char * locale_name_on_entry;
630
631             LC_NUMERIC_LOCK(0);    /* Start critical section */
632
633             locale_name_on_entry = setlocale(LC_NUMERIC, NULL);
634             if (   strNE(locale_name_on_entry, "C")
635                 && strNE(locale_name_on_entry, "POSIX"))
636             {
637                 setlocale(LC_NUMERIC, "C");
638             }
639             else {  /* This value indicates to the restore code that we didn't
640                        change the locale */
641                 locale_name_on_entry = NULL;
642             }
643
644             /* Prevent recursed calls from trying to change back */
645             LOCK_LC_NUMERIC_STANDARD();
646
647 #endif
648
649             if (sv) {
650                 Perl_sv_catpvf(aTHX_ sv, "%.9" NVff, SvNVX(ver));
651                 len = SvCUR(sv);
652                 buf = SvPVX(sv);
653             }
654             else {
655                 len = my_snprintf(tbuf, sizeof(tbuf), "%.9" NVff, SvNVX(ver));
656                 buf = tbuf;
657             }
658
659 #ifdef USE_LOCALE_NUMERIC
660
661             UNLOCK_LC_NUMERIC_STANDARD();
662
663             if (locale_name_on_entry) {
664                 setlocale(LC_NUMERIC, locale_name_on_entry);
665             }
666
667             LC_NUMERIC_UNLOCK;  /* End critical section */
668
669         }
670
671 #endif  /* USE_LOCALE_NUMERIC */
672
673         while (buf[len-1] == '0' && len > 0) len--;
674         if ( buf[len-1] == '.' ) len--; /* eat the trailing decimal */
675         version = savepvn(buf, len);
676         SAVEFREEPV(version);
677         SvREFCNT_dec(sv);
678     }
679 #ifdef SvVOK
680     else if ( (mg = SvVSTRING_mg(ver)) ) { /* already a v-string */
681         version = savepvn( (const char*)mg->mg_ptr,mg->mg_len );
682         SAVEFREEPV(version);
683         qv = TRUE;
684     }
685 #endif
686     else if ( SvPOK(ver))/* must be a string or something like a string */
687 VER_PV:
688     {
689         STRLEN len;
690         version = savepvn(SvPV(ver,len), SvCUR(ver));
691         SAVEFREEPV(version);
692 #ifndef SvVOK
693 #  if PERL_VERSION > 5
694         /* This will only be executed for 5.6.0 - 5.8.0 inclusive */
695         if ( len >= 3 && !instr(version,".") && !instr(version,"_")) {
696             /* may be a v-string */
697             char *testv = (char *)version;
698             STRLEN tlen = len;
699             for (tlen=0; tlen < len; tlen++, testv++) {
700                 /* if one of the characters is non-text assume v-string */
701                 if (testv[0] < ' ') {
702                     SV * const nsv = sv_newmortal();
703                     const char *nver;
704                     const char *pos;
705                     int saw_decimal = 0;
706                     sv_setpvf(nsv,"v%vd",ver);
707                     pos = nver = savepv(SvPV_nolen(nsv));
708                     SAVEFREEPV(pos);
709
710                     /* scan the resulting formatted string */
711                     pos++; /* skip the leading 'v' */
712                     while ( *pos == '.' || isDIGIT(*pos) ) {
713                         if ( *pos == '.' )
714                             saw_decimal++ ;
715                         pos++;
716                     }
717
718                     /* is definitely a v-string */
719                     if ( saw_decimal >= 2 ) {
720                         version = nver;
721                     }
722                     break;
723                 }
724             }
725         }
726 #  endif
727 #endif
728     }
729 #if PERL_VERSION_LT(5,17,2)
730     else if (SvIOKp(ver)) {
731         goto VER_IV;
732     }
733     else if (SvNOKp(ver)) {
734         goto VER_NV;
735     }
736     else if (SvPOKp(ver)) {
737         goto VER_PV;
738     }
739 #endif
740     else
741     {
742         /* no idea what this is */
743         Perl_croak(aTHX_ "Invalid version format (non-numeric data)");
744     }
745
746     s = SCAN_VERSION(version, ver, qv);
747     if ( *s != '\0' ) 
748         Perl_ck_warner(aTHX_ packWARN(WARN_MISC), 
749                        "Version string '%s' contains invalid data; "
750                        "ignoring: '%s'", version, s);
751
752 #if PERL_VERSION_LT(5,19,8) && defined(USE_ITHREADS)
753     LEAVE;
754 #endif
755
756     return ver;
757 }
758
759 /*
760 =for apidoc vverify
761
762 Validates that the SV contains valid internal structure for a version object.
763 It may be passed either the version object (RV) or the hash itself (HV).  If
764 the structure is valid, it returns the HV.  If the structure is invalid,
765 it returns NULL.
766
767     SV *hv = vverify(sv);
768
769 Note that it only confirms the bare minimum structure (so as not to get
770 confused by derived classes which may contain additional hash entries):
771
772 =over 4
773
774 =item * The SV is an HV or a reference to an HV
775
776 =item * The hash contains a "version" key
777
778 =item * The "version" key has a reference to an AV as its value
779
780 =back
781
782 =cut
783 */
784
785 SV *
786 #ifdef VUTIL_REPLACE_CORE
787 Perl_vverify2(pTHX_ SV *vs)
788 #else
789 Perl_vverify(pTHX_ SV *vs)
790 #endif
791 {
792     SV *sv;
793     SV **svp;
794
795     PERL_ARGS_ASSERT_VVERIFY;
796
797     if ( SvROK(vs) )
798         vs = SvRV(vs);
799
800     /* see if the appropriate elements exist */
801     if ( SvTYPE(vs) == SVt_PVHV
802          && (svp = hv_fetchs(MUTABLE_HV(vs), "version", FALSE))
803          && (sv = SvRV(*svp))
804          && SvTYPE(sv) == SVt_PVAV )
805         return vs;
806     else
807         return NULL;
808 }
809
810 /*
811 =for apidoc vnumify
812
813 Accepts a version object and returns the normalized floating
814 point representation.  Call like:
815
816     sv = vnumify(rv);
817
818 NOTE: you can pass either the object directly or the SV
819 contained within the RV.
820
821 The SV returned has a refcount of 1.
822
823 =cut
824 */
825
826 SV *
827 #ifdef VUTIL_REPLACE_CORE
828 Perl_vnumify2(pTHX_ SV *vs)
829 #else
830 Perl_vnumify(pTHX_ SV *vs)
831 #endif
832 {
833     SSize_t i, len;
834     I32 digit;
835     bool alpha = FALSE;
836     SV *sv;
837     AV *av;
838
839     PERL_ARGS_ASSERT_VNUMIFY;
840
841     /* extract the HV from the object */
842     vs = VVERIFY(vs);
843     if ( ! vs )
844         Perl_croak(aTHX_ "Invalid version object");
845
846     /* see if various flags exist */
847     if ( hv_exists(MUTABLE_HV(vs), "alpha", 5 ) )
848         alpha = TRUE;
849
850     if (alpha) {
851         Perl_ck_warner(aTHX_ packWARN(WARN_NUMERIC),
852                        "alpha->numify() is lossy");
853     }
854
855     /* attempt to retrieve the version array */
856     if ( !(av = MUTABLE_AV(SvRV(*hv_fetchs(MUTABLE_HV(vs), "version", FALSE))) ) ) {
857         return newSVpvs("0");
858     }
859
860     len = av_len(av);
861     if ( len == -1 )
862     {
863         return newSVpvs("0");
864     }
865
866     {
867         SV * tsv = *av_fetch(av, 0, 0);
868         digit = SvIV(tsv);
869     }
870     sv = Perl_newSVpvf(aTHX_ "%d.", (int)PERL_ABS(digit));
871     for ( i = 1 ; i <= len ; i++ )
872     {
873         SV * tsv = *av_fetch(av, i, 0);
874         digit = SvIV(tsv);
875         Perl_sv_catpvf(aTHX_ sv, "%03d", (int)digit);
876     }
877
878     if ( len == 0 ) {
879         sv_catpvs(sv, "000");
880     }
881     return sv;
882 }
883
884 /*
885 =for apidoc vnormal
886
887 Accepts a version object and returns the normalized string
888 representation.  Call like:
889
890     sv = vnormal(rv);
891
892 NOTE: you can pass either the object directly or the SV
893 contained within the RV.
894
895 The SV returned has a refcount of 1.
896
897 =cut
898 */
899
900 SV *
901 #ifdef VUTIL_REPLACE_CORE
902 Perl_vnormal2(pTHX_ SV *vs)
903 #else
904 Perl_vnormal(pTHX_ SV *vs)
905 #endif
906 {
907     I32 i, len, digit;
908     SV *sv;
909     AV *av;
910
911     PERL_ARGS_ASSERT_VNORMAL;
912
913     /* extract the HV from the object */
914     vs = VVERIFY(vs);
915     if ( ! vs )
916         Perl_croak(aTHX_ "Invalid version object");
917
918     av = MUTABLE_AV(SvRV(*hv_fetchs(MUTABLE_HV(vs), "version", FALSE)));
919
920     len = av_len(av);
921     if ( len == -1 )
922     {
923         return newSVpvs("");
924     }
925     {
926         SV * tsv = *av_fetch(av, 0, 0);
927         digit = SvIV(tsv);
928     }
929     sv = Perl_newSVpvf(aTHX_ "v%" IVdf, (IV)digit);
930     for ( i = 1 ; i <= len ; i++ ) {
931         SV * tsv = *av_fetch(av, i, 0);
932         digit = SvIV(tsv);
933         Perl_sv_catpvf(aTHX_ sv, ".%" IVdf, (IV)digit);
934     }
935
936     if ( len <= 2 ) { /* short version, must be at least three */
937         for ( len = 2 - len; len != 0; len-- )
938             sv_catpvs(sv,".0");
939     }
940     return sv;
941 }
942
943 /*
944 =for apidoc vstringify
945
946 In order to maintain maximum compatibility with earlier versions
947 of Perl, this function will return either the floating point
948 notation or the multiple dotted notation, depending on whether
949 the original version contained 1 or more dots, respectively.
950
951 The SV returned has a refcount of 1.
952
953 =cut
954 */
955
956 SV *
957 #ifdef VUTIL_REPLACE_CORE
958 Perl_vstringify2(pTHX_ SV *vs)
959 #else
960 Perl_vstringify(pTHX_ SV *vs)
961 #endif
962 {
963     SV ** svp;
964     PERL_ARGS_ASSERT_VSTRINGIFY;
965
966     /* extract the HV from the object */
967     vs = VVERIFY(vs);
968     if ( ! vs )
969         Perl_croak(aTHX_ "Invalid version object");
970
971     svp = hv_fetchs(MUTABLE_HV(vs), "original", FALSE);
972     if (svp) {
973         SV *pv;
974         pv = *svp;
975         if ( SvPOK(pv)
976 #if PERL_VERSION_LT(5,17,2)
977             || SvPOKp(pv)
978 #endif
979         )
980             return newSVsv(pv);
981         else
982             return &PL_sv_undef;
983     }
984     else {
985         if ( hv_exists(MUTABLE_HV(vs), "qv", 2) )
986             return VNORMAL(vs);
987         else
988             return VNUMIFY(vs);
989     }
990 }
991
992 /*
993 =for apidoc vcmp
994
995 Version object aware cmp.  Both operands must already have been 
996 converted into version objects.
997
998 =cut
999 */
1000
1001 int
1002 #ifdef VUTIL_REPLACE_CORE
1003 Perl_vcmp2(pTHX_ SV *lhv, SV *rhv)
1004 #else
1005 Perl_vcmp(pTHX_ SV *lhv, SV *rhv)
1006 #endif
1007 {
1008     SSize_t i,l,m,r;
1009     I32 retval;
1010     I32 left = 0;
1011     I32 right = 0;
1012     AV *lav, *rav;
1013
1014     PERL_ARGS_ASSERT_VCMP;
1015
1016     /* extract the HVs from the objects */
1017     lhv = VVERIFY(lhv);
1018     rhv = VVERIFY(rhv);
1019     if ( ! ( lhv && rhv ) )
1020         Perl_croak(aTHX_ "Invalid version object");
1021
1022     /* get the left hand term */
1023     lav = MUTABLE_AV(SvRV(*hv_fetchs(MUTABLE_HV(lhv), "version", FALSE)));
1024
1025     /* and the right hand term */
1026     rav = MUTABLE_AV(SvRV(*hv_fetchs(MUTABLE_HV(rhv), "version", FALSE)));
1027
1028     l = av_len(lav);
1029     r = av_len(rav);
1030     m = l < r ? l : r;
1031     retval = 0;
1032     i = 0;
1033     while ( i <= m && retval == 0 )
1034     {
1035         SV * const lsv = *av_fetch(lav,i,0);
1036         SV * rsv;
1037         left = SvIV(lsv);
1038         rsv = *av_fetch(rav,i,0);
1039         right = SvIV(rsv);
1040         if ( left < right  )
1041             retval = -1;
1042         if ( left > right )
1043             retval = +1;
1044         i++;
1045     }
1046
1047     if ( l != r && retval == 0 ) /* possible match except for trailing 0's */
1048     {
1049         if ( l < r )
1050         {
1051             while ( i <= r && retval == 0 )
1052             {
1053                 SV * const rsv = *av_fetch(rav,i,0);
1054                 if ( SvIV(rsv) != 0 )
1055                     retval = -1; /* not a match after all */
1056                 i++;
1057             }
1058         }
1059         else
1060         {
1061             while ( i <= l && retval == 0 )
1062             {
1063                 SV * const lsv = *av_fetch(lav,i,0);
1064                 if ( SvIV(lsv) != 0 )
1065                     retval = +1; /* not a match after all */
1066                 i++;
1067             }
1068         }
1069     }
1070     return retval;
1071 }
1072
1073 /* ex: set ro: */