This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perl.h: Add debugging statements for mutex ops
[perl5.git] / vutil.c
CommitLineData
abc6d738
FC
1/* This file is part of the "version" CPAN distribution. Please avoid
2 editing it in the perl core. */
3
14f3031b
JP
4#ifdef PERL_CORE
5# include "vutil.h"
d4e59e62 6#endif
d4e59e62 7
abc6d738
FC
8#define VERSION_MAX 0x7FFFFFFF
9
10/*
11=for apidoc prescan_version
12
13Validate that a given string can be parsed as a version object, but doesn't
14actually perform the parsing. Can use either strict or lax validation rules.
15Can optionally set a number of hint variables to save the parsing code
16some time when tokenizing.
17
18=cut
19*/
20const char *
24120986 21#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
22Perl_prescan_version2(pTHX_ const char *s, bool strict,
23#else
abc6d738 24Perl_prescan_version(pTHX_ const char *s, bool strict,
d4e59e62 25#endif
abc6d738
FC
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
130cad93
LT
34 PERL_ARGS_ASSERT_PRESCAN_VERSION;
35 PERL_UNUSED_CONTEXT;
abc6d738
FC
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
50dotted_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
210version_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 }
14f3031b
JP
218 if (saw_decimal > 1 && d[-1] == '.') {
219 /* no trailing period allowed */
220 BADVERSION(s,errstr,"Invalid version format (trailing decimal)");
221 }
222
abc6d738
FC
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
238Returns a pointer to the next character after the parsed
239version string, as well as upgrading the passed in SV to
240an RV.
241
242Function must be called with an already existing SV like
243
244 sv = newSV(0);
245 s = scan_version(s, SV *sv, bool qv);
246
247Performs some preprocessing to the string to ensure that
248it has the correct characteristics of a version. Flags the
249object if it contains an underscore (which denotes this
250is an alpha version). The boolean qv denotes that the version
251should be interpreted as if it had multiple decimals, even if
252it doesn't.
253
254=cut
255*/
256
257const char *
24120986 258#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
259Perl_scan_version2(pTHX_ const char *s, SV *rv, bool qv)
260#else
abc6d738 261Perl_scan_version(pTHX_ const char *s, SV *rv, bool qv)
d4e59e62 262#endif
abc6d738
FC
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
d4e59e62 280 last = PRESCAN_VERSION(s, FALSE, &errstr, &qv, &saw_decimal, &width, &alpha);
abc6d738
FC
281 if (errstr) {
282 /* "undef" is a special case and not an error */
05402f6b 283 if ( ! ( *s == 'u' && strEQ(s+1,"ndef")) ) {
abc6d738
FC
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
14f3031b 309 while (isDIGIT(*pos) || *pos == '_')
abc6d738
FC
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 ) {
14f3031b
JP
329 if (*s == '_')
330 continue;
abc6d738
FC
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) {
14f3031b
JP
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 {
abc6d738
FC
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 }
14f3031b
JP
363 else
364 rev += i * mult;
365
366 if (mult > VERSION_MAX / 10)
367 mult = VERSION_MAX;
368 else
369 mult *= 10;
abc6d738
FC
370 }
371 }
372 }
373
374 /* Append revision */
375 av_push(av, newSViv(rev));
376 if ( vinf ) {
377 s = last;
378 break;
379 }
14f3031b
JP
380 else if ( *pos == '.' ) {
381 pos++;
382 if (qv) {
383 while (*pos == '0')
384 ++pos;
385 }
386 s = pos;
387 }
abc6d738
FC
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 ) {
14f3031b 399 while ( isDIGIT(*pos) || *pos == '_')
abc6d738
FC
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*/
05402f6b 413 SSize_t len = AvFILLp(av);
abc6d738
FC
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 */
05402f6b 449 if ( *s == 'u' && strEQ(s+1,"ndef") ) {
abc6d738
FC
450 s += 5;
451 }
452
453 return s;
454}
455
456/*
457=for apidoc new_version
458
459Returns a new version object based on the passed in SV:
460
461 SV *sv = new_version(SV *ver);
462
463Does not alter the passed in ver SV. See "upg_version" if you
464want to upgrade the SV.
465
466=cut
467*/
468
469SV *
24120986 470#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
471Perl_new_version2(pTHX_ SV *ver)
472#else
abc6d738 473Perl_new_version(pTHX_ SV *ver)
d4e59e62 474#endif
abc6d738 475{
abc6d738
FC
476 SV * const rv = newSV(0);
477 PERL_ARGS_ASSERT_NEW_VERSION;
05402f6b 478 if ( ISA_VERSION_OBJ(ver) ) /* can just copy directly */
abc6d738
FC
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 */
817794ed 494 if ( hv_exists(MUTABLE_HV(ver), "qv", 2) )
abc6d738
FC
495 (void)hv_stores(MUTABLE_HV(hv), "qv", newSViv(1));
496
817794ed 497 if ( hv_exists(MUTABLE_HV(ver), "alpha", 5) )
abc6d738 498 (void)hv_stores(MUTABLE_HV(hv), "alpha", newSViv(1));
abc6d738 499 {
05402f6b
JP
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 }
abc6d738 505 }
abc6d738 506 {
05402f6b
JP
507 SV ** svp = hv_fetchs(MUTABLE_HV(ver), "original", FALSE);
508 if(svp)
509 (void)hv_stores(MUTABLE_HV(hv), "original", newSVsv(*svp));
abc6d738 510 }
abc6d738
FC
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 {
05402f6b
JP
515 SV * const sv = *av_fetch(sav, key, FALSE);
516 const I32 rev = SvIV(sv);
abc6d738
FC
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;
05402f6b 528 const char * const version = (const char*)mg->mg_ptr;
14f3031b
JP
529 char *raw, *under;
530 static const char underscore[] = "_";
abc6d738 531 sv_setpvn(rv,version,len);
14f3031b
JP
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 }
abc6d738
FC
539 /* this is for consistency with the pure Perl class */
540 if ( isDIGIT(*version) )
541 sv_insert(rv, 0, 0, "v", 1);
abc6d738
FC
542 }
543 else {
544#endif
95a23f5d 545 SvSetSV_nosteal(rv, ver); /* make a duplicate */
abc6d738
FC
546#ifdef SvVOK
547 }
548 }
549#endif
9190f8ab
JP
550 sv_2mortal(rv); /* in case upg_version croaks before it returns */
551 return SvREFCNT_inc_NN(UPG_VERSION(rv, FALSE));
abc6d738
FC
552}
553
554/*
555=for apidoc upg_version
556
557In-place upgrade of the supplied SV to a version object.
558
559 SV *sv = upg_version(SV *sv, bool qv);
560
561Returns a pointer to the upgraded SV. Set the boolean qv if you want
562to force this SV to be interpreted as an "extended" version.
563
564=cut
565*/
566
567SV *
24120986 568#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
569Perl_upg_version2(pTHX_ SV *ver, bool qv)
570#else
abc6d738 571Perl_upg_version(pTHX_ SV *ver, bool qv)
d4e59e62 572#endif
abc6d738
FC
573{
574 const char *version, *s;
575#ifdef SvVOK
576 const MAGIC *mg;
577#endif
578
d2b110e6 579#if PERL_VERSION_LT(5,19,8) && defined(USE_ITHREADS)
e2ca569e 580 ENTER;
d2b110e6 581#endif
abc6d738
FC
582 PERL_ARGS_ASSERT_UPG_VERSION;
583
9190f8ab
JP
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))
24120986 596#if PERL_VERSION_LT(5,17,2)
9190f8ab 597VER_IV:
24120986 598#endif
9190f8ab
JP
599 {
600 version = savesvpv(ver);
601 SAVEFREEPV(version);
602 }
603 else if (SvNOK(ver) && !( SvPOK(ver) && SvCUR(ver) == 3 ) )
24120986 604#if PERL_VERSION_LT(5,17,2)
9190f8ab 605VER_NV:
24120986 606#endif
abc6d738
FC
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;
14f3031b
JP
614
615#if PERL_VERSION_GE(5,19,0)
616 if (SvPOK(ver)) {
617 /* dualvar? */
618 goto VER_PV;
619 }
620#endif
f57000bc 621#ifdef USE_LOCALE_NUMERIC
190ce35b
KW
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
49d7d366
KW
631 LC_NUMERIC_LOCK(0); /* Start critical section */
632
190ce35b
KW
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 }
49d7d366 643
190ce35b
KW
644 /* Prevent recursed calls from trying to change back */
645 LOCK_LC_NUMERIC_STANDARD();
646
f57000bc 647#endif
190ce35b 648
b9a25d15
KW
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 }
190ce35b
KW
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 }
49d7d366
KW
666
667 LC_NUMERIC_UNLOCK; /* End critical section */
668
f57000bc 669 }
190ce35b
KW
670
671#endif /* USE_LOCALE_NUMERIC */
672
abc6d738
FC
673 while (buf[len-1] == '0' && len > 0) len--;
674 if ( buf[len-1] == '.' ) len--; /* eat the trailing decimal */
675 version = savepvn(buf, len);
05402f6b 676 SAVEFREEPV(version);
abc6d738
FC
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 );
05402f6b 682 SAVEFREEPV(version);
abc6d738
FC
683 qv = TRUE;
684 }
685#endif
9190f8ab
JP
686 else if ( SvPOK(ver))/* must be a string or something like a string */
687VER_PV:
abc6d738
FC
688 {
689 STRLEN len;
4141ef59 690 version = savepvn(SvPV(ver,len), SvCUR(ver));
05402f6b 691 SAVEFREEPV(version);
abc6d738
FC
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));
05402f6b 708 SAVEFREEPV(pos);
abc6d738
FC
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 ) {
abc6d738
FC
720 version = nver;
721 }
722 break;
723 }
724 }
725 }
726# endif
727#endif
728 }
9190f8ab
JP
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
ab4e0d4b
JP
740 else
741 {
742 /* no idea what this is */
743 Perl_croak(aTHX_ "Invalid version format (non-numeric data)");
744 }
abc6d738 745
d4e59e62 746 s = SCAN_VERSION(version, ver, qv);
abc6d738
FC
747 if ( *s != '\0' )
748 Perl_ck_warner(aTHX_ packWARN(WARN_MISC),
749 "Version string '%s' contains invalid data; "
750 "ignoring: '%s'", version, s);
d2b110e6
JP
751
752#if PERL_VERSION_LT(5,19,8) && defined(USE_ITHREADS)
e2ca569e 753 LEAVE;
d2b110e6 754#endif
9190f8ab 755
abc6d738
FC
756 return ver;
757}
758
759/*
760=for apidoc vverify
761
762Validates that the SV contains valid internal structure for a version object.
763It may be passed either the version object (RV) or the hash itself (HV). If
764the structure is valid, it returns the HV. If the structure is invalid,
765it returns NULL.
766
767 SV *hv = vverify(sv);
768
769Note that it only confirms the bare minimum structure (so as not to get
770confused 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
785SV *
24120986 786#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
787Perl_vverify2(pTHX_ SV *vs)
788#else
abc6d738 789Perl_vverify(pTHX_ SV *vs)
d4e59e62 790#endif
abc6d738
FC
791{
792 SV *sv;
05402f6b 793 SV **svp;
abc6d738
FC
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
05402f6b
JP
802 && (svp = hv_fetchs(MUTABLE_HV(vs), "version", FALSE))
803 && (sv = SvRV(*svp))
abc6d738
FC
804 && SvTYPE(sv) == SVt_PVAV )
805 return vs;
806 else
807 return NULL;
808}
809
810/*
811=for apidoc vnumify
812
813Accepts a version object and returns the normalized floating
814point representation. Call like:
815
816 sv = vnumify(rv);
817
818NOTE: you can pass either the object directly or the SV
819contained within the RV.
820
821The SV returned has a refcount of 1.
822
823=cut
824*/
825
826SV *
24120986 827#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
828Perl_vnumify2(pTHX_ SV *vs)
829#else
abc6d738 830Perl_vnumify(pTHX_ SV *vs)
d4e59e62 831#endif
abc6d738
FC
832{
833 SSize_t i, len;
834 I32 digit;
abc6d738
FC
835 bool alpha = FALSE;
836 SV *sv;
837 AV *av;
838
839 PERL_ARGS_ASSERT_VNUMIFY;
840
841 /* extract the HV from the object */
d4e59e62 842 vs = VVERIFY(vs);
abc6d738
FC
843 if ( ! vs )
844 Perl_croak(aTHX_ "Invalid version object");
845
846 /* see if various flags exist */
817794ed 847 if ( hv_exists(MUTABLE_HV(vs), "alpha", 5 ) )
abc6d738 848 alpha = TRUE;
abc6d738 849
14f3031b
JP
850 if (alpha) {
851 Perl_ck_warner(aTHX_ packWARN(WARN_NUMERIC),
852 "alpha->numify() is lossy");
853 }
abc6d738
FC
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
05402f6b
JP
866 {
867 SV * tsv = *av_fetch(av, 0, 0);
868 digit = SvIV(tsv);
869 }
abc6d738 870 sv = Perl_newSVpvf(aTHX_ "%d.", (int)PERL_ABS(digit));
14f3031b 871 for ( i = 1 ; i <= len ; i++ )
abc6d738 872 {
05402f6b
JP
873 SV * tsv = *av_fetch(av, i, 0);
874 digit = SvIV(tsv);
14f3031b 875 Perl_sv_catpvf(aTHX_ sv, "%03d", (int)digit);
abc6d738
FC
876 }
877
14f3031b 878 if ( len == 0 ) {
abc6d738
FC
879 sv_catpvs(sv, "000");
880 }
881 return sv;
882}
883
884/*
885=for apidoc vnormal
886
887Accepts a version object and returns the normalized string
888representation. Call like:
889
890 sv = vnormal(rv);
891
892NOTE: you can pass either the object directly or the SV
893contained within the RV.
894
895The SV returned has a refcount of 1.
896
897=cut
898*/
899
900SV *
24120986 901#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
902Perl_vnormal2(pTHX_ SV *vs)
903#else
abc6d738 904Perl_vnormal(pTHX_ SV *vs)
d4e59e62 905#endif
abc6d738
FC
906{
907 I32 i, len, digit;
abc6d738
FC
908 SV *sv;
909 AV *av;
910
911 PERL_ARGS_ASSERT_VNORMAL;
912
913 /* extract the HV from the object */
d4e59e62 914 vs = VVERIFY(vs);
abc6d738
FC
915 if ( ! vs )
916 Perl_croak(aTHX_ "Invalid version object");
917
abc6d738
FC
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 }
05402f6b
JP
925 {
926 SV * tsv = *av_fetch(av, 0, 0);
927 digit = SvIV(tsv);
928 }
b9a25d15 929 sv = Perl_newSVpvf(aTHX_ "v%" IVdf, (IV)digit);
14f3031b 930 for ( i = 1 ; i <= len ; i++ ) {
05402f6b
JP
931 SV * tsv = *av_fetch(av, i, 0);
932 digit = SvIV(tsv);
b9a25d15 933 Perl_sv_catpvf(aTHX_ sv, ".%" IVdf, (IV)digit);
abc6d738
FC
934 }
935
abc6d738
FC
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
946In order to maintain maximum compatibility with earlier versions
947of Perl, this function will return either the floating point
948notation or the multiple dotted notation, depending on whether
949the original version contained 1 or more dots, respectively.
950
951The SV returned has a refcount of 1.
952
953=cut
954*/
955
956SV *
24120986 957#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
958Perl_vstringify2(pTHX_ SV *vs)
959#else
abc6d738 960Perl_vstringify(pTHX_ SV *vs)
d4e59e62 961#endif
abc6d738 962{
05402f6b 963 SV ** svp;
abc6d738
FC
964 PERL_ARGS_ASSERT_VSTRINGIFY;
965
966 /* extract the HV from the object */
d4e59e62 967 vs = VVERIFY(vs);
abc6d738
FC
968 if ( ! vs )
969 Perl_croak(aTHX_ "Invalid version object");
970
05402f6b
JP
971 svp = hv_fetchs(MUTABLE_HV(vs), "original", FALSE);
972 if (svp) {
abc6d738 973 SV *pv;
05402f6b 974 pv = *svp;
dddb2275
JP
975 if ( SvPOK(pv)
976#if PERL_VERSION_LT(5,17,2)
977 || SvPOKp(pv)
978#endif
979 )
abc6d738
FC
980 return newSVsv(pv);
981 else
982 return &PL_sv_undef;
983 }
984 else {
817794ed 985 if ( hv_exists(MUTABLE_HV(vs), "qv", 2) )
d4e59e62 986 return VNORMAL(vs);
abc6d738 987 else
d4e59e62 988 return VNUMIFY(vs);
abc6d738
FC
989 }
990}
991
992/*
993=for apidoc vcmp
994
995Version object aware cmp. Both operands must already have been
996converted into version objects.
997
998=cut
999*/
1000
1001int
24120986 1002#ifdef VUTIL_REPLACE_CORE
d4e59e62
FC
1003Perl_vcmp2(pTHX_ SV *lhv, SV *rhv)
1004#else
abc6d738 1005Perl_vcmp(pTHX_ SV *lhv, SV *rhv)
d4e59e62 1006#endif
abc6d738
FC
1007{
1008 SSize_t i,l,m,r;
1009 I32 retval;
abc6d738
FC
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 */
d4e59e62
FC
1017 lhv = VVERIFY(lhv);
1018 rhv = VVERIFY(rhv);
abc6d738
FC
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)));
abc6d738
FC
1024
1025 /* and the right hand term */
1026 rav = MUTABLE_AV(SvRV(*hv_fetchs(MUTABLE_HV(rhv), "version", FALSE)));
abc6d738
FC
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 {
05402f6b
JP
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);
abc6d738
FC
1040 if ( left < right )
1041 retval = -1;
1042 if ( left > right )
1043 retval = +1;
1044 i++;
1045 }
1046
abc6d738
FC
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 {
05402f6b
JP
1053 SV * const rsv = *av_fetch(rav,i,0);
1054 if ( SvIV(rsv) != 0 )
abc6d738
FC
1055 retval = -1; /* not a match after all */
1056 i++;
1057 }
1058 }
1059 else
1060 {
1061 while ( i <= l && retval == 0 )
1062 {
05402f6b
JP
1063 SV * const lsv = *av_fetch(lav,i,0);
1064 if ( SvIV(lsv) != 0 )
abc6d738
FC
1065 retval = +1; /* not a match after all */
1066 i++;
1067 }
1068 }
1069 }
1070 return retval;
1071}
14f3031b
JP
1072
1073/* ex: set ro: */