projects / p5sagit/p5-mst-13.2.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | history | HEAD
Fixes for the test suite on OS/2
[p5sagit/p5-mst-13.2.git] / t / op / pack.t
CommitLineData
d50dd4e4 1#!./perl -w
a687059c 2
a1a0e61e 3BEGIN {
4 chdir 't' if -d 't';
20822f61 5 @INC = '../lib';
0b568b5f 6 require './test.pl';
b23b8711 7}
8
d9db00a6 9# This is truth in an if statement, and could be a skip message
10my $no_endianness = $] > 5.009 ? '' :
11 "Endianness pack modifiers not available on this perl";
12my $no_signedness = $] > 5.009 ? '' :
13 "Signed/unsigned pack modifiers not available on this perl";
14
28be1210 15plan tests => 14697;
0b568b5f 16
fa8ec7c1 17use strict;
bd7d4f4d 18use warnings qw(FATAL all);
b23b8711 19use Config;
20
fa8ec7c1 21my $Is_EBCDIC = (defined $Config{ebcdic} && $Config{ebcdic} eq 'define');
0b568b5f 22my $Perl = which_perl();
1109a392 23my @valid_errors = (qr/^Invalid type '\w'/);
24
25my $ByteOrder = 'unknown';
26my $maybe_not_avail = '(?:hto[bl]e|[bl]etoh)';
d9db00a6 27if ($no_endianness) {
28 push @valid_errors, qr/^Invalid type '[<>]'/;
29} elsif ($Config{byteorder} =~ /^1234(?:5678)?$/) {
1109a392 30 $ByteOrder = 'little';
31 $maybe_not_avail = '(?:htobe|betoh)';
32}
33elsif ($Config{byteorder} =~ /^(?:8765)?4321$/) {
34 $ByteOrder = 'big';
35 $maybe_not_avail = '(?:htole|letoh)';
36}
37else {
38 push @valid_errors, qr/^Can't (?:un)?pack (?:big|little)-endian .*? on this platform/;
39}
40
d9db00a6 41if ($no_signedness) {
42 push @valid_errors, qr/^'!' allowed only after types sSiIlLxX in (?:un)?pack/;
43}
44
1109a392 45for my $size ( 16, 32, 64 ) {
dd304013 46 if (defined $Config{"u${size}size"} and $Config{"u${size}size"} != ($size >> 3)) {
1109a392 47 push @valid_errors, qr/^Perl_my_$maybe_not_avail$size\(\) not available/;
48 }
49}
50
51my $IsTwosComplement = pack('i', -1) eq "\xFF" x $Config{intsize};
52print "# \$IsTwosComplement = $IsTwosComplement\n";
53
54sub is_valid_error
55{
56 my $err = shift;
57
58 for my $e (@valid_errors) {
59 $err =~ $e and return 1;
60 }
61
62 return 0;
63}
c274e827 64
b85d93de 65sub encode_list {
9e17a6b8 66 my @result = map {_qq($_)} @_;
b85d93de 67 if (@result == 1) {
68 return @result;
69 }
70 return '(' . join (', ', @result) . ')';
71}
72
a1a0e61e 73
b85d93de 74sub list_eq ($$) {
75 my ($l, $r) = @_;
c8f824eb 76 return 0 unless @$l == @$r;
b85d93de 77 for my $i (0..$#$l) {
78 if (defined $l->[$i]) {
c8f824eb 79 return 0 unless defined ($r->[$i]) && $l->[$i] eq $r->[$i];
b85d93de 80 } else {
c8f824eb 81 return 0 if defined $r->[$i]
b85d93de 82 }
83 }
84 return 1;
85}
86
87##############################################################################
88#
89# Here starteth the tests
90#
91
fa8ec7c1 92{
0b568b5f 93 my $format = "c2 x5 C C x s d i l a6";
94 # Need the expression in here to force ary[5] to be numeric. This avoids
95 # test2 failing because ary2 goes str->numeric->str and ary doesn't.
96 my @ary = (1,-100,127,128,32767,987.654321098 / 100.0,12345,123456,
97 "abcdef");
98 my $foo = pack($format,@ary);
99 my @ary2 = unpack($format,$foo);
100
101 is($#ary, $#ary2);
102
103 my $out1=join(':',@ary);
104 my $out2=join(':',@ary2);
105 # Using long double NVs may introduce greater accuracy than wanted.
106 $out1 =~ s/:9\.87654321097999\d*:/:9.87654321098:/;
107 $out2 =~ s/:9\.87654321097999\d*:/:9.87654321098:/;
108 is($out1, $out2);
109
110 like($foo, qr/def/);
fa8ec7c1 111}
79072805 112# How about counting bits?
113
fa8ec7c1 114{
0b568b5f 115 my $x;
116 is( ($x = unpack("%32B*", "\001\002\004\010\020\040\100\200\377")), 16 );
79072805 117
0b568b5f 118 is( ($x = unpack("%32b69", "\001\002\004\010\020\040\100\200\017")), 12 );
79072805 119
0b568b5f 120 is( ($x = unpack("%32B69", "\001\002\004\010\020\040\100\200\017")), 9 );
fa8ec7c1 121}
79072805 122
fa8ec7c1 123{
0b568b5f 124 my $sum = 129; # ASCII
125 $sum = 103 if $Is_EBCDIC;
9d116dd7 126
0b568b5f 127 my $x;
128 is( ($x = unpack("%32B*", "Now is the time for all good blurfl")), $sum );
79072805 129
0b568b5f 130 my $foo;
131 open(BIN, $Perl) || die "Can't open $Perl: $!\n";
bd7d4f4d 132 binmode BIN;
0b568b5f 133 sysread BIN, $foo, 8192;
134 close BIN;
79072805 135
0b568b5f 136 $sum = unpack("%32b*", $foo);
137 my $longway = unpack("b*", $foo);
138 is( $sum, $longway =~ tr/1/1/ );
fa8ec7c1 139}
73a1c01a 140
fa8ec7c1 141{
142 my $x;
0b568b5f 143 is( ($x = unpack("I",pack("I", 0xFFFFFFFF))), 0xFFFFFFFF );
fa8ec7c1 144}
def98dd4 145
fa8ec7c1 146{
0b568b5f 147 # check 'w'
148 my @x = (5,130,256,560,32000,3097152,268435455,1073741844, 2**33,
149 '4503599627365785','23728385234614992549757750638446');
150 my $x = pack('w*', @x);
151 my $y = pack 'H*', '0581028200843081fa0081bd8440ffffff7f8480808014A0808'.
152 '0800087ffffffffffdb19caefe8e1eeeea0c2e1e3e8ede1ee6e';
153
154 is($x, $y);
155
156 my @y = unpack('w*', $y);
157 my $a;
158 while ($a = pop @x) {
159 my $b = pop @y;
160 is($a, $b);
161 }
def98dd4 162
0b568b5f 163 @y = unpack('w2', $x);
def98dd4 164
0b568b5f 165 is(scalar(@y), 2);
166 is($y[1], 130);
a6c48a57 167 $x = pack('w*', 5000000000); $y = '';
168 eval {
169 use Math::BigInt;
170 $y = pack('w*', Math::BigInt::->new(5000000000));
171 };
172 is($x, $y);
196b62db 173
174 $x = pack 'w', ~0;
175 $y = pack 'w', (~0).'';
176 is($x, $y);
177 is(unpack ('w',$x), ~0);
178 is(unpack ('w',$y), ~0);
179
180 $x = pack 'w', ~0 - 1;
181 $y = pack 'w', (~0) - 2;
182
183 if (~0 - 1 == (~0) - 2) {
184 is($x, $y, "NV arithmetic");
185 } else {
186 isnt($x, $y, "IV/NV arithmetic");
187 }
188 cmp_ok(unpack ('w',$x), '==', ~0 - 1);
189 cmp_ok(unpack ('w',$y), '==', ~0 - 2);
203d3f29 190
191 # These should spot that pack 'w' is using NV, not double, on platforms
192 # where IVs are smaller than doubles, and harmlessly pass elsewhere.
193 # (tests for change 16861)
194 my $x0 = 2**54+3;
195 my $y0 = 2**54-2;
196
197 $x = pack 'w', $x0;
198 $y = pack 'w', $y0;
199
200 if ($x0 == $y0) {
201 is($x, $y, "NV arithmetic");
202 } else {
203 isnt($x, $y, "IV/NV arithmetic");
204 }
205 cmp_ok(unpack ('w',$x), '==', $x0);
206 cmp_ok(unpack ('w',$y), '==', $y0);
fa8ec7c1 207}
def98dd4 208
0b568b5f 209
fa8ec7c1 210{
40837afc 211 print "# test exceptions\n";
fa8ec7c1 212 my $x;
213 eval { $x = unpack 'w', pack 'C*', 0xff, 0xff};
0b568b5f 214 like($@, qr/^Unterminated compressed integer/);
def98dd4 215
fa8ec7c1 216 eval { $x = unpack 'w', pack 'C*', 0xff, 0xff, 0xff, 0xff};
0b568b5f 217 like($@, qr/^Unterminated compressed integer/);
def98dd4 218
fa8ec7c1 219 eval { $x = unpack 'w', pack 'C*', 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff};
0b568b5f 220 like($@, qr/^Unterminated compressed integer/);
0258719b 221
222 eval { $x = pack 'w', -1 };
223 like ($@, qr/^Cannot compress negative numbers/);
224
225 eval { $x = pack 'w', '1'x(1 + length ~0) . 'e0' };
226 like ($@, qr/^Can only compress unsigned integers/);
227
9391b049 228 # Check that the warning behaviour on the modifiers !, < and > is as we
229 # expect it for this perl.
230 my $can_endian = $no_endianness ? '' : 'sSiIlLqQjJfFdDpP';
231 my $can_shriek = 'sSiIlL';
efb78d13 232 $can_shriek .= 'nNvV' unless $no_signedness;
9391b049 233 # h and H can't do either, so act as sanity checks in blead
efb78d13 234 foreach my $base (split '', 'hHsSiIlLqQjJfFdDpPnNvV') {
9391b049 235 foreach my $mod ('', '<', '>', '!', '<!', '>!', '!<', '!>') {
236 SKIP: {
237 # Avoid void context warnings.
238 my $a = eval {pack "$base$mod"};
239 skip "pack can't $base", 1 if $@ =~ /^Invalid type '\w'/;
240 # Which error you get when 2 would be possible seems to be emergent
241 # behaviour of pack's format parser.
242
243 my $fails_shriek = $mod =~ /!/ && index ($can_shriek, $base) == -1;
244 my $fails_endian = $mod =~ /[<>]/ && index ($can_endian, $base) == -1;
245 my $shriek_first = $mod =~ /^!/;
246
247 if ($no_endianness and ($mod eq '<!' or $mod eq '>!')) {
248 # The ! isn't seem as part of $base. Instead it's seen as a modifier
249 # on > or <
250 $fails_shriek = 1;
251 undef $fails_endian;
252 } elsif ($fails_shriek and $fails_endian) {
253 if ($shriek_first) {
254 undef $fails_endian;
255 }
256 }
257
258 if ($fails_endian) {
259 if ($no_endianness) {
260 # < and > are seen as pattern letters, not modifiers
261 like ($@, qr/^Invalid type '[<>]'/, "pack can't $base$mod");
262 } else {
263 like ($@, qr/^'[<>]' allowed only after types/,
264 "pack can't $base$mod");
265 }
266 } elsif ($fails_shriek) {
267 like ($@, qr/^'!' allowed only after types/,
268 "pack can't $base$mod");
269 } else {
270 is ($@, '', "pack can $base$mod");
271 }
272 }
273 }
274 }
275
d9db00a6 276 SKIP: {
277 skip $no_endianness, 2*3 + 2*8 if $no_endianness;
278 for my $mod (qw( ! < > )) {
279 eval { $x = pack "a$mod", 42 };
280 like ($@, qr/^'$mod' allowed only after types \S+ in pack/);
1109a392 281
d9db00a6 282 eval { $x = unpack "a$mod", 'x'x8 };
283 like ($@, qr/^'$mod' allowed only after types \S+ in unpack/);
284 }
1109a392 285
d9db00a6 286 for my $mod (qw( <> >< !<> !>< <!> >!< <>! ><! )) {
287 eval { $x = pack "sI${mod}s", 42, 47, 11 };
288 like ($@, qr/^Can't use both '<' and '>' after type 'I' in pack/);
1109a392 289
d9db00a6 290 eval { $x = unpack "sI${mod}s", 'x'x16 };
291 like ($@, qr/^Can't use both '<' and '>' after type 'I' in unpack/);
292 }
1109a392 293 }
294
0258719b 295 SKIP: {
296 # Is this a stupid thing to do on VMS, VOS and other unusual platforms?
71f93cb9 297
b987f19e 298 skip("-- the IEEE infinity model is unavailable in this configuration.", 1)
71f93cb9 299 if (($^O eq 'VMS') && !defined($Config{useieee}));
300
b987f19e 301 skip("-- $^O has serious fp indigestion on w-packed infinities", 1)
5688dfbf 302 if (
303 ($^O eq 'mpeix')
304 ||
305 ($^O eq 'ultrix')
306 ||
cd512f8e 307 ($^O =~ /^svr4/ && -f "/etc/issue" && -f "/etc/.relid") # NCR MP-RAS
5688dfbf 308 );
8b571b32 309
1109a392 310 my $inf = eval '2**1000000';
0258719b 311
b987f19e 312 skip("Couldn't generate infinity - got error '$@'", 1)
71b080b8 313 unless defined $inf and $inf == $inf / 2 and $inf + 1 == $inf;
0258719b 314
46ff39aa 315 local our $TODO;
316 $TODO = "VOS needs a fix for posix-1022 to pass this test."
317 if ($^O eq 'vos');
318
0258719b 319 eval { $x = pack 'w', $inf };
46ff39aa 320 like ($@, qr/^Cannot compress integer/, "Cannot compress integer");
0258719b 321 }
322
323 SKIP: {
71f93cb9 324
b987f19e 325 skip("-- the full range of an IEEE double may not be available in this configuration.", 3)
71f93cb9 326 if (($^O eq 'VMS') && !defined($Config{useieee}));
327
b987f19e 328 skip("-- $^O does not like 2**1023", 3)
ad415dae 329 if (($^O eq 'ultrix'));
330
0258719b 331 # This should be about the biggest thing possible on an IEEE double
332 my $big = eval '2**1023';
333
b987f19e 334 skip("Couldn't generate 2**1023 - got error '$@'", 3)
0258719b 335 unless defined $big and $big != $big / 2;
336
337 eval { $x = pack 'w', $big };
338 is ($@, '', "Should be able to pack 'w', $big # 2**1023");
339
340 my $y = eval {unpack 'w', $x};
341 is ($@, '',
342 "Should be able to unpack 'w' the result of pack 'w', $big # 2**1023");
343
344 # I'm getting about 1e-16 on FreeBSD
345 my $quotient = int (100 * ($y - $big) / $big);
346 ok($quotient < 2 && $quotient > -2,
1109a392 347 "Round trip pack, unpack 'w' of $big is within 1% ($quotient%)");
0258719b 348 }
349
fa8ec7c1 350}
def98dd4 351
40837afc 352print "# test the 'p' template\n";
84902520 353
354# literals
0b568b5f 355is(unpack("p",pack("p","foo")), "foo");
d9db00a6 356SKIP: {
357 skip $no_endianness, 2 if $no_endianness;
358 is(unpack("p<",pack("p<","foo")), "foo");
359 is(unpack("p>",pack("p>","foo")), "foo");
360}
84902520 361# scalars
0b568b5f 362is(unpack("p",pack("p",239)), 239);
d9db00a6 363SKIP: {
364 skip $no_endianness, 2 if $no_endianness;
365 is(unpack("p<",pack("p<",239)), 239);
366 is(unpack("p>",pack("p>",239)), 239);
367}
84902520 368
369# temps
370sub foo { my $a = "a"; return $a . $a++ . $a++ }
371{
bd7d4f4d 372 use warnings qw(NONFATAL all);;
0b568b5f 373 my $warning;
84902520 374 local $SIG{__WARN__} = sub {
0b568b5f 375 $warning = $_[0];
84902520 376 };
377 my $junk = pack("p", &foo);
0b568b5f 378
379 like($warning, qr/temporary val/);
84902520 380}
381
382# undef should give null pointer
1109a392 383like(pack("p", undef), qr/^\0+$/);
d9db00a6 384SKIP: {
385 skip $no_endianness, 2 if $no_endianness;
386 like(pack("p<", undef), qr/^\0+$/);
387 like(pack("p>", undef), qr/^\0+$/);
388}
84902520 389
20408e3c 390# Check for optimizer bug (e.g. Digital Unix GEM cc with -O4 on DU V4.0B gives
391# 4294967295 instead of -1)
392# see #ifdef __osf__ in pp.c pp_unpack
0b568b5f 393is((unpack("i",pack("i",-1))), -1);
20408e3c 394
1109a392 395print "# test the pack lengths of s S i I l L n N v V + modifiers\n";
396
397my @lengths = (
398 qw(s 2 S 2 i -4 I -4 l 4 L 4 n 2 N 4 v 2 V 4 n! 2 N! 4 v! 2 V! 4),
399 's!' => $Config{shortsize}, 'S!' => $Config{shortsize},
400 'i!' => $Config{intsize}, 'I!' => $Config{intsize},
401 'l!' => $Config{longsize}, 'L!' => $Config{longsize},
402);
403
404while (my ($base, $expect) = splice @lengths, 0, 2) {
405 my @formats = ($base);
406 $base =~ /^[nv]/i or push @formats, "$base>", "$base<";
407 for my $format (@formats) {
d9db00a6 408 SKIP: {
409 skip $no_endianness, 1 if $no_endianness && $format =~ m/[<>]/;
410 skip $no_signedness, 1 if $no_signedness && $format =~ /[nNvV]!/;
411 my $len = length(pack($format, 0));
412 if ($expect > 0) {
413 is($expect, $len, "format '$format'");
414 } else {
415 $expect = -$expect;
416 ok ($len >= $expect, "format '$format'") ||
417 print "# format '$format' has length $len, expected >= $expect\n";
418 }
1109a392 419 }
fa8ec7c1 420 }
421}
d4217c7e 422
d4217c7e 423
40837afc 424print "# test unpack-pack lengths\n";
425
f337b084 426my @templates = qw(c C W i I s S l L n N v V f d q Q);
d4217c7e 427
1109a392 428foreach my $base (@templates) {
429 my @tmpl = ($base);
f337b084 430 $base =~ /^[cwnv]/i or push @tmpl, "$base>", "$base<";
1109a392 431 foreach my $t (@tmpl) {
432 SKIP: {
433 my @t = eval { unpack("$t*", pack("$t*", 12, 34)) };
0b568b5f 434
1109a392 435 skip "cannot pack '$t' on this perl", 4
436 if is_valid_error($@);
3020ec7a 437
86704b5f 438 is( $@, '', "Template $t works");
1109a392 439 is(scalar @t, 2);
3020ec7a 440
0b568b5f 441 is($t[0], 12);
442 is($t[1], 34);
443 }
0b568b5f 444 }
d4217c7e 445}
9d116dd7 446
fa8ec7c1 447{
0b568b5f 448 # uuencode/decode
9d116dd7 449
0b568b5f 450 # Note that first uuencoding known 'text' data and then checking the
451 # binary values of the uuencoded version would not be portable between
452 # character sets. Uuencoding is meant for encoding binary data, not
453 # text data.
c4d5f83a 454
0b568b5f 455 my $in = pack 'C*', 0 .. 255;
ba1ac976 456
0b568b5f 457 # just to be anal, we do some random tr/`/ /
458 my $uu = <<'EOUU';
ba1ac976 459M` $"`P0%!@<("0H+# T.#Q`1$A,4%187&!D:&QP='A\@(2(C)"4F)R@I*BLL
9d116dd7 460M+2XO,#$R,S0U-C<X.3H[/#T^/T!!0D-$149'2$E*2TQ-3D]045)35%565UA9
461M6EM<75Y?8&%B8V1E9F=H:6IK;&UN;W!Q<G-T=79W>'EZ>WQ]?G^`@8*#A(6&
462MAXB)BHN,C8Z/D)&2DY25EI>8F9J;G)V>GZ"AHJ.DI::GJ*FJJZRMKJ^PL;*S
463MM+6VM[BYNKN\O;Z_P,'"P\3%QL?(R<K+S,W.S]#1TM/4U=;7V-G:V]S=WM_@
ba1ac976 464?X>+CY.7FY^CIZNOL[>[O\/'R\_3U]O?X^?K[_/W^_P `
9d116dd7 465EOUU
466
0b568b5f 467 $_ = $uu;
468 tr/ /`/;
9d116dd7 469
0b568b5f 470 is(pack('u', $in), $_);
fa8ec7c1 471
0b568b5f 472 is(unpack('u', $uu), $in);
9d116dd7 473
0b568b5f 474 $in = "\x1f\x8b\x08\x08\x58\xdc\xc4\x35\x02\x03\x4a\x41\x50\x55\x00\xf3\x2a\x2d\x2e\x51\x48\xcc\xcb\x2f\xc9\x48\x2d\x52\x08\x48\x2d\xca\x51\x28\x2d\x4d\xce\x4f\x49\x2d\xe2\x02\x00\x64\x66\x60\x5c\x1a\x00\x00\x00";
475 $uu = <<'EOUU';
eddc390b 476M'XL("%C<Q#4"`TI!4%4`\RHM+E%(S,LOR4@M4@A(+<I1*"U-SD])+>("`&1F
477&8%P:````
478EOUU
479
0b568b5f 480 is(unpack('u', $uu), $in);
eddc390b 481
0b568b5f 482# This is identical to the above except that backquotes have been
483# changed to spaces
eddc390b 484
0b568b5f 485 $uu = <<'EOUU';
eddc390b 486M'XL("%C<Q#4" TI!4%4 \RHM+E%(S,LOR4@M4@A(+<I1*"U-SD])+>(" &1F
c4d5f83a 487&8%P:
eddc390b 488EOUU
489
0b568b5f 490 # ' # Grr
491 is(unpack('u', $uu), $in);
ef54e1a4 492
d99ad34e 493}
726ea183 494
0b568b5f 495# test the ascii template types (A, a, Z)
726ea183 496
fa8ec7c1 497foreach (
0b568b5f 498['p', 'A*', "foo\0bar\0 ", "foo\0bar\0 "],
fa8ec7c1 499['p', 'A11', "foo\0bar\0 ", "foo\0bar\0 "],
0b568b5f 500['u', 'A*', "foo\0bar \0", "foo\0bar"],
501['u', 'A8', "foo\0bar \0", "foo\0bar"],
502['p', 'a*', "foo\0bar\0 ", "foo\0bar\0 "],
fa8ec7c1 503['p', 'a11', "foo\0bar\0 ", "foo\0bar\0 \0\0"],
0b568b5f 504['u', 'a*', "foo\0bar \0", "foo\0bar \0"],
505['u', 'a8', "foo\0bar \0", "foo\0bar "],
506['p', 'Z*', "foo\0bar\0 ", "foo\0bar\0 \0"],
fa8ec7c1 507['p', 'Z11', "foo\0bar\0 ", "foo\0bar\0 \0\0"],
0b568b5f 508['p', 'Z3', "foo", "fo\0"],
509['u', 'Z*', "foo\0bar \0", "foo"],
510['u', 'Z8', "foo\0bar \0", "foo"],
28be1210 511)
0b568b5f 512{
513 my ($what, $template, $in, $out) = @$_;
514 my $got = $what eq 'u' ? (unpack $template, $in) : (pack $template, $in);
515 unless (is($got, $out)) {
0b568b5f 516 my $un = $what eq 'u' ? 'un' : '';
9e17a6b8 517 print "# ${un}pack ('$template', "._qq($in).') gave '._qq($out).
518 ' not '._qq($got)."\n";
0b568b5f 519 }
d99ad34e 520}
726ea183 521
40837afc 522print "# packing native shorts/ints/longs\n";
726ea183 523
0b568b5f 524is(length(pack("s!", 0)), $Config{shortsize});
525is(length(pack("i!", 0)), $Config{intsize});
526is(length(pack("l!", 0)), $Config{longsize});
527ok(length(pack("s!", 0)) <= length(pack("i!", 0)));
528ok(length(pack("i!", 0)) <= length(pack("l!", 0)));
529is(length(pack("i!", 0)), length(pack("i", 0)));
726ea183 530
fa8ec7c1 531sub numbers {
1109a392 532 my $base = shift;
533 my @formats = ($base);
534 $base =~ /^[silqjfdp]/i and push @formats, "$base>", "$base<";
535 for my $format (@formats) {
536 numbers_with_total ($format, undef, @_);
537 }
d99ad34e 538}
726ea183 539
fa8ec7c1 540sub numbers_with_total {
541 my $format = shift;
542 my $total = shift;
543 if (!defined $total) {
544 foreach (@_) {
545 $total += $_;
546 }
547 }
40837afc 548 print "# numbers test for $format\n";
fa8ec7c1 549 foreach (@_) {
0b568b5f 550 SKIP: {
551 my $out = eval {unpack($format, pack($format, $_))};
1109a392 552 skip "cannot pack '$format' on this perl", 2
553 if is_valid_error($@);
0b568b5f 554
96b96e00 555 is($@, '', "no error");
556 is($out, $_, "unpack pack $format $_");
fa8ec7c1 557 }
fa8ec7c1 558 }
726ea183 559
fa8ec7c1 560 my $skip_if_longer_than = ~0; # "Infinity"
561 if (~0 - 1 == ~0) {
562 # If we're running with -DNO_PERLPRESERVE_IVUV and NVs don't preserve all
563 # UVs (in which case ~0 is NV, ~0-1 will be the same NV) then we can't
564 # correctly in perl calculate UV totals for long checksums, as pp_unpack
565 # is using UV maths, and we've only got NVs.
53133ed1 566 $skip_if_longer_than = $Config{nv_preserves_uv_bits};
fa8ec7c1 567 }
726ea183 568
fa8ec7c1 569 foreach ('', 1, 2, 3, 15, 16, 17, 31, 32, 33, 53, 54, 63, 64, 65) {
0b568b5f 570 SKIP: {
571 my $sum = eval {unpack "%$_$format*", pack "$format*", @_};
572 skip "cannot pack '$format' on this perl", 3
1109a392 573 if is_valid_error($@);
0b568b5f 574
96b96e00 575 is($@, '', "no error");
576 ok(defined $sum, "sum bits $_, format $format defined");
0b568b5f 577
578 my $len = $_; # Copy, so that we can reassign ''
579 $len = 16 unless length $len;
580
581 SKIP: {
582 skip "cannot test checksums over $skip_if_longer_than bits", 1
583 if $len > $skip_if_longer_than;
584
585 # Our problem with testing this portably is that the checksum code in
586 # pp_unpack is able to cast signed to unsigned, and do modulo 2**n
587 # arithmetic in unsigned ints, which perl has no operators to do.
588 # (use integer; does signed ints, which won't wrap on UTS, which is just
589 # fine with ANSI, but not with most people's assumptions.
590 # This is why we need to supply the totals for 'Q' as there's no way in
591 # perl to calculate them, short of unpack '%0Q' (is that documented?)
592 # ** returns NVs; make sure it's IV.
593 my $max = 1 + 2 * (int (2 ** ($len-1))-1); # The max possible checksum
594 my $max_p1 = $max + 1;
595 my ($max_is_integer, $max_p1_is_integer);
596 $max_p1_is_integer = 1 unless $max_p1 + 1 == $max_p1;
597 $max_is_integer = 1 if $max - 1 < ~0;
598
599 my $calc_sum;
600 if (ref $total) {
601 $calc_sum = &$total($len);
602 } else {
603 $calc_sum = $total;
604 # Shift into range by some multiple of the total
53f3fd80 605 my $mult = $max_p1 ? int ($total / $max_p1) : undef;
0b568b5f 606 # Need this to make sure that -1 + (~0+1) is ~0 (ie still integer)
607 $calc_sum = $total - $mult;
608 $calc_sum -= $mult * $max;
609 if ($calc_sum < 0) {
610 $calc_sum += 1;
611 $calc_sum += $max;
612 }
613 }
614 if ($calc_sum == $calc_sum - 1 && $calc_sum == $max_p1) {
615 # we're into floating point (either by getting out of the range of
28be1210 616 # UV arithmetic, or because we're doing a floating point checksum)
0b568b5f 617 # and our calculation of the checksum has become rounded up to
618 # max_checksum + 1
619 $calc_sum = 0;
620 }
621
0dccb3d1 622 if ($calc_sum == $sum) { # HAS to be ==, not eq (so no is()).
96b96e00 623 pass ("unpack '%$_$format' gave $sum");
0b568b5f 624 } else {
625 my $delta = 1.000001;
626 if ($format =~ tr /dDfF//
627 && ($calc_sum <= $sum * $delta && $calc_sum >= $sum / $delta)) {
0dccb3d1 628 pass ("unpack '%$_$format' gave $sum, expected $calc_sum");
0b568b5f 629 } else {
630 my $text = ref $total ? &$total($len) : $total;
631 fail;
632 print "# For list (" . join (", ", @_) . ") (total $text)"
633 . " packed with $format unpack '%$_$format' gave $sum,"
634 . " expected $calc_sum\n";
635 }
636 }
fa8ec7c1 637 }
96b96e00 638 }
2e821511 639 }
640}
641
fa8ec7c1 642numbers ('c', -128, -1, 0, 1, 127);
643numbers ('C', 0, 1, 127, 128, 255);
f337b084 644numbers ('W', 0, 1, 127, 128, 255, 256, 0x7ff, 0x800, 0xfffd);
fa8ec7c1 645numbers ('s', -32768, -1, 0, 1, 32767);
646numbers ('S', 0, 1, 32767, 32768, 65535);
647numbers ('i', -2147483648, -1, 0, 1, 2147483647);
648numbers ('I', 0, 1, 2147483647, 2147483648, 4294967295);
649numbers ('l', -2147483648, -1, 0, 1, 2147483647);
650numbers ('L', 0, 1, 2147483647, 2147483648, 4294967295);
651numbers ('s!', -32768, -1, 0, 1, 32767);
652numbers ('S!', 0, 1, 32767, 32768, 65535);
653numbers ('i!', -2147483648, -1, 0, 1, 2147483647);
654numbers ('I!', 0, 1, 2147483647, 2147483648, 4294967295);
655numbers ('l!', -2147483648, -1, 0, 1, 2147483647);
656numbers ('L!', 0, 1, 2147483647, 2147483648, 4294967295);
657numbers ('n', 0, 1, 32767, 32768, 65535);
658numbers ('v', 0, 1, 32767, 32768, 65535);
659numbers ('N', 0, 1, 2147483647, 2147483648, 4294967295);
660numbers ('V', 0, 1, 2147483647, 2147483648, 4294967295);
068bd2e7 661numbers ('n!', -32768, -1, 0, 1, 32767);
662numbers ('v!', -32768, -1, 0, 1, 32767);
663numbers ('N!', -2147483648, -1, 0, 1, 2147483647);
664numbers ('V!', -2147483648, -1, 0, 1, 2147483647);
fa8ec7c1 665# All these should have exact binary representations:
666numbers ('f', -1, 0, 0.5, 42, 2**34);
b85d93de 667numbers ('d', -(2**34), -1, 0, 1, 2**34);
668## These don't, but 'd' is NV. XXX wrong, it's double
669#numbers ('d', -1, 0, 1, 1-exp(-1), -exp(1));
fa8ec7c1 670
671numbers_with_total ('q', -1,
672 -9223372036854775808, -1, 0, 1,9223372036854775807);
800e6488 673# This total is icky, but the true total is 2**65-1, and need a way to generate
674# the epxected checksum on any system including those where NVs can preserve
675# 65 bits. (long double is 128 bits on sparc, so they certainly can)
676# or where rounding is down not up on binary conversion (crays)
677numbers_with_total ('Q', sub {
678 my $len = shift;
679 $len = 65 if $len > 65; # unmasked total is 2**65-1 here
680 my $total = 1 + 2 * (int (2**($len - 1)) - 1);
681 return 0 if $total == $total - 1; # Overflowed integers
682 return $total; # NVs still accurate to nearest integer
683 },
fa8ec7c1 684 0, 1,9223372036854775807, 9223372036854775808,
685 18446744073709551615);
686
40837afc 687print "# pack nvNV byteorders\n";
fa8ec7c1 688
0b568b5f 689is(pack("n", 0xdead), "\xde\xad");
690is(pack("v", 0xdead), "\xad\xde");
691is(pack("N", 0xdeadbeef), "\xde\xad\xbe\xef");
692is(pack("V", 0xdeadbeef), "\xef\xbe\xad\xde");
43192e07 693
d9db00a6 694SKIP: {
695 skip $no_signedness, 4 if $no_signedness;
696 is(pack("n!", 0xdead), "\xde\xad");
697 is(pack("v!", 0xdead), "\xad\xde");
698 is(pack("N!", 0xdeadbeef), "\xde\xad\xbe\xef");
699 is(pack("V!", 0xdeadbeef), "\xef\xbe\xad\xde");
700}
068bd2e7 701
1109a392 702print "# test big-/little-endian conversion\n";
703
704sub byteorder
705{
706 my $format = shift;
707 print "# byteorder test for $format\n";
708 for my $value (@_) {
709 SKIP: {
710 my($nat,$be,$le) = eval { map { pack $format.$_, $value } '', '>', '<' };
711 skip "cannot pack '$format' on this perl", 5
712 if is_valid_error($@);
713
90d0f5d9 714 {
715 use warnings qw(NONFATAL utf8);
716 print "# [$value][$nat][$be][$le][$@]\n";
717 }
1109a392 718
719 SKIP: {
720 skip "cannot compare native byteorder with big-/little-endian", 1
721 if $ByteOrder eq 'unknown';
722
723 is($nat, $ByteOrder eq 'big' ? $be : $le);
724 }
725 is($be, reverse($le));
726 my @x = eval { unpack "$format$format>$format<", $nat.$be.$le };
727
728 print "# [$value][", join('][', @x), "][$@]\n";
729
730 is($@, '');
731 is($x[0], $x[1]);
732 is($x[0], $x[2]);
733 }
734 }
735}
736
737byteorder('s', -32768, -1, 0, 1, 32767);
738byteorder('S', 0, 1, 32767, 32768, 65535);
739byteorder('i', -2147483648, -1, 0, 1, 2147483647);
740byteorder('I', 0, 1, 2147483647, 2147483648, 4294967295);
741byteorder('l', -2147483648, -1, 0, 1, 2147483647);
742byteorder('L', 0, 1, 2147483647, 2147483648, 4294967295);
743byteorder('j', -2147483648, -1, 0, 1, 2147483647);
744byteorder('J', 0, 1, 2147483647, 2147483648, 4294967295);
745byteorder('s!', -32768, -1, 0, 1, 32767);
746byteorder('S!', 0, 1, 32767, 32768, 65535);
747byteorder('i!', -2147483648, -1, 0, 1, 2147483647);
748byteorder('I!', 0, 1, 2147483647, 2147483648, 4294967295);
749byteorder('l!', -2147483648, -1, 0, 1, 2147483647);
750byteorder('L!', 0, 1, 2147483647, 2147483648, 4294967295);
751byteorder('q', -9223372036854775808, -1, 0, 1, 9223372036854775807);
752byteorder('Q', 0, 1, 9223372036854775807, 9223372036854775808, 18446744073709551615);
753byteorder('f', -1, 0, 0.5, 42, 2**34);
754byteorder('F', -1, 0, 0.5, 42, 2**34);
755byteorder('d', -(2**34), -1, 0, 1, 2**34);
756byteorder('D', -(2**34), -1, 0, 1, 2**34);
757
758print "# test negative numbers\n";
759
760SKIP: {
761 skip "platform is not using two's complement for negative integers", 120
762 unless $IsTwosComplement;
763
764 for my $format (qw(s i l j s! i! l! q)) {
765 SKIP: {
766 my($nat,$be,$le) = eval { map { pack $format.$_, -1 } '', '>', '<' };
767 skip "cannot pack '$format' on this perl", 15
768 if is_valid_error($@);
769
770 my $len = length $nat;
771 is($_, "\xFF"x$len) for $nat, $be, $le;
772
773 my(@val,@ref);
774 if ($len >= 8) {
775 @val = (-2, -81985529216486896, -9223372036854775808);
776 @ref = ("\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFE",
777 "\xFE\xDC\xBA\x98\x76\x54\x32\x10",
778 "\x80\x00\x00\x00\x00\x00\x00\x00");
779 }
780 elsif ($len >= 4) {
781 @val = (-2, -19088744, -2147483648);
782 @ref = ("\xFF\xFF\xFF\xFE",
783 "\xFE\xDC\xBA\x98",
784 "\x80\x00\x00\x00");
785 }
786 else {
787 @val = (-2, -292, -32768);
788 @ref = ("\xFF\xFE",
789 "\xFE\xDC",
790 "\x80\x00");
791 }
792 for my $x (@ref) {
793 if ($len > length $x) {
794 $x = $x . "\xFF" x ($len - length $x);
795 }
796 }
797
798 for my $i (0 .. $#val) {
799 my($nat,$be,$le) = eval { map { pack $format.$_, $val[$i] } '', '>', '<' };
800 is($@, '');
801
802 SKIP: {
803 skip "cannot compare native byteorder with big-/little-endian", 1
804 if $ByteOrder eq 'unknown';
805
806 is($nat, $ByteOrder eq 'big' ? $be : $le);
807 }
808
809 is($be, $ref[$i]);
810 is($be, reverse($le));
811 }
812 }
813 }
814}
815
fa8ec7c1 816{
817 # /
818
819 my ($x, $y, $z);
820 eval { ($x) = unpack '/a*','hello' };
49704364 821 like($@, qr!'/' must follow a numeric type!);
72b034c3 822 undef $x;
823 eval { $x = unpack '/a*','hello' };
49704364 824 like($@, qr!'/' must follow a numeric type!);
0b568b5f 825
72b034c3 826 undef $x;
fa8ec7c1 827 eval { ($z,$x,$y) = unpack 'a3/A C/a* C/Z', "003ok \003yes\004z\000abc" };
0b568b5f 828 is($@, '');
829 is($z, 'ok');
830 is($x, 'yes');
831 is($y, 'z');
72b034c3 832 undef $z;
833 eval { $z = unpack 'a3/A C/a* C/Z', "003ok \003yes\004z\000abc" };
834 is($@, '');
835 is($z, 'ok');
836
fa8ec7c1 837
72b034c3 838 undef $x;
fa8ec7c1 839 eval { ($x) = pack '/a*','hello' };
49704364 840 like($@, qr!Invalid type '/'!);
72b034c3 841 undef $x;
842 eval { $x = pack '/a*','hello' };
49704364 843 like($@, qr!Invalid type '/'!);
fa8ec7c1 844
845 $z = pack 'n/a* N/Z* w/A*','string','hi there ','etc';
846 my $expect = "\000\006string\0\0\0\012hi there \000\003etc";
0b568b5f 847 is($z, $expect);
4b5b2118 848
72b034c3 849 undef $x;
b85d93de 850 $expect = 'hello world';
851 eval { ($x) = unpack ("w/a", chr (11) . "hello world!")};
0b568b5f 852 is($x, $expect);
853 is($@, '');
854
72b034c3 855 undef $x;
b85d93de 856 # Doing this in scalar context used to fail.
857 eval { $x = unpack ("w/a", chr (11) . "hello world!")};
0b568b5f 858 is($@, '');
859 is($x, $expect);
b85d93de 860
fa8ec7c1 861 foreach (
0b568b5f 862 ['a/a*/a*', '212ab345678901234567','ab3456789012'],
863 ['a/a*/a*', '3012ab345678901234567', 'ab3456789012'],
864 ['a/a*/b*', '212ab', $Is_EBCDIC ? '100000010100' : '100001100100'],
28be1210 865 )
0b568b5f 866 {
fa8ec7c1 867 my ($pat, $in, $expect) = @$_;
72b034c3 868 undef $x;
fa8ec7c1 869 eval { ($x) = unpack $pat, $in };
0b568b5f 870 is($@, '');
28be1210 871 is($x, $expect) ||
0b568b5f 872 printf "# list unpack ('$pat', '$in') gave %s, expected '$expect'\n",
873 encode_list ($x);
874
72b034c3 875 undef $x;
b85d93de 876 eval { $x = unpack $pat, $in };
0b568b5f 877 is($@, '');
878 is($x, $expect) ||
879 printf "# scalar unpack ('$pat', '$in') gave %s, expected '$expect'\n",
880 encode_list ($x);
fa8ec7c1 881 }
4b5b2118 882
0b568b5f 883 # / with #
17f4a12d 884
72b034c3 885 my $pattern = <<'EOU';
17f4a12d 886 a3/A # Count in ASCII
887 C/a* # Count in a C char
888 C/Z # Count in a C char but skip after \0
889EOU
17f4a12d 890
72b034c3 891 $x = $y = $z =undef;
892 eval { ($z,$x,$y) = unpack $pattern, "003ok \003yes\004z\000abc" };
0b568b5f 893 is($@, '');
894 is($z, 'ok');
895 is($x, 'yes');
896 is($y, 'z');
72b034c3 897 undef $x;
898 eval { $z = unpack $pattern, "003ok \003yes\004z\000abc" };
899 is($@, '');
900 is($z, 'ok');
0b568b5f 901
72b034c3 902 $pattern = <<'EOP';
17f4a12d 903 n/a* # Count as network short
904 w/A* # Count a BER integer
905EOP
fa8ec7c1 906 $expect = "\000\006string\003etc";
72b034c3 907 $z = pack $pattern,'string','etc';
9e17a6b8 908 is($z, $expect);
fa8ec7c1 909}
910
60a99fa7 911
912SKIP: {
913 skip("(EBCDIC and) version strings are bad idea", 2) if $Is_EBCDIC;
914
915 is("1.20.300.4000", sprintf "%vd", pack("U*",1,20,300,4000));
916 is("1.20.300.4000", sprintf "%vd", pack(" U*",1,20,300,4000));
917}
0b568b5f 918isnt(v1.20.300.4000, sprintf "%vd", pack("C0U*",1,20,300,4000));
fa8ec7c1 919
0b568b5f 920my $rslt = $Is_EBCDIC ? "156 67" : "199 162";
921is(join(" ", unpack("C*", chr(0x1e2))), $rslt);
fa8ec7c1 922
923# does pack U create Unicode?
0b568b5f 924is(ord(pack('U', 300)), 300);
fa8ec7c1 925
926# does unpack U deref Unicode?
0b568b5f 927is((unpack('U', chr(300)))[0], 300);
fa8ec7c1 928
929# is unpack U the reverse of pack U for Unicode string?
0b568b5f 930is("@{[unpack('U*', pack('U*', 100, 200, 300))]}", "100 200 300");
fa8ec7c1 931
932# is unpack U the reverse of pack U for byte string?
0b568b5f 933is("@{[unpack('U*', pack('U*', 100, 200))]}", "100 200");
934
935
936SKIP: {
937 skip "Not for EBCDIC", 4 if $Is_EBCDIC;
fa8ec7c1 938
7eed2ccc 939 # does unpack C unravel pack U?
0b568b5f 940 is("@{[unpack('C*', pack('U*', 100, 200))]}", "100 195 136");
fa8ec7c1 941
7eed2ccc 942 # does pack U0C create Unicode?
0b568b5f 943 is("@{[pack('U0C*', 100, 195, 136)]}", v100.v200);
fa8ec7c1 944
7eed2ccc 945 # does pack C0U create characters?
0b568b5f 946 is("@{[pack('C0U*', 100, 200)]}", pack("C*", 100, 195, 136));
fa8ec7c1 947
2dcec3fe 948 # does unpack U0U on byte data warn?
949 {
bd7d4f4d 950 use warnings qw(NONFATAL all);;
951
08ca2aa3 952 my $bad = pack("U0C", 255);
2dcec3fe 953 local $SIG{__WARN__} = sub { $@ = "@_" };
08ca2aa3 954 my @null = unpack('U0U', $bad);
1109a392 955 like($@, qr/^Malformed UTF-8 character /);
2dcec3fe 956 }
35bcd338 957}
958
fa8ec7c1 959{
960 my $p = pack 'i*', -2147483648, ~0, 0, 1, 2147483647;
961 my (@a);
962 # bug - % had to be at the start of the pattern, no leading whitespace or
963 # comments. %i! didn't work at all.
964 foreach my $pat ('%32i*', ' %32i*', "# Muhahahaha\n%32i*", '%32i* ',
965 '%32i!*', ' %32i!*', "\n#\n#\n\r \t\f%32i!*", '%32i!*#') {
966 @a = unpack $pat, $p;
0b568b5f 967 is($a[0], 0xFFFFFFFF) || print "# $pat\n";
fa8ec7c1 968 @a = scalar unpack $pat, $p;
0b568b5f 969 is($a[0], 0xFFFFFFFF) || print "# $pat\n";
fa8ec7c1 970 }
971
972
973 $p = pack 'I*', 42, 12;
974 # Multiline patterns in scalar context failed.
975 foreach my $pat ('I', <<EOPOEMSNIPPET, 'I#I', 'I # I', 'I # !!!') {
976# On the Ning Nang Nong
977# Where the Cows go Bong!
978# And the Monkeys all say Boo!
979I
980EOPOEMSNIPPET
0b568b5f 981 @a = unpack $pat, $p;
982 is(scalar @a, 1);
983 is($a[0], 42);
984 @a = scalar unpack $pat, $p;
985 is(scalar @a, 1);
986 is($a[0], 42);
987 }
fa8ec7c1 988
989 # shorts (of all flavours) didn't calculate checksums > 32 bits with floating
990 # point, so a pathologically long pattern would wrap at 32 bits.
991 my $pat = "\xff\xff"x65538; # Start with it long, to save any copying.
992 foreach (4,3,2,1,0) {
993 my $len = 65534 + $_;
0b568b5f 994 is(unpack ("%33n$len", $pat), 65535 * $len);
fa8ec7c1 995 }
996}
b85d93de 997
998
999# pack x X @
1000foreach (
0b568b5f 1001 ['x', "N", "\0"],
1002 ['x4', "N", "\0"x4],
1003 ['xX', "N", ""],
1004 ['xXa*', "Nick", "Nick"],
1005 ['a5Xa5', "cameL", "llama", "camellama"],
1006 ['@4', 'N', "\0"x4],
1007 ['a*@8a*', 'Camel', 'Dromedary', "Camel\0\0\0Dromedary"],
1008 ['a*@4a', 'Perl rules', '!', 'Perl!'],
28be1210 1009)
0b568b5f 1010{
b85d93de 1011 my ($template, @in) = @$_;
1012 my $out = pop @in;
1013 my $got = eval {pack $template, @in};
0b568b5f 1014 is($@, '');
1015 is($out, $got) ||
1016 printf "# pack ('$template', %s) gave %s expected %s\n",
1017 encode_list (@in), encode_list ($got), encode_list ($out);
b85d93de 1018}
1019
1020# unpack x X @
1021foreach (
0b568b5f 1022 ['x', "N"],
1023 ['xX', "N"],
1024 ['xXa*', "Nick", "Nick"],
1025 ['a5Xa5', "camellama", "camel", "llama"],
1026 ['@3', "ice"],
1027 ['@2a2', "water", "te"],
1028 ['a*@1a3', "steam", "steam", "tea"],
28be1210 1029)
0b568b5f 1030{
b85d93de 1031 my ($template, $in, @out) = @$_;
1032 my @got = eval {unpack $template, $in};
0b568b5f 1033 is($@, '');
c8f824eb 1034 ok (list_eq (\@got, \@out)) ||
9e17a6b8 1035 printf "# list unpack ('$template', %s) gave %s expected %s\n",
1036 _qq($in), encode_list (@got), encode_list (@out);
b85d93de 1037
1038 my $got = eval {unpack $template, $in};
0b568b5f 1039 is($@, '');
1040 @out ? is( $got, $out[0] ) # 1 or more items; should get first
1041 : ok( !defined $got ) # 0 items; should get undef
9e17a6b8 1042 or printf "# scalar unpack ('$template', %s) gave %s expected %s\n",
1043 _qq($in), encode_list ($got), encode_list ($out[0]);
b85d93de 1044}
d50dd4e4 1045
1046{
d50dd4e4 1047 my $t = 'Z*Z*';
1048 my ($u, $v) = qw(foo xyzzy);
1049 my $p = pack($t, $u, $v);
1050 my @u = unpack($t, $p);
0b568b5f 1051 is(scalar @u, 2);
1052 is($u[0], $u);
1053 is($u[1], $v);
d50dd4e4 1054}
bf80f5a2 1055
1056{
0b568b5f 1057 is((unpack("w/a*", "\x02abc"))[0], "ab");
bf80f5a2 1058
0b568b5f 1059 # "w/a*" should be seen as one unit
bf80f5a2 1060
0b568b5f 1061 is(scalar unpack("w/a*", "\x02abc"), "ab");
bf80f5a2 1062}
b81060d6 1063
d9db00a6 1064SKIP: {
66c611c5 1065 print "# group modifiers\n";
1066
d9db00a6 1067 skip $no_endianness, 3 * 2 + 3 * 2 + 1 if $no_endianness;
1068
66c611c5 1069 for my $t (qw{ (s<)< (sl>s)> (s(l(sl)<l)s)< }) {
1070 print "# testing pattern '$t'\n";
1071 eval { ($_) = unpack($t, 'x'x18); };
1072 is($@, '');
1073 eval { $_ = pack($t, (0)x6); };
1074 is($@, '');
1075 }
1076
1077 for my $t (qw{ (s<)> (sl>s)< (s(l(sl)<l)s)> }) {
1078 print "# testing pattern '$t'\n";
1079 eval { ($_) = unpack($t, 'x'x18); };
1080 like($@, qr/Can't use '[<>]' in a group with different byte-order in unpack/);
1081 eval { $_ = pack($t, (0)x6); };
1082 like($@, qr/Can't use '[<>]' in a group with different byte-order in pack/);
1083 }
1084
d9db00a6 1085 is(pack('L<L>', (0x12345678)x2),
1086 pack('(((L1)1)<)(((L)1)1)>1', (0x12345678)x2));
1087}
1088
1089{
66c611c5 1090 sub compress_template {
1091 my $t = shift;
1092 for my $mod (qw( < > )) {
1093 $t =~ s/((?:(?:[SILQJFDP]!?$mod|[^SILQJFDP\W]!?)(?:\d+|\*|\[(?:[^]]+)\])?\/?){2,})/
1094 my $x = $1; $x =~ s!$mod!!g ? "($x)$mod" : $x /ieg;
1095 }
1096 return $t;
1097 }
1098
66c611c5 1099 my %templates = (
1100 's<' => [-42],
1101 's<c2x![S]S<' => [-42, -11, 12, 4711],
1102 '(i<j<[s]l<)3' => [-11, -22, -33, 1000000, 1100, 2201, 3302,
1103 -1000000, 32767, -32768, 1, -123456789 ],
1104 '(I!<4(J<2L<)3)5' => [1 .. 65],
1105 'q<Q<' => [-50000000005, 60000000006],
1106 'f<F<d<' => [3.14159, 111.11, 2222.22],
1107 'D<cCD<' => [1e42, -128, 255, 1e-42],
1108 'n/a*' => ['/usr/bin/perl'],
1109 'C/a*S</A*L</Z*I</a*' => [qw(Just another Perl hacker)],
1110 );
1111
1112 for my $tle (sort keys %templates) {
1113 my @d = @{$templates{$tle}};
1114 my $tbe = $tle;
1115 $tbe =~ y/</>/;
1116 for my $t ($tbe, $tle) {
1117 my $c = compress_template($t);
1118 print "# '$t' -> '$c'\n";
1119 SKIP: {
1120 my $p1 = eval { pack $t, @d };
1121 skip "cannot pack '$t' on this perl", 5 if is_valid_error($@);
1122 my $p2 = eval { pack $c, @d };
1123 is($@, '');
1124 is($p1, $p2);
1125 s!(/[aAZ])\*!$1!g for $t, $c;
1126 my @u1 = eval { unpack $t, $p1 };
1127 is($@, '');
1128 my @u2 = eval { unpack $c, $p2 };
1129 is($@, '');
1130 is(join('!', @u1), join('!', @u2));
1131 }
1132 }
1133 }
1134}
1135
1136{
b81060d6 1137 # from Wolfgang Laun: fix in change #13163
1138
1139 my $s = 'ABC' x 10;
644d52eb 1140 my $t = '*';
1141 my $x = ord($t);
b81060d6 1142 my $buf = pack( 'Z*/A* C', $s, $x );
1143 my $y;
1144
1145 my $h = $buf;
1146 $h =~ s/[^[:print:]]/./g;
1147 ( $s, $y ) = unpack( "Z*/A* C", $buf );
644d52eb 1148 is($h, "30.ABCABCABCABCABCABCABCABCABCABC$t");
0b568b5f 1149 is(length $buf, 34);
1150 is($s, "ABCABCABCABCABCABCABCABCABCABC");
644d52eb 1151 is($y, $x);
b81060d6 1152}
3bf38418 1153
1154{
b223308b 1155 # from Wolfgang Laun: fix in change #13288
3bf38418 1156
b223308b 1157 eval { my $t=unpack("P*", "abc") };
49704364 1158 like($@, qr/'P' must have an explicit size/);
3bf38418 1159}
18529408 1160
1161{ # Grouping constructs
1162 my (@a, @b);
1163 @a = unpack '(SL)', pack 'SLSLSL', 67..90;
1164 is("@a", "67 68");
1165 @a = unpack '(SL)3', pack 'SLSLSL', 67..90;
1166 @b = (67..72);
1167 is("@a", "@b");
1168 @a = unpack '(SL)3', pack 'SLSLSLSL', 67..90;
1169 is("@a", "@b");
1170 @a = unpack '(SL)[3]', pack 'SLSLSLSL', 67..90;
1171 is("@a", "@b");
1172 @a = unpack '(SL)[2] SL', pack 'SLSLSLSL', 67..90;
1173 is("@a", "@b");
1174 @a = unpack 'A/(SL)', pack 'ASLSLSLSL', 3, 67..90;
1175 is("@a", "@b");
1176 @a = unpack 'A/(SL)SL', pack 'ASLSLSLSL', 2, 67..90;
1177 is("@a", "@b");
1178 @a = unpack '(SL)*', pack 'SLSLSLSL', 67..90;
1179 @b = (67..74);
1180 is("@a", "@b");
1181 @a = unpack '(SL)*SL', pack 'SLSLSLSL', 67..90;
1182 is("@a", "@b");
1183 eval { @a = unpack '(*SL)', '' };
1184 like($@, qr/\(\)-group starts with a count/);
1185 eval { @a = unpack '(3SL)', '' };
1186 like($@, qr/\(\)-group starts with a count/);
1187 eval { @a = unpack '([3]SL)', '' };
1188 like($@, qr/\(\)-group starts with a count/);
1189 eval { @a = pack '(*SL)' };
1190 like($@, qr/\(\)-group starts with a count/);
1191 @a = unpack '(SL)3 SL', pack '(SL)4', 67..74;
1192 is("@a", "@b");
1193 @a = unpack '(SL)3 SL', pack '(SL)[4]', 67..74;
1194 is("@a", "@b");
1195 @a = unpack '(SL)3 SL', pack '(SL)*', 67..74;
1196 is("@a", "@b");
1197}
206947d2 1198
49704364 1199{ # more on grouping (W.Laun)
49704364 1200 # @ absolute within ()-group
1201 my $badc = pack( '(a)*', unpack( '(@1a @0a @2)*', 'abcd' ) );
1202 is( $badc, 'badc' );
1203 my @b = ( 1, 2, 3 );
1204 my $buf = pack( '(@1c)((@2C)@3c)', @b );
1205 is( $buf, "\0\1\0\0\2\3" );
1206 my @a = unpack( '(@1c)((@2c)@3c)', $buf );
1207 is( "@a", "@b" );
1208
28be1210 1209 # various unpack count/code scenarios
49704364 1210 my @Env = ( a => 'AAA', b => 'BBB' );
1211 my $env = pack( 'S(S/A*S/A*)*', @Env/2, @Env );
1212
1213 # unpack full length - ok
1214 my @pup = unpack( 'S/(S/A* S/A*)', $env );
1215 is( "@pup", "@Env" );
1216
1217 # warn when count/code goes beyond end of string
1218 # \0002 \0001 a \0003 AAA \0001 b \0003 BBB
1219 # 2 4 5 7 10 1213
1220 eval { @pup = unpack( 'S/(S/A* S/A*)', substr( $env, 0, 13 ) ) };
1221 like( $@, qr{length/code after end of string} );
28be1210 1222
49704364 1223 # postfix repeat count
1224 $env = pack( '(S/A* S/A*)' . @Env/2, @Env );
1225
1226 # warn when count/code goes beyond end of string
1227 # \0001 a \0003 AAA \0001 b \0003 BBB
1228 # 2 3c 5 8 10 11 13 16
1229 eval { @pup = unpack( '(S/A* S/A*)' . @Env/2, substr( $env, 0, 11 ) ) };
1230 like( $@, qr{length/code after end of string} );
1231
1232 # catch stack overflow/segfault
1233 eval { $_ = pack( ('(' x 105) . 'A' . (')' x 105) ); };
1234 like( $@, qr{Too deeply nested \(\)-groups} );
1235}
1236
1237{ # syntax checks (W.Laun)
bd7d4f4d 1238 use warnings qw(NONFATAL all);;
49704364 1239 my @warning;
1240 local $SIG{__WARN__} = sub {
1241 push( @warning, $_[0] );
1242 };
1243 eval { my $s = pack( 'Ax![4c]A', 1..5 ); };
1244 like( $@, qr{Malformed integer in \[\]} );
1245
1246 eval { my $buf = pack( '(c/*a*)', 'AAA', 'BB' ); };
1247 like( $@, qr{'/' does not take a repeat count} );
1248
1249 eval { my @inf = unpack( 'c/1a', "\x03AAA\x02BB" ); };
1250 like( $@, qr{'/' does not take a repeat count} );
1251
1252 eval { my @inf = unpack( 'c/*a', "\x03AAA\x02BB" ); };
1253 like( $@, qr{'/' does not take a repeat count} );
1254
28be1210 1255 # white space where possible
49704364 1256 my @Env = ( a => 'AAA', b => 'BBB' );
1257 my $env = pack( ' S ( S / A* S / A* )* ', @Env/2, @Env );
1258 my @pup = unpack( ' S / ( S / A* S / A* ) ', $env );
1259 is( "@pup", "@Env" );
1260
1261 # white space in 4 wrong places
1262 for my $temp ( 'A ![4]', 'A [4]', 'A *', 'A 4' ){
1263 eval { my $s = pack( $temp, 'B' ); };
1264 like( $@, qr{Invalid type } );
1265 }
1266
1267 # warning for commas
1268 @warning = ();
1269 my $x = pack( 'I,A', 4, 'X' );
1270 like( $warning[0], qr{Invalid type ','} );
1271
1272 # comma warning only once
1273 @warning = ();
1274 $x = pack( 'C(C,C)C,C', 65..71 );
1275 like( scalar @warning, 1 );
1276
1277 # forbidden code in []
1278 eval { my $x = pack( 'A[@4]', 'XXXX' ); };
1279 like( $@, qr{Within \[\]-length '\@' not allowed} );
1280
1281 # @ repeat default 1
1282 my $s = pack( 'AA@A', 'A', 'B', 'C' );
1283 my @c = unpack( 'AA@A', $s );
28be1210 1284 is( $s, 'AC' );
1285 is( "@c", "A C C" );
49704364 1286
1287 # no unpack code after /
1288 eval { my @a = unpack( "C/", "\3" ); };
1289 like( $@, qr{Code missing after '/'} );
1290
d9db00a6 1291 SKIP: {
1292 skip $no_endianness, 6 if $no_endianness;
1293
1294 # modifier warnings
1295 @warning = ();
1296 $x = pack "I>>s!!", 47, 11;
1297 ($x) = unpack "I<<l!>!>", 'x'x20;
1298 is(scalar @warning, 5);
1299 like($warning[0], qr/Duplicate modifier '>' after 'I' in pack/);
1300 like($warning[1], qr/Duplicate modifier '!' after 's' in pack/);
1301 like($warning[2], qr/Duplicate modifier '<' after 'I' in unpack/);
1302 like($warning[3], qr/Duplicate modifier '!' after 'l' in unpack/);
1303 like($warning[4], qr/Duplicate modifier '>' after 'l' in unpack/);
1304 }
49704364 1305}
1306
206947d2 1307{ # Repeat count [SUBEXPR]
f337b084 1308 my @codes = qw( x A Z a c C W B b H h s v n S i I l V N L p P f F d
92d41999 1309 s! S! i! I! l! L! j J);
1310 my $G;
206947d2 1311 if (eval { pack 'q', 1 } ) {
1312 push @codes, qw(q Q);
1313 } else {
1109a392 1314 push @codes, qw(s S); # Keep the count the same
206947d2 1315 }
92d41999 1316 if (eval { pack 'D', 1 } ) {
1317 push @codes, 'D';
1318 } else {
1319 push @codes, 'd'; # Keep the count the same
1320 }
206947d2 1321
1109a392 1322 push @codes, map { /^[silqjfdp]/i ? ("$_<", "$_>") : () } @codes;
1323
206947d2 1324 my %val;
1325 @val{@codes} = map { / [Xx] (?{ undef })
1326 | [AZa] (?{ 'something' })
1327 | C (?{ 214 })
f337b084 1328 | W (?{ 8188 })
206947d2 1329 | c (?{ 114 })
1330 | [Bb] (?{ '101' })
1331 | [Hh] (?{ 'b8' })
92d41999 1332 | [svnSiIlVNLqQjJ] (?{ 10111 })
206947d2 1333 | [FfDd] (?{ 1.36514538e67 })
1334 | [pP] (?{ "try this buffer" })
1335 /x; $^R } @codes;
1336 my @end = (0x12345678, 0x23456781, 0x35465768, 0x15263748);
1337 my $end = "N4";
1338
1339 for my $type (@codes) {
1340 my @list = $val{$type};
1341 @list = () unless defined $list[0];
1342 for my $count ('', '3', '[11]') {
1343 my $c = 1;
1344 $c = $1 if $count =~ /(\d+)/;
1345 my @list1 = @list;
1346 @list1 = (@list1) x $c unless $type =~ /[XxAaZBbHhP]/;
1347 for my $groupend ('', ')2', ')[8]') {
1348 my $groupbegin = ($groupend ? '(' : '');
1349 $c = 1;
1350 $c = $1 if $groupend =~ /(\d+)/;
1351 my @list2 = (@list1) x $c;
1352
1109a392 1353 SKIP: {
1354 my $junk1 = "$groupbegin $type$count $groupend";
1355 # print "# junk1=$junk1\n";
1356 my $p = eval { pack $junk1, @list2 };
1357 skip "cannot pack '$type' on this perl", 12
1358 if is_valid_error($@);
9b72c5e4 1359 die "pack $junk1 failed: $@" if $@;
1109a392 1360
1361 my $half = int( (length $p)/2 );
1362 for my $move ('', "X$half", "X!$half", 'x1', 'x!8', "x$half") {
1363 my $junk = "$junk1 $move";
1364 # print "# junk='$junk', list=(@list2)\n";
1365 $p = pack "$junk $end", @list2, @end;
1366 my @l = unpack "x[$junk] $end", $p;
1367 is(scalar @l, scalar @end);
1368 is("@l", "@end", "skipping x[$junk]");
1369 }
1370 }
206947d2 1371 }
1372 }
1373 }
1374}
1375
1376# / is recognized after spaces in scalar context
1377# XXXX no spaces are allowed in pack... In pack only before the slash...
1378is(scalar unpack('A /A Z20', pack 'A/A* Z20', 'bcde', 'xxxxx'), 'bcde');
1379is(scalar unpack('A /A /A Z20', '3004bcde'), 'bcde');
62f95557 1380
1381{ # X! and x!
1382 my $t = 'C[3] x!8 C[2]';
1383 my @a = (0x73..0x77);
1384 my $p = pack($t, @a);
1385 is($p, "\x73\x74\x75\0\0\0\0\0\x76\x77");
1386 my @b = unpack $t, $p;
1387 is(scalar @b, scalar @a);
1388 is("@b", "@a", 'x!8');
1389 $t = 'x[5] C[6] X!8 C[2]';
1390 @a = (0x73..0x7a);
1391 $p = pack($t, @a);
1392 is($p, "\0\0\0\0\0\x73\x74\x75\x79\x7a");
1393 @b = unpack $t, $p;
1394 @a = (0x73..0x75, 0x79, 0x7a, 0x79, 0x7a);
1395 is(scalar @b, scalar @a);
1396 is("@b", "@a");
1397}
1398
1399{ # struct {char c1; double d; char cc[2];}
1400 my $t = 'C x![d] d C[2]';
1401 my @a = (173, 1.283476517e-45, 42, 215);
1402 my $p = pack $t, @a;
1403 ok( length $p);
1404 my @b = unpack "$t X[$t] $t", $p; # Extract, step back, extract again
1405 is(scalar @b, 2 * scalar @a);
3f7e3417 1406 $b = "@b";
1407 $b =~ s/(?:17000+|16999+)\d+(e-45) /17$1 /gi; # stringification is gamble
1408 is($b, "@a @a");
62f95557 1409
bd7d4f4d 1410 use warnings qw(NONFATAL all);;
62f95557 1411 my $warning;
1412 local $SIG{__WARN__} = sub {
1413 $warning = $_[0];
1414 };
1415 @b = unpack "x[C] x[$t] X[$t] X[C] $t", "$p\0";
1416
1417 is($warning, undef);
1418 is(scalar @b, scalar @a);
3f7e3417 1419 $b = "@b";
1420 $b =~ s/(?:17000+|16999+)\d+(e-45) /17$1 /gi; # stringification is gamble
1421 is($b, "@a");
62f95557 1422}
92d41999 1423
1424is(length(pack("j", 0)), $Config{ivsize});
1425is(length(pack("J", 0)), $Config{uvsize});
1426is(length(pack("F", 0)), $Config{nvsize});
1427
1428numbers ('j', -2147483648, -1, 0, 1, 2147483647);
1429numbers ('J', 0, 1, 2147483647, 2147483648, 4294967295);
1430numbers ('F', -(2**34), -1, 0, 1, 2**34);
1431SKIP: {
1432 my $t = eval { unpack("D*", pack("D", 12.34)) };
1433
1109a392 1434 skip "Long doubles not in use", 166 if $@ =~ /Invalid type/;
92d41999 1435
1436 is(length(pack("D", 0)), $Config{longdblsize});
1437 numbers ('D', -(2**34), -1, 0, 1, 2**34);
1438}
1439
c8f824eb 1440# Maybe this knowledge needs to be "global" for all of pack.t
1441# Or a "can checksum" which would effectively be all the number types"
1442my %cant_checksum = map {$_=> 1} qw(A Z u w);
1443# not a b B h H
1444foreach my $template (qw(A Z c C s S i I l L n N v V q Q j J f d F D u U w)) {
1445 SKIP: {
1446 my $packed = eval {pack "${template}4", 1, 4, 9, 16};
1447 if ($@) {
49704364 1448 die unless $@ =~ /Invalid type '$template'/;
c8f824eb 1449 skip ("$template not supported on this perl",
1450 $cant_checksum{$template} ? 4 : 8);
1451 }
1452 my @unpack4 = unpack "${template}4", $packed;
1453 my @unpack = unpack "${template}*", $packed;
1454 my @unpack1 = unpack "${template}", $packed;
1455 my @unpack1s = scalar unpack "${template}", $packed;
1456 my @unpack4s = scalar unpack "${template}4", $packed;
1457 my @unpacks = scalar unpack "${template}*", $packed;
1458
1459 my @tests = ( ["${template}4 vs ${template}*", \@unpack4, \@unpack],
1460 ["scalar ${template} ${template}", \@unpack1s, \@unpack1],
1461 ["scalar ${template}4 vs ${template}", \@unpack4s, \@unpack1],
1462 ["scalar ${template}* vs ${template}", \@unpacks, \@unpack1],
1463 );
1464
1465 unless ($cant_checksum{$template}) {
1466 my @unpack4_c = unpack "\%${template}4", $packed;
1467 my @unpack_c = unpack "\%${template}*", $packed;
1468 my @unpack1_c = unpack "\%${template}", $packed;
1469 my @unpack1s_c = scalar unpack "\%${template}", $packed;
1470 my @unpack4s_c = scalar unpack "\%${template}4", $packed;
1471 my @unpacks_c = scalar unpack "\%${template}*", $packed;
1472
1473 push @tests,
1474 ( ["% ${template}4 vs ${template}*", \@unpack4_c, \@unpack_c],
1475 ["% scalar ${template} ${template}", \@unpack1s_c, \@unpack1_c],
1476 ["% scalar ${template}4 vs ${template}*", \@unpack4s_c, \@unpack_c],
1477 ["% scalar ${template}* vs ${template}*", \@unpacks_c, \@unpack_c],
1478 );
1479 }
1480 foreach my $test (@tests) {
1481 ok (list_eq ($test->[1], $test->[2]), $test->[0]) ||
1482 printf "# unpack gave %s expected %s\n",
1483 encode_list (@{$test->[1]}), encode_list (@{$test->[2]});
1484 }
1485 }
1486}
9c3dc587 1487
1488ok(pack('u2', 'AA'), "[perl #8026]"); # used to hang and eat RAM in perl 5.7.2
1489
fe581ec7 1490$_ = pack('c', 65); # 'A' would not be EBCDIC-friendly
1491is(unpack('c'), 65, "one-arg unpack (change #18751)"); # defaulting to $_
db37a92e 1492
1493{
250d67eb 1494 my $a = "X\x0901234567\n" x 100; # \t would not be EBCDIC TAB
db37a92e 1495 my @a = unpack("(a1 c/a)*", $a);
1496 is(scalar @a, 200, "[perl #15288]");
1497 is($a[-1], "01234567\n", "[perl #15288]");
1498 is($a[-2], "X", "[perl #15288]");
1499}
0ed7c1bb 1500
f7f98fdf 1501{
bd7d4f4d 1502 use warnings qw(NONFATAL all);;
f7f98fdf 1503 my $warning;
1504 local $SIG{__WARN__} = sub {
1505 $warning = $_[0];
1506 };
1507 my $out = pack("u99", "foo" x 99);
1508 like($warning, qr/Field too wide in 'u' format in pack at /,
1509 "Warn about too wide uuencode");
1510 is($out, ("_" . "9F]O" x 21 . "\n") x 4 . "M" . "9F]O" x 15 . "\n",
1511 "Use max width in case of too wide uuencode");
1512}
1513
0ed7c1bb 1514# checksums
1515{
1516 # verify that unpack advances correctly wrt a checksum
1517 my (@x) = unpack("b10a", "abcd");
1518 my (@y) = unpack("%b10a", "abcd");
1519 is($x[1], $y[1], "checksum advance ok");
d6d3e8bd 1520
1521 # verify that the checksum is not overflowed with C0
250d67eb 1522 if (ord('A') == 193) {
1523 is(unpack("C0%128U", "/bcd"), unpack("U0%128U", "abcd"), "checksum not overflowed");
1524 } else {
1525 is(unpack("C0%128U", "abcd"), unpack("U0%128U", "abcd"), "checksum not overflowed");
1526 }
0ed7c1bb 1527}
0c81e54b 1528
1529{
1530 # U0 and C0 must be scoped
1531 my (@x) = unpack("a(U0)U", "b\341\277\274");
1532 is($x[0], 'b', 'before scope');
08ca2aa3 1533 is($x[1], 8188, 'after scope');
f337b084 1534
1535 is(pack("a(U0)U", "b", 8188), "b\341\277\274");
0c81e54b 1536}
21c16052 1537
1538{
1539 # counted length prefixes shouldn't change C0/U0 mode
1540 # (note the length is actually 0 in this test)
250d67eb 1541 if (ord('A') == 193) {
1542 is(join(',', unpack("aU0C/UU", "b\0\341\277\274")), 'b,0');
1543 is(join(',', unpack("aU0C/CU", "b\0\341\277\274")), 'b,0');
1544 } else {
1545 is(join(',', unpack("aC/UU", "b\0\341\277\274")), 'b,8188');
1546 is(join(',', unpack("aC/CU", "b\0\341\277\274")), 'b,8188');
1547 is(join(',', unpack("aU0C/UU", "b\0\341\277\274")), 'b,225');
1548 is(join(',', unpack("aU0C/CU", "b\0\341\277\274")), 'b,225');
1549 }
21c16052 1550}
f0df5f8b 1551
1552{
1553 # "Z0" (bug #34062)
1554 my (@x) = unpack("C*", pack("CZ0", 1, "b"));
1555 is(join(',', @x), '1', 'pack Z0 doesn\'t destroy the character before');
1556}
f337b084 1557
1558{
1559 # Encoding neutrality
1560 # String we will pull apart and rebuild in several ways:
1561 my $down = "\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff\x05\x06";
1562 my $up = $down;
1563 utf8::upgrade($up);
1564
1565 my %expect =
1566 # [expected result,
1567 # how many chars it should progress,
1568 # (optional) expected result of pack]
1569 (a5 => ["\xf8\xf9\xfa\xfb\xfc", 5],
1570 A5 => ["\xf8\xf9\xfa\xfb\xfc", 5],
1571 Z5 => ["\xf8\xf9\xfa\xfb\xfc", 5, "\xf8\xf9\xfa\xfb\x00\xfd"],
1572 b21 => ["000111111001111101011", 3, "\xf8\xf9\x1a\xfb"],
1573 B21 => ["111110001111100111111", 3, "\xf8\xf9\xf8\xfb"],
1574 H5 => ["f8f9f", 3, "\xf8\xf9\xf0\xfb"],
1575 h5 => ["8f9fa", 3, "\xf8\xf9\x0a\xfb"],
1576 "s<" => [-1544, 2],
1577 "s>" => [-1799, 2],
1578 "S<" => [0xf9f8, 2],
1579 "S>" => [0xf8f9, 2],
1580 "l<" => [-67438088, 4],
1581 "l>" => [-117835013, 4],
1582 "L>" => [0xf8f9fafb, 4],
1583 "L<" => [0xfbfaf9f8, 4],
1584 n => [0xf8f9, 2],
1585 N => [0xf8f9fafb, 4],
1586 v => [63992, 2],
1587 V => [0xfbfaf9f8, 4],
1588 c => [-8, 1],
1589 U0U => [0xf8, 1],
1590 w => ["8715569050387726213", 9],
1591 q => ["-283686952306184", 8],
1592 Q => ["18446460386757245432", 8],
1593 );
1594
1595 for my $string ($down, $up) {
1596 for my $format (sort {lc($a) cmp lc($b) || $a cmp $b } keys %expect) {
1597 SKIP: {
1598 my $expect = $expect{$format};
1599 # unpack upgraded and downgraded string
1600 my @result = eval { unpack("$format C0 W", $string) };
1601 skip "cannot pack/unpack '$format C0 W' on this perl", 5 if
1602 $@ && is_valid_error($@);
1603 is(@result, 2, "Two results from unpack $format C0 W");
1604
1605 # pack to downgraded
1606 my $new = pack("$format C0 W", @result);
1607 is(length($new), $expect->[1]+1,
1608 "pack $format C0 W should give $expect->[1]+1 chars");
1609 is($new, $expect->[2] || substr($string, 0, length $new),
1610 "pack $format C0 W returns expected value");
1611
1612 # pack to upgraded
1613 $new = pack("a0 $format C0 W", chr(256), @result);
1614 is(length($new), $expect->[1]+1,
1615 "pack a0 $format C0 W should give $expect->[1]+1 chars");
1616 is($new, $expect->[2] || substr($string, 0, length $new),
1617 "pack a0 $format C0 W returns expected value");
1618 }
1619 }
1620 }
1621}
1622
1623{
1624 # Encoding neutrality, numbers
1625 my $val = -2.68;
1626 for my $format (qw(s S i I l L j J f d F D q Q
1627 s! S! i! I! l! L! n! N! v! V!)) {
1628 SKIP: {
1629 my $down = eval { pack($format, $val) };
1630 skip "cannot pack/unpack $format on this perl", 9 if
1631 $@ && is_valid_error($@);
1632 ok(!utf8::is_utf8($down), "Simple $format pack doesn't get upgraded");
1633 my $up = pack("a0 $format", chr(256), $val);
1634 ok(utf8::is_utf8($up), "a0 $format with high char leads to upgrade");
1635 is($down, $up, "$format generated strings are equal though");
1636 my @down_expanded = unpack("$format W", $down . chr(0xce));
1637 is(@down_expanded, 2, "Expand to two values");
1638 is($down_expanded[1], 0xce,
1639 "unpack $format left us at the expected position");
1640 my @up_expanded = unpack("$format W", $up . chr(0xce));
1641 is(@up_expanded, 2, "Expand to two values");
1642 is($up_expanded[1], 0xce,
1643 "unpack $format left us at the expected position");
1644 is($down_expanded[0], $up_expanded[0], "$format unpack was neutral");
1645 is(pack($format, $down_expanded[0]), $down, "Pack $format undoes unpack $format");
1646 }
1647 }
1648}
1649
1650{
1651 # C is *not* neutral
1652 my $down = "\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff\x05\x06";
1653 my $up = $down;
1654 utf8::upgrade($up);
1655 my @down = unpack("C*", $down);
1656 my @expect_down = (0xf8, 0xf9, 0xfa, 0xfb, 0xfc, 0xfd, 0xfe, 0xff, 0x05, 0x06);
1657 is("@down", "@expect_down", "byte expand");
1658 is(pack("C*", @down), $down, "byte join");
1659
1660 my @up = unpack("C*", $up);
1661 my @expect_up = (0xc3, 0xb8, 0xc3, 0xb9, 0xc3, 0xba, 0xc3, 0xbb, 0xc3, 0xbc, 0xc3, 0xbd, 0xc3, 0xbe, 0xc3, 0xbf, 0x05, 0x06);
1662 is("@up", "@expect_up", "UTF-8 expand");
1663 is(pack("U0C0C*", @up), $up, "UTF-8 join");
1664}
1665
1666{
1667 # Harder cases for the neutrality test
1668
1669 # u format
1670 my $down = "\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff\x05\x06";
1671 my $up = $down;
1672 utf8::upgrade($up);
1673 is(pack("u", $down), pack("u", $up), "u pack is neutral");
1674 is(unpack("u", pack("u", $down)), $down, "u unpack to downgraded works");
1675 is(unpack("U0C0u", pack("u", $down)), $up, "u unpack to upgraded works");
1676
1677 # p/P format
1678 # This actually only tests something if the address contains a byte >= 0x80
1679 my $str = "abc\xa5\x00\xfede";
1680 $down = pack("p", $str);
1681 is(pack("P", $str), $down);
1682 is(pack("U0C0p", $str), $down);
1683 is(pack("U0C0P", $str), $down);
1684 is(unpack("p", $down), "abc\xa5", "unpack p downgraded");
1685 $up = $down;
1686 utf8::upgrade($up);
1687 is(unpack("p", $up), "abc\xa5", "unpack p upgraded");
1688
1689 is(unpack("P7", $down), "abc\xa5\x00\xfed", "unpack P downgraded");
1690 is(unpack("P7", $up), "abc\xa5\x00\xfed", "unpack P upgraded");
1691
1692 # x, X and @
1693 $down = "\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff\x05\x06";
1694 $up = $down;
1695 utf8::upgrade($up);
1696
1697 is(unpack('@4W', $down), 0xfc, "\@positioning on downgraded string");
1698 is(unpack('@4W', $up), 0xfc, "\@positioning on upgraded string");
1699
1700 is(unpack('@4x2W', $down), 0xfe, "x moving on downgraded string");
1701 is(unpack('@4x2W', $up), 0xfe, "x moving on upgraded string");
1702 is(unpack('@4x!4W', $down), 0xfc, "x! moving on downgraded string");
1703 is(unpack('@4x!4W', $up), 0xfc, "x! moving on upgraded string");
1704 is(unpack('@5x!4W', $down), 0x05, "x! moving on downgraded string");
1705 is(unpack('@5x!4W', $up), 0x05, "x! moving on upgraded string");
1706
1707 is(unpack('@4X2W', $down), 0xfa, "X moving on downgraded string");
1708 is(unpack('@4X2W', $up), 0xfa, "X moving on upgraded string");
1709 is(unpack('@4X!4W', $down), 0xfc, "X! moving on downgraded string");
1710 is(unpack('@4X!4W', $up), 0xfc, "X! moving on upgraded string");
1711 is(unpack('@5X!4W', $down), 0xfc, "X! moving on downgraded string");
1712 is(unpack('@5X!4W', $up), 0xfc, "X! moving on upgraded string");
1713 is(unpack('@5X!8W', $down), 0xf8, "X! moving on downgraded string");
1714 is(unpack('@5X!8W', $up), 0xf8, "X! moving on upgraded string");
1715
1716 is(pack("W2x", 0xfa, 0xe3), "\xfa\xe3\x00", "x on downgraded string");
28be1210 1717 is(pack("W2x!4", 0xfa, 0xe3), "\xfa\xe3\x00\x00",
f337b084 1718 "x! on downgraded string");
1719 is(pack("W2x!2", 0xfa, 0xe3), "\xfa\xe3", "x! on downgraded string");
1720 is(pack("U0C0W2x", 0xfa, 0xe3), "\xfa\xe3\x00", "x on upgraded string");
28be1210 1721 is(pack("U0C0W2x!4", 0xfa, 0xe3), "\xfa\xe3\x00\x00",
f337b084 1722 "x! on upgraded string");
1723 is(pack("U0C0W2x!2", 0xfa, 0xe3), "\xfa\xe3", "x! on upgraded string");
1724 is(pack("W2X", 0xfa, 0xe3), "\xfa", "X on downgraded string");
1725 is(pack("U0C0W2X", 0xfa, 0xe3), "\xfa", "X on upgraded string");
1726 is(pack("W2X!2", 0xfa, 0xe3), "\xfa\xe3", "X! on downgraded string");
1727 is(pack("U0C0W2X!2", 0xfa, 0xe3), "\xfa\xe3", "X! on upgraded string");
1728 is(pack("W3X!2", 0xfa, 0xe3, 0xa6), "\xfa\xe3", "X! on downgraded string");
28be1210 1729 is(pack("U0C0W3X!2", 0xfa, 0xe3, 0xa6), "\xfa\xe3",
f337b084 1730 "X! on upgraded string");
1731
1732 # backward eating through a ( moves the group starting point backwards
28be1210 1733 is(pack("a*(Xa)", "abc", "q"), "abq",
f337b084 1734 "eating before strbeg moves it back");
28be1210 1735 is(pack("a*(Xa)", "ab" . chr(512), "q"), "abq",
f337b084 1736 "eating before strbeg moves it back");
1737
1738 # Check marked_upgrade
1739 is(pack('W(W(Wa@3W)@6W)@9W', 0xa1, 0xa2, 0xa3, "a", 0xa4, 0xa5, 0xa6),
1740 "\xa1\xa2\xa3a\x00\xa4\x00\xa5\x00\xa6");
1741 $up = "a";
1742 utf8::upgrade($up);
1743 is(pack('W(W(Wa@3W)@6W)@9W', 0xa1, 0xa2, 0xa3, $up, 0xa4, 0xa5, 0xa6),
1744 "\xa1\xa2\xa3a\x00\xa4\x00\xa5\x00\xa6", "marked upgrade caused by a");
1745 is(pack('W(W(WW@3W)@6W)@9W', 0xa1, 0xa2, 0xa3, 256, 0xa4, 0xa5, 0xa6),
28be1210 1746 "\xa1\xa2\xa3\x{100}\x00\xa4\x00\xa5\x00\xa6",
f337b084 1747 "marked upgrade caused by W");
1748 is(pack('W(W(WU0aC0@3W)@6W)@9W', 0xa1, 0xa2, 0xa3, "a", 0xa4, 0xa5, 0xa6),
1749 "\xa1\xa2\xa3a\x00\xa4\x00\xa5\x00\xa6", "marked upgrade caused by U0");
1750
1751 # a, A and Z
1752 $down = "\xa4\xa6\xa7";
1753 $up = $down;
1754 utf8::upgrade($up);
1755 utf8::upgrade(my $high = "\xfeb");
1756
1757 for my $format ("a0", "A0", "Z0", "U0a0C0", "U0A0C0", "U0Z0C0") {
28be1210 1758 is(pack("a* $format a*", "ab", $down, "cd"), "abcd",
f337b084 1759 "$format format on plain string");
1760 is(pack("a* $format a*", "ab", $up, "cd"), "abcd",
1761 "$format format on upgraded string");
28be1210 1762 is(pack("a* $format a*", $high, $down, "cd"), "\xfebcd",
f337b084 1763 "$format format on plain string");
1764 is(pack("a* $format a*", $high, $up, "cd"), "\xfebcd",
1765 "$format format on upgraded string");
1766 my @down = unpack("a1 $format a*", "\xfeb");
1767 is("@down", "\xfe b", "unpack $format");
1768 my @up = unpack("a1 $format a*", $high);
1769 is("@up", "\xfe b", "unpack $format");
1770 }
1771 is(pack("a1", $high), "\xfe");
1772 is(pack("A1", $high), "\xfe");
1773 is(pack("Z1", $high), "\x00");
1774 is(pack("a2", $high), "\xfeb");
1775 is(pack("A2", $high), "\xfeb");
1776 is(pack("Z2", $high), "\xfe\x00");
1777 is(pack("a5", $high), "\xfeb\x00\x00\x00");
1778 is(pack("A5", $high), "\xfeb ");
1779 is(pack("Z5", $high), "\xfeb\x00\x00\x00");
1780 is(pack("a*", $high), "\xfeb");
1781 is(pack("A*", $high), "\xfeb");
1782 is(pack("Z*", $high), "\xfeb\x00");
1783
1784 utf8::upgrade($high = "\xc3\xbeb");
1785 is(pack("U0a2", $high), "\xfe");
1786 is(pack("U0A2", $high), "\xfe");
1787 is(pack("U0Z1", $high), "\x00");
1788 is(pack("U0a3", $high), "\xfeb");
1789 is(pack("U0A3", $high), "\xfeb");
1790 is(pack("U0Z3", $high), "\xfe\x00");
1791 is(pack("U0a6", $high), "\xfeb\x00\x00\x00");
1792 is(pack("U0A6", $high), "\xfeb ");
1793 is(pack("U0Z6", $high), "\xfeb\x00\x00\x00");
1794 is(pack("U0a*", $high), "\xfeb");
1795 is(pack("U0A*", $high), "\xfeb");
1796 is(pack("U0Z*", $high), "\xfeb\x00");
1797}
246f24af 1798{
1799 # pack /
1800 my @array = 1..14;
1801 my @out = unpack("N/S", pack("N/S", @array) . "abcd");
1802 is("@out", "@array", "pack N/S works");
1803 @out = unpack("N/S*", pack("N/S*", @array) . "abcd");
1804 is("@out", "@array", "pack N/S* works");
1805 @out = unpack("N/S*", pack("N/S14", @array) . "abcd");
1806 is("@out", "@array", "pack N/S14 works");
1807 @out = unpack("N/S*", pack("N/S15", @array) . "abcd");
1808 is("@out", "@array", "pack N/S15 works");
1809 @out = unpack("N/S*", pack("N/S13", @array) . "abcd");
1810 is("@out", "@array[0..12]", "pack N/S13 works");
1811 @out = unpack("N/S*", pack("N/S0", @array) . "abcd");
1812 is("@out", "", "pack N/S0 works");
1813 is(pack("Z*/a0", "abc"), "0\0", "pack Z*/a0 makes a short string");
1814 is(pack("Z*/Z0", "abc"), "0\0", "pack Z*/Z0 makes a short string");
1815 is(pack("Z*/a3", "abc"), "3\0abc", "pack Z*/a3 makes a full string");
1816 is(pack("Z*/Z3", "abc"), "3\0ab\0", "pack Z*/Z3 makes a short string");
1817 is(pack("Z*/a5", "abc"), "5\0abc\0\0", "pack Z*/a5 makes a long string");
1818 is(pack("Z*/Z5", "abc"), "5\0abc\0\0", "pack Z*/Z5 makes a long string");
1819 is(pack("Z*/Z"), "1\0\0", "pack Z*/Z makes an extended string");
1820 is(pack("Z*/Z", ""), "1\0\0", "pack Z*/Z makes an extended string");
1821 is(pack("Z*/a", ""), "0\0", "pack Z*/a makes an extended string");
1822}
18bdf90a 1823{
1824 # unpack("A*", $unicode) strips general unicode spaces
28be1210 1825 is(unpack("A*", "ab \n\xa0 \0"), "ab \n\xa0",
18bdf90a 1826 'normal A* strip leaves \xa0');
28be1210 1827 is(unpack("U0C0A*", "ab \n\xa0 \0"), "ab \n\xa0",
18bdf90a 1828 'normal A* strip leaves \xa0 even if it got upgraded for technical reasons');
1829 is(unpack("A*", pack("a*(U0U)a*", "ab \n", 0xa0, " \0")), "ab",
1830 'upgraded strings A* removes \xa0');
1831 is(unpack("A*", pack("a*(U0UU)a*", "ab \n", 0xa0, 0x1680, " \0")), "ab",
1832 'upgraded strings A* removes all unicode whitespace');
1833 is(unpack("A5", pack("a*(U0U)a*", "ab \n", 0x1680, "def", "ab")), "ab",
1834 'upgraded strings A5 removes all unicode whitespace');
1835 is(unpack("A*", pack("U", 0x1680)), "",
1836 'upgraded strings A* with nothing left');
1837}
28be1210 1838{
1839 # Testing unpack . and .!
1840 is(unpack(".", "ABCD"), 0, "offset at start of string is 0");
1841 is(unpack(".", ""), 0, "offset at start of empty string is 0");
1842 is(unpack("x3.", "ABCDEF"), 3, "simple offset works");
1843 is(unpack("x3.", "ABC"), 3, "simple offset at end of string works");
1844 is(unpack("x3.0", "ABC"), 0, "self offset is 0");
1845 is(unpack("x3(x2.)", "ABCDEF"), 2, "offset is relative to inner group");
1846 is(unpack("x3(X2.)", "ABCDEF"), -2,
1847 "negative offset relative to inner group");
1848 is(unpack("x3(X2.2)", "ABCDEF"), 1, "offset is relative to inner group");
1849 is(unpack("x3(x2.0)", "ABCDEF"), 0, "self offset in group is still 0");
1850 is(unpack("x3(x2.2)", "ABCDEF"), 5, "offset counts groups");
1851 is(unpack("x3(x2.*)", "ABCDEF"), 5, "star offset is relative to start");
1852
1853 my $high = chr(8188) x 6;
1854 is(unpack("x3(x2.)", $high), 2, "utf8 offset is relative to inner group");
1855 is(unpack("x3(X2.)", $high), -2,
1856 "utf8 negative offset relative to inner group");
1857 is(unpack("x3(X2.2)", $high), 1, "utf8 offset counts groups");
1858 is(unpack("x3(x2.0)", $high), 0, "utf8 self offset in group is still 0");
1859 is(unpack("x3(x2.2)", $high), 5, "utf8 offset counts groups");
1860 is(unpack("x3(x2.*)", $high), 5, "utf8 star offset is relative to start");
1861
1862 is(unpack("U0x3(x2.)", $high), 2,
1863 "U0 mode utf8 offset is relative to inner group");
1864 is(unpack("U0x3(X2.)", $high), -2,
1865 "U0 mode utf8 negative offset relative to inner group");
1866 is(unpack("U0x3(X2.2)", $high), 1,
1867 "U0 mode utf8 offset counts groups");
1868 is(unpack("U0x3(x2.0)", $high), 0,
1869 "U0 mode utf8 self offset in group is still 0");
1870 is(unpack("U0x3(x2.2)", $high), 5,
1871 "U0 mode utf8 offset counts groups");
1872 is(unpack("U0x3(x2.*)", $high), 5,
1873 "U0 mode utf8 star offset is relative to start");
1874
1875 is(unpack("x3(x2.!)", $high), 2*3,
1876 "utf8 offset is relative to inner group");
1877 is(unpack("x3(X2.!)", $high), -2*3,
1878 "utf8 negative offset relative to inner group");
1879 is(unpack("x3(X2.!2)", $high), 1*3,
1880 "utf8 offset counts groups");
1881 is(unpack("x3(x2.!0)", $high), 0,
1882 "utf8 self offset in group is still 0");
1883 is(unpack("x3(x2.!2)", $high), 5*3,
1884 "utf8 offset counts groups");
1885 is(unpack("x3(x2.!*)", $high), 5*3,
1886 "utf8 star offset is relative to start");
1887
1888 is(unpack("U0x3(x2.!)", $high), 2,
1889 "U0 mode utf8 offset is relative to inner group");
1890 is(unpack("U0x3(X2.!)", $high), -2,
1891 "U0 mode utf8 negative offset relative to inner group");
1892 is(unpack("U0x3(X2.!2)", $high), 1,
1893 "U0 mode utf8 offset counts groups");
1894 is(unpack("U0x3(x2.!0)", $high), 0,
1895 "U0 mode utf8 self offset in group is still 0");
1896 is(unpack("U0x3(x2.!2)", $high), 5,
1897 "U0 mode utf8 offset counts groups");
1898 is(unpack("U0x3(x2.!*)", $high), 5,
1899 "U0 mode utf8 star offset is relative to start");
1900}
1901{
1902 # Testing pack . and .!
1903 is(pack("(a)5 .", 1..5, 3), "123", ". relative to string start, shorten");
1904 eval { () = pack("(a)5 .", 1..5, -3) };
1905 like($@, qr{'\.' outside of string in pack}, "Proper error message");
1906 is(pack("(a)5 .", 1..5, 8), "12345\x00\x00\x00",
1907 ". relative to string start, extend");
1908 is(pack("(a)5 .", 1..5, 5), "12345", ". relative to string start, keep");
1909
1910 is(pack("(a)5 .0", 1..5, -3), "12",
1911 ". relative to string current, shorten");
1912 is(pack("(a)5 .0", 1..5, 2), "12345\x00\x00",
1913 ". relative to string current, extend");
1914 is(pack("(a)5 .0", 1..5, 0), "12345",
1915 ". relative to string current, keep");
1916
1917 is(pack("(a)5 (.)", 1..5, -3), "12",
1918 ". relative to group, shorten");
1919 is(pack("(a)5 (.)", 1..5, 2), "12345\x00\x00",
1920 ". relative to group, extend");
1921 is(pack("(a)5 (.)", 1..5, 0), "12345",
1922 ". relative to group, keep");
1923
1924 is(pack("(a)3 ((a)2 .)", 1..5, -2), "1",
1925 ". relative to group, shorten");
1926 is(pack("(a)3 ((a)2 .)", 1..5, 2), "12345",
1927 ". relative to group, keep");
1928 is(pack("(a)3 ((a)2 .)", 1..5, 4), "12345\x00\x00",
1929 ". relative to group, extend");
1930
1931 is(pack("(a)3 ((a)2 .2)", 1..5, 2), "12",
1932 ". relative to counted group, shorten");
1933 is(pack("(a)3 ((a)2 .2)", 1..5, 7), "12345\x00\x00",
1934 ". relative to counted group, extend");
1935 is(pack("(a)3 ((a)2 .2)", 1..5, 5), "12345",
1936 ". relative to counted group, keep");
1937
1938 is(pack("(a)3 ((a)2 .*)", 1..5, 2), "12",
1939 ". relative to start, shorten");
1940 is(pack("(a)3 ((a)2 .*)", 1..5, 7), "12345\x00\x00",
1941 ". relative to start, extend");
1942 is(pack("(a)3 ((a)2 .*)", 1..5, 5), "12345",
1943 ". relative to start, keep");
1944
1945 is(pack('(a)5 (. @2 a)', 1..5, -3, "a"), "12\x00\x00a",
1946 ". based shrink properly updates group starts");
1947
1948 is(pack("(W)3 ((W)2 .)", 0x301..0x305, -2), "\x{301}",
1949 "utf8 . relative to group, shorten");
1950 is(pack("(W)3 ((W)2 .)", 0x301..0x305, 2),
1951 "\x{301}\x{302}\x{303}\x{304}\x{305}",
1952 "utf8 . relative to group, keep");
1953 is(pack("(W)3 ((W)2 .)", 0x301..0x305, 4),
1954 "\x{301}\x{302}\x{303}\x{304}\x{305}\x00\x00",
1955 "utf8 . relative to group, extend");
1956
1957 is(pack("(W)3 ((W)2 .!)", 0x301..0x305, -2), "\x{301}\x{302}",
1958 "utf8 . relative to group, shorten");
1959 is(pack("(W)3 ((W)2 .!)", 0x301..0x305, 4),
1960 "\x{301}\x{302}\x{303}\x{304}\x{305}",
1961 "utf8 . relative to group, keep");
1962 is(pack("(W)3 ((W)2 .!)", 0x301..0x305, 6),
1963 "\x{301}\x{302}\x{303}\x{304}\x{305}\x00\x00",
1964 "utf8 . relative to group, extend");
1965
1966 is(pack('(W)5 (. @2 a)', 0x301..0x305, -3, "a"),
1967 "\x{301}\x{302}\x00\x00a",
1968 "utf8 . based shrink properly updates group starts");
1969}
1970{
1971 # Testing @!
1972 is(pack('a* @3', "abcde"), "abc", 'Test basic @');
1973 is(pack('a* @!3', "abcde"), "abc", 'Test basic @!');
1974 is(pack('a* @2', "\x{301}\x{302}\x{303}\x{304}\x{305}"), "\x{301}\x{302}",
1975 'Test basic utf8 @');
1976 is(pack('a* @!2', "\x{301}\x{302}\x{303}\x{304}\x{305}"), "\x{301}",
1977 'Test basic utf8 @!');
1978
1979 is(unpack('@4 a*', "abcde"), "e", 'Test basic @');
1980 is(unpack('@!4 a*', "abcde"), "e", 'Test basic @!');
1981 is(unpack('@4 a*', "\x{301}\x{302}\x{303}\x{304}\x{305}"), "\x{305}",
1982 'Test basic utf8 @');
1983 is(unpack('@!4 a*', "\x{301}\x{302}\x{303}\x{304}\x{305}"),
1984 "\x{303}\x{304}\x{305}", 'Test basic utf8 @!');
1985}
Unnamed repository; edit this file to name it for gitweb.