3 * Copyright (c) 1998-2000, Larry Wall
5 * You may distribute under the terms of either the GNU General Public
6 * License or the Artistic License, as specified in the README file.
11 * 'What a fix!' said Sam. 'That's the one place in all the lands we've ever
12 * heard of that we don't want to see any closer; and that's the one place
13 * we're trying to get to! And that's just where we can't get, nohow.'
15 * 'Well do I understand your speech,' he answered in the same language;
16 * 'yet few strangers do so. Why then do you not speak in the Common Tongue,
17 * as is the custom in the West, if you wish to be answered?'
19 * ...the travellers perceived that the floor was paved with stones of many
20 * hues; branching runes and strange devices intertwined beneath their feet.
24 #define PERL_IN_UTF8_C
30 Perl_uv_to_utf8(pTHX_ U8 *d, UV uv)
37 *d++ = (( uv >> 6) | 0xc0);
38 *d++ = (( uv & 0x3f) | 0x80);
42 *d++ = (( uv >> 12) | 0xe0);
43 *d++ = (((uv >> 6) & 0x3f) | 0x80);
44 *d++ = (( uv & 0x3f) | 0x80);
48 *d++ = (( uv >> 18) | 0xf0);
49 *d++ = (((uv >> 12) & 0x3f) | 0x80);
50 *d++ = (((uv >> 6) & 0x3f) | 0x80);
51 *d++ = (( uv & 0x3f) | 0x80);
55 *d++ = (( uv >> 24) | 0xf8);
56 *d++ = (((uv >> 18) & 0x3f) | 0x80);
57 *d++ = (((uv >> 12) & 0x3f) | 0x80);
58 *d++ = (((uv >> 6) & 0x3f) | 0x80);
59 *d++ = (( uv & 0x3f) | 0x80);
62 if (uv < 0x80000000) {
63 *d++ = (( uv >> 30) | 0xfc);
64 *d++ = (((uv >> 24) & 0x3f) | 0x80);
65 *d++ = (((uv >> 18) & 0x3f) | 0x80);
66 *d++ = (((uv >> 12) & 0x3f) | 0x80);
67 *d++ = (((uv >> 6) & 0x3f) | 0x80);
68 *d++ = (( uv & 0x3f) | 0x80);
72 if (uv < 0x1000000000LL)
75 *d++ = 0xfe; /* Can't match U+FEFF! */
76 *d++ = (((uv >> 30) & 0x3f) | 0x80);
77 *d++ = (((uv >> 24) & 0x3f) | 0x80);
78 *d++ = (((uv >> 18) & 0x3f) | 0x80);
79 *d++ = (((uv >> 12) & 0x3f) | 0x80);
80 *d++ = (((uv >> 6) & 0x3f) | 0x80);
81 *d++ = (( uv & 0x3f) | 0x80);
86 *d++ = 0xff; /* Can't match U+FFFE! */
87 *d++ = 0x80; /* 6 Reserved bits */
88 *d++ = (((uv >> 60) & 0x0f) | 0x80); /* 2 Reserved bits */
89 *d++ = (((uv >> 54) & 0x3f) | 0x80);
90 *d++ = (((uv >> 48) & 0x3f) | 0x80);
91 *d++ = (((uv >> 42) & 0x3f) | 0x80);
92 *d++ = (((uv >> 36) & 0x3f) | 0x80);
93 *d++ = (((uv >> 30) & 0x3f) | 0x80);
94 *d++ = (((uv >> 24) & 0x3f) | 0x80);
95 *d++ = (((uv >> 18) & 0x3f) | 0x80);
96 *d++ = (((uv >> 12) & 0x3f) | 0x80);
97 *d++ = (((uv >> 6) & 0x3f) | 0x80);
98 *d++ = (( uv & 0x3f) | 0x80);
104 /* Tests if some arbitrary number of bytes begins in a valid UTF-8 character.
105 * The actual number of bytes in the UTF-8 character will be returned if it
106 * is valid, otherwise 0. */
108 Perl_is_utf8_char(pTHX_ U8 *s)
117 if (u >= 0x80 && u <= 0xbf)
122 if (len < 2 || (u >= 0xc0 && u <= 0xfd && s[1] < 0x80))
130 if ((*s & 0xc0) != 0x80)
132 uv = (uv << 6) | (*s & 0x3f);
139 if (UNISKIP(uv) < len)
146 =for apidoc Am|is_utf8_string|U8 *s|STRLEN len
148 Returns true if first C<len> bytes of the given string form valid a UTF8
149 string, false otherwise.
155 Perl_is_utf8_string(pTHX_ U8 *s, STRLEN len)
174 =for apidoc Am|U8* s|utf8_to_uv_chk|STRLEN curlen|I32 *retlen|U32 flags
176 Returns the character value of the first character in the string C<s>
177 which is assumed to be in UTF8 encoding and no longer than C<curlen>;
178 C<retlen> will be set to the length, in bytes, of that character,
179 and the pointer C<s> will be advanced to the end of the character.
181 If C<s> does not point to a well-formed UTF8 character, the behaviour
182 is dependent on the value of C<checking>: if this is true, it is
183 assumed that the caller will raise a warning, and this function will
184 set C<retlen> to C<-1> and return. If C<checking> is not true, an optional UTF8
191 Perl_utf8_to_uv_chk(pTHX_ U8* s, STRLEN curlen, STRLEN* retlen, U32 flags)
196 bool dowarn = ckWARN_d(WARN_UTF8);
197 STRLEN expectlen = 0;
199 if (uv <= 0x7f) { /* Pure ASCII. */
205 if ((uv >= 0x80 && uv <= 0xbf) &&
206 !(flags & UTF8_ALLOW_CONTINUATION)) {
208 Perl_warner(aTHX_ WARN_UTF8,
209 "Malformed UTF-8 character (unexpected continuation byte 0x%02x)",
214 if ((uv >= 0xc0 && uv <= 0xfd && s[1] < 0x80) &&
215 !(flags & UTF8_ALLOW_NON_CONTINUATION)) {
217 Perl_warner(aTHX_ WARN_UTF8,
218 "Malformed UTF-8 character (unexpected non-continuation byte 0x%02x after byte 0x%02x)",
223 if ((uv == 0xfe || uv == 0xff) &&
224 !(flags & UTF8_ALLOW_FE_FF)) {
226 Perl_warner(aTHX_ WARN_UTF8,
227 "Malformed UTF-8 character (byte 0x%02x)",
232 if (!(uv & 0x20)) { len = 2; uv &= 0x1f; }
233 else if (!(uv & 0x10)) { len = 3; uv &= 0x0f; }
234 else if (!(uv & 0x08)) { len = 4; uv &= 0x07; }
235 else if (!(uv & 0x04)) { len = 5; uv &= 0x03; }
236 else if (!(uv & 0x02)) { len = 6; uv &= 0x01; }
237 else if (!(uv & 0x01)) { len = 7; uv = 0; }
238 else { len = 13; uv = 0; } /* whoa! */
245 if ((curlen < expectlen) &&
246 !(flags & UTF8_ALLOW_SHORT)) {
248 Perl_warner(aTHX_ WARN_UTF8,
249 "Malformed UTF-8 character (%d byte%s, need %d)",
250 curlen, curlen > 1 ? "s" : "", expectlen);
259 if ((*s & 0xc0) != 0x80) {
261 Perl_warner(aTHX_ WARN_UTF8,
262 "Malformed UTF-8 character (unexpected continuation byte 0x%02x)",
267 uv = (uv << 6) | (*s & 0x3f);
269 /* This cannot be allowed. */
271 Perl_warner(aTHX_ WARN_UTF8,
272 "Malformed UTF-8 character (overflow at 0x%"UVxf", byte 0x%02x)",
280 if ((uv >= 0xd800 && uv <= 0xdfff) &&
281 !(flags & UTF8_ALLOW_SURROGATE)) {
283 Perl_warner(aTHX_ WARN_UTF8,
284 "Malformed UTF-8 character (UTF-16 surrogate 0x%04"UVxf")",
287 } else if ((uv == 0xfffe) &&
288 !(flags & UTF8_ALLOW_BOM)) {
290 Perl_warner(aTHX_ WARN_UTF8,
291 "Malformed UTF-8 character (byte order mark 0x%04"UVxf")",
294 } else if ((uv == 0xffff) &&
295 !(flags & UTF8_ALLOW_FFFF)) {
297 Perl_warner(aTHX_ WARN_UTF8,
298 "Malformed UTF-8 character (character 0x%04"UVxf")",
301 } else if ((expectlen > UNISKIP(uv)) &&
302 !(flags & UTF8_ALLOW_LONG)) {
304 Perl_warner(aTHX_ WARN_UTF8,
305 "Malformed UTF-8 character (%d byte%s, need %d)",
306 expectlen, expectlen > 1 ? "s": "", UNISKIP(uv));
314 if (flags & UTF8_CHECK_ONLY) {
323 return UNICODE_REPLACEMENT_CHARACTER;
327 =for apidoc Am|U8* s|utf8_to_uv|STRLEN *retlen
329 Returns the character value of the first character in the string C<s>
330 which is assumed to be in UTF8 encoding; C<retlen> will be set to the
331 length, in bytes, of that character, and the pointer C<s> will be
332 advanced to the end of the character.
334 If C<s> does not point to a well-formed UTF8 character, zero is
335 returned and retlen is set, if possible, to -1.
341 Perl_utf8_to_uv(pTHX_ U8* s, STRLEN* retlen)
343 return Perl_utf8_to_uv_chk(aTHX_ s, (STRLEN)-1, retlen, 0);
346 /* utf8_distance(a,b) returns the number of UTF8 characters between
347 the pointers a and b */
350 Perl_utf8_distance(pTHX_ U8 *a, U8 *b)
368 /* WARNING: do not use the following unless you *know* off is within bounds */
371 Perl_utf8_hop(pTHX_ U8 *s, I32 off)
381 while ((*s & 0xc0) == 0x80)
390 =for apidoc Am|U8 *|utf8_to_bytes|U8 *s|STRLEN *len
392 Converts a string C<s> of length C<len> from UTF8 into byte encoding.
393 Unlike C<bytes_to_utf8>, this over-writes the original string, and
394 updates len to contain the new length.
395 Returns zero on failure, setting C<len> to -1.
401 Perl_utf8_to_bytes(pTHX_ U8* s, STRLEN *len)
411 /* ensure valid UTF8 and chars < 256 before updating string */
415 ( (s >= send) || ((*s++ & 0xc0) != 0x80) || ((c & 0xfe) != 0xc2))) {
426 *d++ = (U8)utf8_to_uv(s, &ulen);
436 =for apidoc Am|U8 *|bytes_to_utf8|U8 *s|STRLEN *len
438 Converts a string C<s> of length C<len> from ASCII into UTF8 encoding.
439 Returns a pointer to the newly-created string, and sets C<len> to
440 reflect the new length.
446 Perl_bytes_to_utf8(pTHX_ U8* s, STRLEN *len)
454 Newz(801, d, (*len) * 2 + 1, U8);
462 *d++ = (( uv >> 6) | 0xc0);
463 *d++ = (( uv & 0x3f) | 0x80);
472 * Convert native (big-endian) or reversed (little-endian) UTF-16 to UTF-8.
474 * Destination must be pre-extended to 3/2 source. Do not use in-place.
475 * We optimize for native, for obvious reasons. */
478 Perl_utf16_to_utf8(pTHX_ U8* p, U8* d, I32 bytelen, I32 *newlen)
484 Perl_croak(aTHX_ "panic: utf16_to_utf8: odd bytelen");
489 UV uv = (p[0] << 8) + p[1]; /* UTF-16BE */
496 *d++ = (( uv >> 6) | 0xc0);
497 *d++ = (( uv & 0x3f) | 0x80);
500 if (uv >= 0xd800 && uv < 0xdbff) { /* surrogates */
503 if (low < 0xdc00 || low >= 0xdfff)
504 Perl_croak(aTHX_ "Malformed UTF-16 surrogate");
505 uv = ((uv - 0xd800) << 10) + (low - 0xdc00) + 0x10000;
508 *d++ = (( uv >> 12) | 0xe0);
509 *d++ = (((uv >> 6) & 0x3f) | 0x80);
510 *d++ = (( uv & 0x3f) | 0x80);
514 *d++ = (( uv >> 18) | 0xf0);
515 *d++ = (((uv >> 12) & 0x3f) | 0x80);
516 *d++ = (((uv >> 6) & 0x3f) | 0x80);
517 *d++ = (( uv & 0x3f) | 0x80);
521 *newlen = d - dstart;
525 /* Note: this one is slightly destructive of the source. */
528 Perl_utf16_to_utf8_reversed(pTHX_ U8* p, U8* d, I32 bytelen, I32 *newlen)
531 U8* send = s + bytelen;
538 return utf16_to_utf8(p, d, bytelen, newlen);
541 /* for now these are all defined (inefficiently) in terms of the utf8 versions */
544 Perl_is_uni_alnum(pTHX_ U32 c)
546 U8 tmpbuf[UTF8_MAXLEN];
547 uv_to_utf8(tmpbuf, (UV)c);
548 return is_utf8_alnum(tmpbuf);
552 Perl_is_uni_alnumc(pTHX_ U32 c)
554 U8 tmpbuf[UTF8_MAXLEN];
555 uv_to_utf8(tmpbuf, (UV)c);
556 return is_utf8_alnumc(tmpbuf);
560 Perl_is_uni_idfirst(pTHX_ U32 c)
562 U8 tmpbuf[UTF8_MAXLEN];
563 uv_to_utf8(tmpbuf, (UV)c);
564 return is_utf8_idfirst(tmpbuf);
568 Perl_is_uni_alpha(pTHX_ U32 c)
570 U8 tmpbuf[UTF8_MAXLEN];
571 uv_to_utf8(tmpbuf, (UV)c);
572 return is_utf8_alpha(tmpbuf);
576 Perl_is_uni_ascii(pTHX_ U32 c)
578 U8 tmpbuf[UTF8_MAXLEN];
579 uv_to_utf8(tmpbuf, (UV)c);
580 return is_utf8_ascii(tmpbuf);
584 Perl_is_uni_space(pTHX_ U32 c)
586 U8 tmpbuf[UTF8_MAXLEN];
587 uv_to_utf8(tmpbuf, (UV)c);
588 return is_utf8_space(tmpbuf);
592 Perl_is_uni_digit(pTHX_ U32 c)
594 U8 tmpbuf[UTF8_MAXLEN];
595 uv_to_utf8(tmpbuf, (UV)c);
596 return is_utf8_digit(tmpbuf);
600 Perl_is_uni_upper(pTHX_ U32 c)
602 U8 tmpbuf[UTF8_MAXLEN];
603 uv_to_utf8(tmpbuf, (UV)c);
604 return is_utf8_upper(tmpbuf);
608 Perl_is_uni_lower(pTHX_ U32 c)
610 U8 tmpbuf[UTF8_MAXLEN];
611 uv_to_utf8(tmpbuf, (UV)c);
612 return is_utf8_lower(tmpbuf);
616 Perl_is_uni_cntrl(pTHX_ U32 c)
618 U8 tmpbuf[UTF8_MAXLEN];
619 uv_to_utf8(tmpbuf, (UV)c);
620 return is_utf8_cntrl(tmpbuf);
624 Perl_is_uni_graph(pTHX_ U32 c)
626 U8 tmpbuf[UTF8_MAXLEN];
627 uv_to_utf8(tmpbuf, (UV)c);
628 return is_utf8_graph(tmpbuf);
632 Perl_is_uni_print(pTHX_ U32 c)
634 U8 tmpbuf[UTF8_MAXLEN];
635 uv_to_utf8(tmpbuf, (UV)c);
636 return is_utf8_print(tmpbuf);
640 Perl_is_uni_punct(pTHX_ U32 c)
642 U8 tmpbuf[UTF8_MAXLEN];
643 uv_to_utf8(tmpbuf, (UV)c);
644 return is_utf8_punct(tmpbuf);
648 Perl_is_uni_xdigit(pTHX_ U32 c)
650 U8 tmpbuf[UTF8_MAXLEN];
651 uv_to_utf8(tmpbuf, (UV)c);
652 return is_utf8_xdigit(tmpbuf);
656 Perl_to_uni_upper(pTHX_ U32 c)
658 U8 tmpbuf[UTF8_MAXLEN];
659 uv_to_utf8(tmpbuf, (UV)c);
660 return to_utf8_upper(tmpbuf);
664 Perl_to_uni_title(pTHX_ U32 c)
666 U8 tmpbuf[UTF8_MAXLEN];
667 uv_to_utf8(tmpbuf, (UV)c);
668 return to_utf8_title(tmpbuf);
672 Perl_to_uni_lower(pTHX_ U32 c)
674 U8 tmpbuf[UTF8_MAXLEN];
675 uv_to_utf8(tmpbuf, (UV)c);
676 return to_utf8_lower(tmpbuf);
679 /* for now these all assume no locale info available for Unicode > 255 */
682 Perl_is_uni_alnum_lc(pTHX_ U32 c)
684 return is_uni_alnum(c); /* XXX no locale support yet */
688 Perl_is_uni_alnumc_lc(pTHX_ U32 c)
690 return is_uni_alnumc(c); /* XXX no locale support yet */
694 Perl_is_uni_idfirst_lc(pTHX_ U32 c)
696 return is_uni_idfirst(c); /* XXX no locale support yet */
700 Perl_is_uni_alpha_lc(pTHX_ U32 c)
702 return is_uni_alpha(c); /* XXX no locale support yet */
706 Perl_is_uni_ascii_lc(pTHX_ U32 c)
708 return is_uni_ascii(c); /* XXX no locale support yet */
712 Perl_is_uni_space_lc(pTHX_ U32 c)
714 return is_uni_space(c); /* XXX no locale support yet */
718 Perl_is_uni_digit_lc(pTHX_ U32 c)
720 return is_uni_digit(c); /* XXX no locale support yet */
724 Perl_is_uni_upper_lc(pTHX_ U32 c)
726 return is_uni_upper(c); /* XXX no locale support yet */
730 Perl_is_uni_lower_lc(pTHX_ U32 c)
732 return is_uni_lower(c); /* XXX no locale support yet */
736 Perl_is_uni_cntrl_lc(pTHX_ U32 c)
738 return is_uni_cntrl(c); /* XXX no locale support yet */
742 Perl_is_uni_graph_lc(pTHX_ U32 c)
744 return is_uni_graph(c); /* XXX no locale support yet */
748 Perl_is_uni_print_lc(pTHX_ U32 c)
750 return is_uni_print(c); /* XXX no locale support yet */
754 Perl_is_uni_punct_lc(pTHX_ U32 c)
756 return is_uni_punct(c); /* XXX no locale support yet */
760 Perl_is_uni_xdigit_lc(pTHX_ U32 c)
762 return is_uni_xdigit(c); /* XXX no locale support yet */
766 Perl_to_uni_upper_lc(pTHX_ U32 c)
768 return to_uni_upper(c); /* XXX no locale support yet */
772 Perl_to_uni_title_lc(pTHX_ U32 c)
774 return to_uni_title(c); /* XXX no locale support yet */
778 Perl_to_uni_lower_lc(pTHX_ U32 c)
780 return to_uni_lower(c); /* XXX no locale support yet */
784 Perl_is_utf8_alnum(pTHX_ U8 *p)
786 if (!is_utf8_char(p))
789 /* NOTE: "IsWord", not "IsAlnum", since Alnum is a true
790 * descendant of isalnum(3), in other words, it doesn't
791 * contain the '_'. --jhi */
792 PL_utf8_alnum = swash_init("utf8", "IsWord", &PL_sv_undef, 0, 0);
793 return swash_fetch(PL_utf8_alnum, p);
794 /* return *p == '_' || is_utf8_alpha(p) || is_utf8_digit(p); */
795 #ifdef SURPRISINGLY_SLOWER /* probably because alpha is usually true */
797 PL_utf8_alnum = swash_init("utf8", "",
798 sv_2mortal(newSVpv("+utf8::IsAlpha\n+utf8::IsDigit\n005F\n",0)), 0, 0);
799 return swash_fetch(PL_utf8_alnum, p);
804 Perl_is_utf8_alnumc(pTHX_ U8 *p)
806 if (!is_utf8_char(p))
809 PL_utf8_alnum = swash_init("utf8", "IsAlnumC", &PL_sv_undef, 0, 0);
810 return swash_fetch(PL_utf8_alnum, p);
811 /* return is_utf8_alpha(p) || is_utf8_digit(p); */
812 #ifdef SURPRISINGLY_SLOWER /* probably because alpha is usually true */
814 PL_utf8_alnum = swash_init("utf8", "",
815 sv_2mortal(newSVpv("+utf8::IsAlpha\n+utf8::IsDigit\n005F\n",0)), 0, 0);
816 return swash_fetch(PL_utf8_alnum, p);
821 Perl_is_utf8_idfirst(pTHX_ U8 *p)
823 return *p == '_' || is_utf8_alpha(p);
827 Perl_is_utf8_alpha(pTHX_ U8 *p)
829 if (!is_utf8_char(p))
832 PL_utf8_alpha = swash_init("utf8", "IsAlpha", &PL_sv_undef, 0, 0);
833 return swash_fetch(PL_utf8_alpha, p);
837 Perl_is_utf8_ascii(pTHX_ U8 *p)
839 if (!is_utf8_char(p))
842 PL_utf8_ascii = swash_init("utf8", "IsAscii", &PL_sv_undef, 0, 0);
843 return swash_fetch(PL_utf8_ascii, p);
847 Perl_is_utf8_space(pTHX_ U8 *p)
849 if (!is_utf8_char(p))
852 PL_utf8_space = swash_init("utf8", "IsSpace", &PL_sv_undef, 0, 0);
853 return swash_fetch(PL_utf8_space, p);
857 Perl_is_utf8_digit(pTHX_ U8 *p)
859 if (!is_utf8_char(p))
862 PL_utf8_digit = swash_init("utf8", "IsDigit", &PL_sv_undef, 0, 0);
863 return swash_fetch(PL_utf8_digit, p);
867 Perl_is_utf8_upper(pTHX_ U8 *p)
869 if (!is_utf8_char(p))
872 PL_utf8_upper = swash_init("utf8", "IsUpper", &PL_sv_undef, 0, 0);
873 return swash_fetch(PL_utf8_upper, p);
877 Perl_is_utf8_lower(pTHX_ U8 *p)
879 if (!is_utf8_char(p))
882 PL_utf8_lower = swash_init("utf8", "IsLower", &PL_sv_undef, 0, 0);
883 return swash_fetch(PL_utf8_lower, p);
887 Perl_is_utf8_cntrl(pTHX_ U8 *p)
889 if (!is_utf8_char(p))
892 PL_utf8_cntrl = swash_init("utf8", "IsCntrl", &PL_sv_undef, 0, 0);
893 return swash_fetch(PL_utf8_cntrl, p);
897 Perl_is_utf8_graph(pTHX_ U8 *p)
899 if (!is_utf8_char(p))
902 PL_utf8_graph = swash_init("utf8", "IsGraph", &PL_sv_undef, 0, 0);
903 return swash_fetch(PL_utf8_graph, p);
907 Perl_is_utf8_print(pTHX_ U8 *p)
909 if (!is_utf8_char(p))
912 PL_utf8_print = swash_init("utf8", "IsPrint", &PL_sv_undef, 0, 0);
913 return swash_fetch(PL_utf8_print, p);
917 Perl_is_utf8_punct(pTHX_ U8 *p)
919 if (!is_utf8_char(p))
922 PL_utf8_punct = swash_init("utf8", "IsPunct", &PL_sv_undef, 0, 0);
923 return swash_fetch(PL_utf8_punct, p);
927 Perl_is_utf8_xdigit(pTHX_ U8 *p)
929 if (!is_utf8_char(p))
932 PL_utf8_xdigit = swash_init("utf8", "IsXDigit", &PL_sv_undef, 0, 0);
933 return swash_fetch(PL_utf8_xdigit, p);
937 Perl_is_utf8_mark(pTHX_ U8 *p)
939 if (!is_utf8_char(p))
942 PL_utf8_mark = swash_init("utf8", "IsM", &PL_sv_undef, 0, 0);
943 return swash_fetch(PL_utf8_mark, p);
947 Perl_to_utf8_upper(pTHX_ U8 *p)
951 if (!PL_utf8_toupper)
952 PL_utf8_toupper = swash_init("utf8", "ToUpper", &PL_sv_undef, 4, 0);
953 uv = swash_fetch(PL_utf8_toupper, p);
954 return uv ? uv : utf8_to_uv_chk(p,STRLEN_MAX,0,0);
958 Perl_to_utf8_title(pTHX_ U8 *p)
962 if (!PL_utf8_totitle)
963 PL_utf8_totitle = swash_init("utf8", "ToTitle", &PL_sv_undef, 4, 0);
964 uv = swash_fetch(PL_utf8_totitle, p);
965 return uv ? uv : utf8_to_uv_chk(p,STRLEN_MAX,0,0);
969 Perl_to_utf8_lower(pTHX_ U8 *p)
973 if (!PL_utf8_tolower)
974 PL_utf8_tolower = swash_init("utf8", "ToLower", &PL_sv_undef, 4, 0);
975 uv = swash_fetch(PL_utf8_tolower, p);
976 return uv ? uv : utf8_to_uv_chk(p,STRLEN_MAX,0,0);
979 /* a "swash" is a swatch hash */
982 Perl_swash_init(pTHX_ char* pkg, char* name, SV *listsv, I32 minbits, I32 none)
988 if (!gv_stashpv(pkg, 0)) { /* demand load utf8 */
990 Perl_load_module(aTHX_ PERL_LOADMOD_NOIMPORT, newSVpv(pkg,0), Nullsv);
994 PUSHSTACKi(PERLSI_MAGIC);
997 PUSHs(sv_2mortal(newSVpvn(pkg, strlen(pkg))));
998 PUSHs(sv_2mortal(newSVpvn(name, strlen(name))));
1000 PUSHs(sv_2mortal(newSViv(minbits)));
1001 PUSHs(sv_2mortal(newSViv(none)));
1007 if (PL_curcop == &PL_compiling) /* XXX ought to be handled by lex_start */
1008 strncpy(tmpbuf, PL_tokenbuf, sizeof tmpbuf);
1009 if (call_method("SWASHNEW", G_SCALAR))
1010 retval = newSVsv(*PL_stack_sp--);
1012 retval = &PL_sv_undef;
1015 if (PL_curcop == &PL_compiling) {
1016 strncpy(PL_tokenbuf, tmpbuf, sizeof tmpbuf);
1017 PL_curcop->op_private = PL_hints;
1019 if (!SvROK(retval) || SvTYPE(SvRV(retval)) != SVt_PVHV)
1020 Perl_croak(aTHX_ "SWASHNEW didn't return an HV ref");
1025 Perl_swash_fetch(pTHX_ SV *sv, U8 *ptr)
1027 HV* hv = (HV*)SvRV(sv);
1028 U32 klen = UTF8SKIP(ptr) - 1;
1029 U32 off = ptr[klen] & 127; /* NB: 64 bit always 0 when len > 1 */
1031 STRLEN needents = (klen ? 64 : 128);
1037 * This single-entry cache saves about 1/3 of the utf8 overhead in test
1038 * suite. (That is, only 7-8% overall over just a hash cache. Still,
1039 * it's nothing to sniff at.) Pity we usually come through at least
1040 * two function calls to get here...
1042 * NB: this code assumes that swatches are never modified, once generated!
1045 if (hv == PL_last_swash_hv &&
1046 klen == PL_last_swash_klen &&
1047 (!klen || memEQ((char *)ptr,(char *)PL_last_swash_key,klen)) )
1049 tmps = PL_last_swash_tmps;
1050 slen = PL_last_swash_slen;
1053 /* Try our second-level swatch cache, kept in a hash. */
1054 SV** svp = hv_fetch(hv, (char*)ptr, klen, FALSE);
1056 /* If not cached, generate it via utf8::SWASHGET */
1057 if (!svp || !SvPOK(*svp) || !(tmps = (U8*)SvPV(*svp, slen))) {
1062 PUSHSTACKi(PERLSI_MAGIC);
1066 PUSHs(sv_2mortal(newSViv(utf8_to_uv_chk(ptr, STRLEN_MAX, 0, 0) & ~(needents - 1))));
1067 PUSHs(sv_2mortal(newSViv(needents)));
1069 if (call_method("SWASHGET", G_SCALAR))
1070 retval = newSVsv(*PL_stack_sp--);
1072 retval = &PL_sv_undef;
1076 if (PL_curcop == &PL_compiling)
1077 PL_curcop->op_private = PL_hints;
1079 svp = hv_store(hv, (char*)ptr, klen, retval, 0);
1081 if (!svp || !(tmps = (U8*)SvPV(*svp, slen)) || slen < 8)
1082 Perl_croak(aTHX_ "SWASHGET didn't return result of proper length");
1085 PL_last_swash_hv = hv;
1086 PL_last_swash_klen = klen;
1087 PL_last_swash_tmps = tmps;
1088 PL_last_swash_slen = slen;
1090 Copy(ptr, PL_last_swash_key, klen, U8);
1093 switch ((slen << 3) / needents) {
1095 bit = 1 << (off & 7);
1097 return (tmps[off] & bit) != 0;
1102 return (tmps[off] << 8) + tmps[off + 1] ;
1105 return (tmps[off] << 24) + (tmps[off+1] << 16) + (tmps[off+2] << 8) + tmps[off + 3] ;
1107 Perl_croak(aTHX_ "panic: swash_fetch");