3 * Copyright (c) 1991-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 * "'So that was the job I felt I had to do when I started,' thought Sam."
15 #define PERL_IN_DOOP_C
18 #if !defined(NSIG) || defined(M_UNIX) || defined(M_XENIX)
23 S_do_trans_CC_simple(pTHX_ SV *sv)
33 tbl = (short*)cPVOP->op_pv;
35 Perl_croak(aTHX_ "panic: do_trans");
37 s = (U8*)SvPV(sv, len);
41 if ((ch = tbl[*s]) >= 0) {
53 S_do_trans_CC_count(pTHX_ SV *sv)
62 tbl = (short*)cPVOP->op_pv;
64 Perl_croak(aTHX_ "panic: do_trans");
66 s = (U8*)SvPV(sv, len);
79 S_do_trans_CC_complex(pTHX_ SV *sv)
90 tbl = (short*)cPVOP->op_pv;
92 Perl_croak(aTHX_ "panic: do_trans");
94 s = (U8*)SvPV(sv, len);
98 if (PL_op->op_private & OPpTRANS_SQUASH) {
102 if ((ch = tbl[*s]) >= 0) {
105 if (p == d - 1 && *p == *d)
110 else if (ch == -1) /* -1 is unmapped character */
111 *d++ = *s; /* -2 is delete character */
117 if ((ch = tbl[*s]) >= 0) {
122 else if (ch == -1) /* -1 is unmapped character */
123 *d++ = *s; /* -2 is delete character */
127 matches += send - d; /* account for disappeared chars */
129 SvCUR_set(sv, d - (U8*)SvPVX(sv));
136 S_do_trans_UU_simple(pTHX_ SV *sv)
145 SV* rv = (SV*)cSVOP->op_sv;
146 HV* hv = (HV*)SvRV(rv);
147 SV** svp = hv_fetch(hv, "NONE", 4, FALSE);
148 UV none = svp ? SvUV(*svp) : 0x7fffffff;
153 s = (U8*)SvPV(sv, len);
156 svp = hv_fetch(hv, "FINAL", 5, FALSE);
162 if ((uv = swash_fetch(rv, s)) < none) {
165 d = uv_to_utf8(d, uv);
167 else if (uv == none) {
169 for (i = UTF8SKIP(s); i; i--)
172 else if (uv == extra) {
175 d = uv_to_utf8(d, final);
181 SvCUR_set(sv, d - (U8*)SvPVX(sv));
188 S_do_trans_UU_count(pTHX_ SV *sv)
196 SV* rv = (SV*)cSVOP->op_sv;
197 HV* hv = (HV*)SvRV(rv);
198 SV** svp = hv_fetch(hv, "NONE", 4, FALSE);
199 UV none = svp ? SvUV(*svp) : 0x7fffffff;
202 s = (U8*)SvPV(sv, len);
206 if ((uv = swash_fetch(rv, s)) < none)
215 S_do_trans_UC_simple(pTHX_ SV *sv)
224 SV* rv = (SV*)cSVOP->op_sv;
225 HV* hv = (HV*)SvRV(rv);
226 SV** svp = hv_fetch(hv, "NONE", 4, FALSE);
227 UV none = svp ? SvUV(*svp) : 0x7fffffff;
232 s = (U8*)SvPV(sv, len);
235 svp = hv_fetch(hv, "FINAL", 5, FALSE);
241 if ((uv = swash_fetch(rv, s)) < none) {
246 else if (uv == none) {
248 uv = utf8_to_uv(s, &ulen);
252 else if (uv == extra) {
261 SvCUR_set(sv, d - (U8*)SvPVX(sv));
268 S_do_trans_CU_simple(pTHX_ SV *sv)
278 SV* rv = (SV*)cSVOP->op_sv;
279 HV* hv = (HV*)SvRV(rv);
280 SV** svp = hv_fetch(hv, "NONE", 4, FALSE);
281 UV none = svp ? SvUV(*svp) : 0x7fffffff;
285 U8 tmpbuf[UTF8_MAXLEN];
288 s = (U8*)SvPV(sv, len);
291 svp = hv_fetch(hv, "BITS", 4, FALSE);
293 bits = (I32)SvIV(*svp);
295 svp = hv_fetch(hv, "FINAL", 5, FALSE);
299 Newz(801, d, len * (bits >> 3) + 1, U8);
307 tmpbuf[0] = (( uv >> 6) | 0xc0);
308 tmpbuf[1] = (( uv & 0x3f) | 0x80);
311 if ((uv = swash_fetch(rv, tmpbuf)) < none) {
313 d = uv_to_utf8(d, uv);
316 d = uv_to_utf8(d, s[-1]);
317 else if (uv == extra) {
319 d = uv_to_utf8(d, final);
323 sv_usepvn_mg(sv, (char*)dst, d - dst);
328 /* utf-8 to latin-1 */
331 S_do_trans_UC_trivial(pTHX_ SV *sv)
339 s = (U8*)SvPV(sv, len);
348 UV uv = utf8_to_uv(s, &ulen);
354 SvCUR_set(sv, d - (U8*)SvPVX(sv));
360 /* latin-1 to utf-8 */
363 S_do_trans_CU_trivial(pTHX_ SV *sv)
373 s = (U8*)SvPV(sv, len);
376 Newz(801, d, len * 2 + 1, U8);
386 *d++ = (( uv >> 6) | 0xc0);
387 *d++ = (( uv & 0x3f) | 0x80);
391 sv_usepvn_mg(sv, (char*)dst, d - dst);
397 S_do_trans_UU_complex(pTHX_ SV *sv)
404 I32 squash = PL_op->op_private & OPpTRANS_SQUASH;
405 I32 from_utf = PL_op->op_private & OPpTRANS_FROM_UTF;
406 I32 to_utf = PL_op->op_private & OPpTRANS_TO_UTF;
407 I32 del = PL_op->op_private & OPpTRANS_DELETE;
408 SV* rv = (SV*)cSVOP->op_sv;
409 HV* hv = (HV*)SvRV(rv);
410 SV** svp = hv_fetch(hv, "NONE", 4, FALSE);
411 UV none = svp ? SvUV(*svp) : 0x7fffffff;
418 s = (U8*)SvPV(sv, len);
421 svp = hv_fetch(hv, "FINAL", 5, FALSE);
425 if (PL_op->op_private & OPpTRANS_GROWS) {
428 svp = hv_fetch(hv, "BITS", 4, FALSE);
430 bits = (I32)SvIV(*svp);
432 Newz(801, d, len * (bits >> 3) + 1, U8);
444 uv = swash_fetch(rv, s);
452 tmpbuf[0] = (( uv >> 6) | 0xc0);
453 tmpbuf[1] = (( uv & 0x3f) | 0x80);
455 uv = swash_fetch(rv, tmpbuf);
460 if (uv >= 0x80 && to_utf)
461 d = uv_to_utf8(d, uv);
470 else if (uv == none) { /* "none" is unmapped character */
476 for (i = UTF8SKIP(s); i; --i)
481 *d++ = (U8)utf8_to_uv(s, &ulen);
485 else { /* must be to_utf only */
486 d = uv_to_utf8(d, s[-1]);
491 else if (uv == extra && !del) {
494 if (final >= 0x80 && to_utf)
495 d = uv_to_utf8(d, final);
504 matches++; /* "none+1" is delete character */
512 uv = swash_fetch(rv, s);
520 tmpbuf[0] = (( uv >> 6) | 0xc0);
521 tmpbuf[1] = (( uv & 0x3f) | 0x80);
523 uv = swash_fetch(rv, tmpbuf);
527 if (uv >= 0x80 && to_utf)
528 d = uv_to_utf8(d, uv);
535 else if (uv == none) { /* "none" is unmapped character */
541 for (i = UTF8SKIP(s); i; --i)
546 *d++ = (U8)utf8_to_uv(s, &ulen);
550 else { /* must be to_utf only */
551 d = uv_to_utf8(d, s[-1]);
555 else if (uv == extra && !del) {
557 if (final >= 0x80 && to_utf)
558 d = uv_to_utf8(d, final);
565 matches++; /* "none+1" is delete character */
571 sv_usepvn(sv, (char*)dst, d - dst);
574 SvCUR_set(sv, d - (U8*)SvPVX(sv));
582 Perl_do_trans(pTHX_ SV *sv)
587 if (SvREADONLY(sv) && !(PL_op->op_private & OPpTRANS_IDENTICAL))
588 Perl_croak(aTHX_ PL_no_modify);
594 (void)SvPV_force(sv, len);
595 (void)SvPOK_only(sv);
597 DEBUG_t( Perl_deb(aTHX_ "2.TBL\n"));
599 switch (PL_op->op_private & 63) {
601 return do_trans_CC_simple(sv);
603 case OPpTRANS_FROM_UTF:
604 return do_trans_UC_simple(sv);
606 case OPpTRANS_TO_UTF:
607 return do_trans_CU_simple(sv);
609 case OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF:
610 return do_trans_UU_simple(sv);
612 case OPpTRANS_IDENTICAL:
613 return do_trans_CC_count(sv);
615 case OPpTRANS_FROM_UTF|OPpTRANS_IDENTICAL:
616 return do_trans_UC_trivial(sv);
618 case OPpTRANS_TO_UTF|OPpTRANS_IDENTICAL:
619 return do_trans_CU_trivial(sv);
621 case OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF|OPpTRANS_IDENTICAL:
622 return do_trans_UU_count(sv);
625 if (PL_op->op_private & (OPpTRANS_FROM_UTF|OPpTRANS_TO_UTF))
626 return do_trans_UU_complex(sv); /* could be UC or CU too */
628 return do_trans_CC_complex(sv);
633 Perl_do_join(pTHX_ register SV *sv, SV *del, register SV **mark, register SV **sp)
636 register I32 items = sp - mark;
639 register char *delim = SvPV(del, delimlen);
643 len = (items > 0 ? (delimlen * (items - 1) ) : 0);
644 (void)SvUPGRADE(sv, SVt_PV);
645 if (SvLEN(sv) < len + items) { /* current length is way too short */
646 while (items-- > 0) {
647 if (*mark && !SvGMAGICAL(*mark) && SvOK(*mark)) {
653 SvGROW(sv, len + 1); /* so try to pre-extend */
672 for (; items > 0; items--,mark++) {
673 sv_catpvn(sv,delim,len);
678 for (; items > 0; items--,mark++)
685 Perl_do_sprintf(pTHX_ SV *sv, I32 len, SV **sarg)
688 char *pat = SvPV(*sarg, patlen);
689 bool do_taint = FALSE;
691 sv_vsetpvfn(sv, pat, patlen, Null(va_list*), sarg + 1, len - 1, &do_taint);
698 Perl_do_vecget(pTHX_ SV *sv, I32 offset, I32 size)
701 unsigned char *s = (unsigned char *) SvPV(sv, srclen);
706 if (size < 1 || (size & (size-1))) /* size < 1 or not a power of two */
707 Perl_croak(aTHX_ "Illegal number of bits in vec");
708 offset *= size; /* turn into bit offset */
709 len = (offset + size + 7) / 8; /* required number of bytes */
714 offset >>= 3; /* turn into byte offset */
716 if (offset >= srclen)
719 retnum = (UV) s[offset] << 8;
721 else if (size == 32) {
722 if (offset >= srclen)
724 else if (offset + 1 >= srclen)
726 ((UV) s[offset ] << 24);
727 else if (offset + 2 >= srclen)
729 ((UV) s[offset ] << 24) +
730 ((UV) s[offset + 1] << 16);
733 ((UV) s[offset ] << 24) +
734 ((UV) s[offset + 1] << 16) +
735 ( s[offset + 2] << 8);
738 else if (size == 64) {
740 if (ckWARN(WARN_PORTABLE))
741 Perl_warner(aTHX_ WARN_PORTABLE,
742 "Bit vector size > 32 non-portable");
743 if (offset >= srclen)
745 else if (offset + 1 >= srclen)
747 (UV) s[offset ] << 56;
748 else if (offset + 2 >= srclen)
750 ((UV) s[offset ] << 56) +
751 ((UV) s[offset + 1] << 48);
752 else if (offset + 3 >= srclen)
754 ((UV) s[offset ] << 56) +
755 ((UV) s[offset + 1] << 48) +
756 ((UV) s[offset + 2] << 40);
757 else if (offset + 4 >= srclen)
759 ((UV) s[offset ] << 56) +
760 ((UV) s[offset + 1] << 48) +
761 ((UV) s[offset + 2] << 40) +
762 ((UV) s[offset + 3] << 32);
763 else if (offset + 5 >= srclen)
765 ((UV) s[offset ] << 56) +
766 ((UV) s[offset + 1] << 48) +
767 ((UV) s[offset + 2] << 40) +
768 ((UV) s[offset + 3] << 32) +
769 ( s[offset + 4] << 24);
770 else if (offset + 6 >= srclen)
772 ((UV) s[offset ] << 56) +
773 ((UV) s[offset + 1] << 48) +
774 ((UV) s[offset + 2] << 40) +
775 ((UV) s[offset + 3] << 32) +
776 ((UV) s[offset + 4] << 24) +
777 ((UV) s[offset + 5] << 16);
780 ((UV) s[offset ] << 56) +
781 ((UV) s[offset + 1] << 48) +
782 ((UV) s[offset + 2] << 40) +
783 ((UV) s[offset + 3] << 32) +
784 ((UV) s[offset + 4] << 24) +
785 ((UV) s[offset + 5] << 16) +
786 ( s[offset + 6] << 8);
792 retnum = (s[offset >> 3] >> (offset & 7)) & ((1 << size) - 1);
794 offset >>= 3; /* turn into byte offset */
799 ((UV) s[offset] << 8) +
803 ((UV) s[offset ] << 24) +
804 ((UV) s[offset + 1] << 16) +
805 ( s[offset + 2] << 8) +
808 else if (size == 64) {
810 if (ckWARN(WARN_PORTABLE))
811 Perl_warner(aTHX_ WARN_PORTABLE,
812 "Bit vector size > 32 non-portable");
814 ((UV) s[offset ] << 56) +
815 ((UV) s[offset + 1] << 48) +
816 ((UV) s[offset + 2] << 40) +
817 ((UV) s[offset + 3] << 32) +
818 ((UV) s[offset + 4] << 24) +
819 ((UV) s[offset + 5] << 16) +
820 ( s[offset + 6] << 8) +
830 Perl_do_vecset(pTHX_ SV *sv)
832 SV *targ = LvTARG(sv);
835 register unsigned char *s;
843 s = (unsigned char*)SvPV_force(targ, targlen);
845 offset = LvTARGOFF(sv);
846 size = LvTARGLEN(sv);
847 if (size < 1 || (size & (size-1))) /* size < 1 or not a power of two */
848 Perl_croak(aTHX_ "Illegal number of bits in vec");
850 offset *= size; /* turn into bit offset */
851 len = (offset + size + 7) / 8; /* required number of bytes */
853 s = (unsigned char*)SvGROW(targ, len + 1);
854 (void)memzero(s + targlen, len - targlen + 1);
855 SvCUR_set(targ, len);
859 mask = (1 << size) - 1;
862 offset >>= 3; /* turn into byte offset */
863 s[offset] &= ~(mask << size);
864 s[offset] |= lval << size;
867 offset >>= 3; /* turn into byte offset */
869 s[offset ] = lval & 0xff;
870 else if (size == 16) {
871 s[offset ] = (lval >> 8) & 0xff;
872 s[offset+1] = lval & 0xff;
874 else if (size == 32) {
875 s[offset ] = (lval >> 24) & 0xff;
876 s[offset+1] = (lval >> 16) & 0xff;
877 s[offset+2] = (lval >> 8) & 0xff;
878 s[offset+3] = lval & 0xff;
881 else if (size == 64) {
883 if (ckWARN(WARN_PORTABLE))
884 Perl_warner(aTHX_ WARN_PORTABLE,
885 "Bit vector size > 32 non-portable");
886 s[offset ] = (lval >> 56) & 0xff;
887 s[offset+1] = (lval >> 48) & 0xff;
888 s[offset+2] = (lval >> 40) & 0xff;
889 s[offset+3] = (lval >> 32) & 0xff;
890 s[offset+4] = (lval >> 24) & 0xff;
891 s[offset+5] = (lval >> 16) & 0xff;
892 s[offset+6] = (lval >> 8) & 0xff;
893 s[offset+7] = lval & 0xff;
901 Perl_do_chop(pTHX_ register SV *astr, register SV *sv)
907 if (SvTYPE(sv) == SVt_PVAV) {
912 for (i = 0; i <= max; i++) {
913 sv = (SV*)av_fetch(av, i, FALSE);
914 if (sv && ((sv = *(SV**)sv), sv != &PL_sv_undef))
919 else if (SvTYPE(sv) == SVt_PVHV) {
922 (void)hv_iterinit(hv);
924 while ((entry = hv_iternext(hv)))
925 do_chop(astr,hv_iterval(hv,entry));
928 else if (SvREADONLY(sv))
929 Perl_croak(aTHX_ PL_no_modify);
931 if (len && !SvPOK(sv))
932 s = SvPV_force(sv, len);
935 char *send = s + len;
938 while ((*s & 0xc0) == 0x80)
940 if (UTF8SKIP(s) != send - s && ckWARN_d(WARN_UTF8))
941 Perl_warner(aTHX_ WARN_UTF8, "Malformed UTF-8 character");
942 sv_setpvn(astr, s, send - s);
944 SvCUR_set(sv, s - start);
949 sv_setpvn(astr, "", 0);
953 sv_setpvn(astr, s, 1);
960 sv_setpvn(astr, "", 0);
965 Perl_do_chomp(pTHX_ register SV *sv)
977 if (SvTYPE(sv) == SVt_PVAV) {
982 for (i = 0; i <= max; i++) {
983 sv = (SV*)av_fetch(av, i, FALSE);
984 if (sv && ((sv = *(SV**)sv), sv != &PL_sv_undef))
985 count += do_chomp(sv);
989 else if (SvTYPE(sv) == SVt_PVHV) {
992 (void)hv_iterinit(hv);
994 while ((entry = hv_iternext(hv)))
995 count += do_chomp(hv_iterval(hv,entry));
998 else if (SvREADONLY(sv))
999 Perl_croak(aTHX_ PL_no_modify);
1001 if (len && !SvPOKp(sv))
1002 s = SvPV_force(sv, len);
1005 if (RsPARA(PL_rs)) {
1009 while (len && s[-1] == '\n') {
1017 char *rsptr = SvPV(PL_rs, rslen);
1024 if (len < rslen - 1)
1028 if (memNE(s, rsptr, rslen))
1043 Perl_do_vop(pTHX_ I32 optype, SV *sv, SV *left, SV *right)
1045 dTHR; /* just for taint */
1060 bool left_utf = DO_UTF8(left);
1061 bool right_utf = DO_UTF8(right);
1063 if (left_utf && !right_utf)
1064 sv_utf8_upgrade(right);
1065 if (!left_utf && right_utf)
1066 sv_utf8_upgrade(left);
1068 if (sv != left || (optype != OP_BIT_AND && !SvOK(sv) && !SvGMAGICAL(sv)))
1069 sv_setpvn(sv, "", 0); /* avoid undef warning on |= and ^= */
1070 lsave = lc = SvPV(left, leftlen);
1071 rsave = rc = SvPV(right, rightlen);
1072 len = leftlen < rightlen ? leftlen : rightlen;
1074 if (SvOK(sv) || SvTYPE(sv) > SVt_PVMG) {
1076 dc = SvPV_force(sv, n_a);
1077 if (SvCUR(sv) < len) {
1078 dc = SvGROW(sv, len + 1);
1079 (void)memzero(dc + SvCUR(sv), len - SvCUR(sv) + 1);
1083 I32 needlen = ((optype == OP_BIT_AND)
1084 ? len : (leftlen > rightlen ? leftlen : rightlen));
1085 Newz(801, dc, needlen + 1, char);
1086 (void)sv_usepvn(sv, dc, needlen);
1087 dc = SvPVX(sv); /* sv_usepvn() calls Renew() */
1090 (void)SvPOK_only(sv);
1091 if (left_utf || right_utf) {
1093 STRLEN lulen = leftlen;
1094 STRLEN rulen = rightlen;
1098 if (optype != OP_BIT_AND)
1099 dc = SvGROW(sv, leftlen+rightlen+1);
1103 while (lulen && rulen) {
1104 luc = utf8_to_uv((U8*)lc, &ulen);
1107 ruc = utf8_to_uv((U8*)rc, &ulen);
1111 dc = (char*)uv_to_utf8((U8*)dc, duc);
1113 dulen = dc - SvPVX(sv);
1114 SvCUR_set(sv, dulen);
1117 while (lulen && rulen) {
1118 luc = utf8_to_uv((U8*)lc, &ulen);
1121 ruc = utf8_to_uv((U8*)rc, &ulen);
1125 dc = (char*)uv_to_utf8((U8*)dc, duc);
1129 while (lulen && rulen) {
1130 luc = utf8_to_uv((U8*)lc, &ulen);
1133 ruc = utf8_to_uv((U8*)rc, &ulen);
1137 dc = (char*)uv_to_utf8((U8*)dc, duc);
1140 dulen = dc - SvPVX(sv);
1141 SvCUR_set(sv, dulen);
1143 sv_catpvn(sv, rc, rulen);
1145 sv_catpvn(sv, lc, lulen);
1155 if (len >= sizeof(long)*4 &&
1156 !((long)dc % sizeof(long)) &&
1157 !((long)lc % sizeof(long)) &&
1158 !((long)rc % sizeof(long))) /* It's almost always aligned... */
1160 I32 remainder = len % (sizeof(long)*4);
1161 len /= (sizeof(long)*4);
1170 *dl++ = *ll++ & *rl++;
1171 *dl++ = *ll++ & *rl++;
1172 *dl++ = *ll++ & *rl++;
1173 *dl++ = *ll++ & *rl++;
1178 *dl++ = *ll++ ^ *rl++;
1179 *dl++ = *ll++ ^ *rl++;
1180 *dl++ = *ll++ ^ *rl++;
1181 *dl++ = *ll++ ^ *rl++;
1186 *dl++ = *ll++ | *rl++;
1187 *dl++ = *ll++ | *rl++;
1188 *dl++ = *ll++ | *rl++;
1189 *dl++ = *ll++ | *rl++;
1204 *dc++ = *lc++ & *rc++;
1208 *dc++ = *lc++ ^ *rc++;
1212 *dc++ = *lc++ | *rc++;
1216 sv_catpvn(sv, rsave + len, rightlen - len);
1217 else if (leftlen > len)
1218 sv_catpvn(sv, lsave + len, leftlen - len);
1236 I32 gimme = GIMME_V;
1237 I32 dokeys = (PL_op->op_type == OP_KEYS);
1238 I32 dovalues = (PL_op->op_type == OP_VALUES);
1239 I32 realhv = (SvTYPE(hv) == SVt_PVHV);
1241 if (PL_op->op_type == OP_RV2HV || PL_op->op_type == OP_PADHV)
1242 dokeys = dovalues = TRUE;
1245 if (PL_op->op_flags & OPf_MOD) { /* lvalue */
1246 dTARGET; /* make sure to clear its target here */
1247 if (SvTYPE(TARG) == SVt_PVLV)
1248 LvTARG(TARG) = Nullsv;
1254 keys = realhv ? hv : avhv_keys((AV*)hv);
1255 (void)hv_iterinit(keys); /* always reset iterator regardless */
1257 if (gimme == G_VOID)
1260 if (gimme == G_SCALAR) {
1264 if (PL_op->op_flags & OPf_MOD) { /* lvalue */
1265 if (SvTYPE(TARG) < SVt_PVLV) {
1266 sv_upgrade(TARG, SVt_PVLV);
1267 sv_magic(TARG, Nullsv, 'k', Nullch, 0);
1270 if (LvTARG(TARG) != (SV*)keys) {
1272 SvREFCNT_dec(LvTARG(TARG));
1273 LvTARG(TARG) = SvREFCNT_inc(keys);
1279 if (! SvTIED_mg((SV*)keys, 'P'))
1284 while (hv_iternext(keys)) i++;
1290 EXTEND(SP, HvKEYS(keys) * (dokeys + dovalues));
1292 PUTBACK; /* hv_iternext and hv_iterval might clobber stack_sp */
1293 while ((entry = hv_iternext(keys))) {
1296 XPUSHs(hv_iterkeysv(entry)); /* won't clobber stack_sp */
1300 hv_iterval(hv,entry) : avhv_iterval((AV*)hv,entry);
1301 DEBUG_H(Perl_sv_setpvf(aTHX_ tmpstr, "%lu%%%d=%lu",
1302 (unsigned long)HeHASH(entry),
1304 (unsigned long)(HeHASH(entry) & HvMAX(keys))));