3 * Copyright (c) 1991-1999, 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 * "I sit beside the fire and think of all that I have seen." --Bilbo
17 static void hv_magic_check _((HV *hv, bool *needs_copy, bool *needs_store));
19 static void hsplit _((HV *hv));
20 static void hfreeentries _((HV *hv));
21 static void more_he _((void));
22 static HEK *save_hek _((const char *str, I32 len, U32 hash));
25 #if defined(STRANGE_MALLOC) || defined(MYMALLOC)
26 # define ARRAY_ALLOC_BYTES(size) ( (size)*sizeof(HE*) )
28 # define MALLOC_OVERHEAD 16
29 # define ARRAY_ALLOC_BYTES(size) ( (size)*sizeof(HE*)*2 - MALLOC_OVERHEAD )
40 PL_he_root = HeNEXT(he);
49 HeNEXT(p) = (HE*)PL_he_root;
59 New(54, PL_he_root, 1008/sizeof(HE), HE);
61 heend = &he[1008 / sizeof(HE) - 1];
63 HeNEXT(he) = (HE*)(he + 1);
70 save_hek(const char *str, I32 len, U32 hash)
75 New(54, k, HEK_BASESIZE + len + 1, char);
77 Copy(str, HEK_KEY(hek), len, char);
78 *(HEK_KEY(hek) + len) = '\0';
87 unsharepvn(HEK_KEY(hek),HEK_LEN(hek),HEK_HASH(hek));
90 /* (klen == HEf_SVKEY) is special for MAGICAL hv entries, meaning key slot
94 hv_fetch(HV *hv, const char *key, U32 klen, I32 lval)
104 if (SvRMAGICAL(hv)) {
105 if (mg_find((SV*)hv,'P')) {
108 mg_copy((SV*)hv, sv, key, klen);
110 return &PL_hv_fetch_sv;
112 #ifdef ENV_IS_CASELESS
113 else if (mg_find((SV*)hv,'E')) {
115 for (i = 0; i < klen; ++i)
116 if (isLOWER(key[i])) {
117 char *nkey = strupr(SvPVX(sv_2mortal(newSVpvn(key,klen))));
118 SV **ret = hv_fetch(hv, nkey, klen, 0);
120 ret = hv_store(hv, key, klen, NEWSV(61,0), 0);
127 xhv = (XPVHV*)SvANY(hv);
128 if (!xhv->xhv_array) {
130 #ifdef DYNAMIC_ENV_FETCH /* if it's an %ENV lookup, we may get it on the fly */
131 || (HvNAME(hv) && strEQ(HvNAME(hv),ENV_HV_NAME))
134 Newz(503,xhv->xhv_array, ARRAY_ALLOC_BYTES(xhv->xhv_max + 1), char);
139 PERL_HASH(hash, key, klen);
141 entry = ((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
142 for (; entry; entry = HeNEXT(entry)) {
143 if (HeHASH(entry) != hash) /* strings can't be equal */
145 if (HeKLEN(entry) != klen)
147 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
149 return &HeVAL(entry);
151 #ifdef DYNAMIC_ENV_FETCH /* %ENV lookup? If so, try to fetch the value now */
152 if (HvNAME(hv) && strEQ(HvNAME(hv),ENV_HV_NAME)) {
154 char *env = PerlEnv_ENVgetenv_len(key,&len);
156 sv = newSVpvn(env,len);
158 return hv_store(hv,key,klen,sv,hash);
162 if (lval) { /* gonna assign to this, so it better be there */
164 return hv_store(hv,key,klen,sv,hash);
169 /* returns a HE * structure with the all fields set */
170 /* note that hent_val will be a mortal sv for MAGICAL hashes */
172 hv_fetch_ent(HV *hv, SV *keysv, I32 lval, register U32 hash)
183 if (SvRMAGICAL(hv)) {
184 if (mg_find((SV*)hv,'P')) {
187 keysv = sv_2mortal(newSVsv(keysv));
188 mg_copy((SV*)hv, sv, (char*)keysv, HEf_SVKEY);
189 if (!HeKEY_hek(&PL_hv_fetch_ent_mh)) {
191 New(54, k, HEK_BASESIZE + sizeof(SV*), char);
192 HeKEY_hek(&PL_hv_fetch_ent_mh) = (HEK*)k;
194 HeSVKEY_set(&PL_hv_fetch_ent_mh, keysv);
195 HeVAL(&PL_hv_fetch_ent_mh) = sv;
196 return &PL_hv_fetch_ent_mh;
198 #ifdef ENV_IS_CASELESS
199 else if (mg_find((SV*)hv,'E')) {
201 key = SvPV(keysv, klen);
202 for (i = 0; i < klen; ++i)
203 if (isLOWER(key[i])) {
204 SV *nkeysv = sv_2mortal(newSVpvn(key,klen));
205 (void)strupr(SvPVX(nkeysv));
206 entry = hv_fetch_ent(hv, nkeysv, 0, 0);
208 entry = hv_store_ent(hv, keysv, NEWSV(61,0), hash);
215 xhv = (XPVHV*)SvANY(hv);
216 if (!xhv->xhv_array) {
218 #ifdef DYNAMIC_ENV_FETCH /* if it's an %ENV lookup, we may get it on the fly */
219 || (HvNAME(hv) && strEQ(HvNAME(hv),ENV_HV_NAME))
222 Newz(503,xhv->xhv_array, ARRAY_ALLOC_BYTES(xhv->xhv_max + 1), char);
227 key = SvPV(keysv, klen);
230 PERL_HASH(hash, key, klen);
232 entry = ((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
233 for (; entry; entry = HeNEXT(entry)) {
234 if (HeHASH(entry) != hash) /* strings can't be equal */
236 if (HeKLEN(entry) != klen)
238 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
242 #ifdef DYNAMIC_ENV_FETCH /* %ENV lookup? If so, try to fetch the value now */
243 if (HvNAME(hv) && strEQ(HvNAME(hv),ENV_HV_NAME)) {
245 char *env = PerlEnv_ENVgetenv_len(key,&len);
247 sv = newSVpvn(env,len);
249 return hv_store_ent(hv,keysv,sv,hash);
253 if (lval) { /* gonna assign to this, so it better be there */
255 return hv_store_ent(hv,keysv,sv,hash);
261 hv_magic_check (HV *hv, bool *needs_copy, bool *needs_store)
263 MAGIC *mg = SvMAGIC(hv);
267 if (isUPPER(mg->mg_type)) {
269 switch (mg->mg_type) {
272 *needs_store = FALSE;
275 mg = mg->mg_moremagic;
280 hv_store(HV *hv, const char *key, U32 klen, SV *val, register U32 hash)
285 register HE **oentry;
290 xhv = (XPVHV*)SvANY(hv);
294 hv_magic_check (hv, &needs_copy, &needs_store);
296 mg_copy((SV*)hv, val, key, klen);
297 if (!xhv->xhv_array && !needs_store)
299 #ifdef ENV_IS_CASELESS
300 else if (mg_find((SV*)hv,'E')) {
301 SV *sv = sv_2mortal(newSVpvn(key,klen));
302 key = strupr(SvPVX(sv));
309 PERL_HASH(hash, key, klen);
312 Newz(505, xhv->xhv_array, ARRAY_ALLOC_BYTES(xhv->xhv_max + 1), char);
314 oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
317 for (entry = *oentry; entry; i=0, entry = HeNEXT(entry)) {
318 if (HeHASH(entry) != hash) /* strings can't be equal */
320 if (HeKLEN(entry) != klen)
322 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
324 SvREFCNT_dec(HeVAL(entry));
326 return &HeVAL(entry);
331 HeKEY_hek(entry) = share_hek(key, klen, hash);
332 else /* gotta do the real thing */
333 HeKEY_hek(entry) = save_hek(key, klen, hash);
335 HeNEXT(entry) = *oentry;
339 if (i) { /* initial entry? */
341 if (xhv->xhv_keys > xhv->xhv_max)
345 return &HeVAL(entry);
349 hv_store_ent(HV *hv, SV *keysv, SV *val, register U32 hash)
356 register HE **oentry;
361 xhv = (XPVHV*)SvANY(hv);
366 hv_magic_check (hv, &needs_copy, &needs_store);
368 bool save_taint = PL_tainted;
370 PL_tainted = SvTAINTED(keysv);
371 keysv = sv_2mortal(newSVsv(keysv));
372 mg_copy((SV*)hv, val, (char*)keysv, HEf_SVKEY);
373 TAINT_IF(save_taint);
374 if (!xhv->xhv_array && !needs_store)
376 #ifdef ENV_IS_CASELESS
377 else if (mg_find((SV*)hv,'E')) {
378 key = SvPV(keysv, klen);
379 keysv = sv_2mortal(newSVpvn(key,klen));
380 (void)strupr(SvPVX(keysv));
387 key = SvPV(keysv, klen);
390 PERL_HASH(hash, key, klen);
393 Newz(505, xhv->xhv_array, ARRAY_ALLOC_BYTES(xhv->xhv_max + 1), char);
395 oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
398 for (entry = *oentry; entry; i=0, entry = HeNEXT(entry)) {
399 if (HeHASH(entry) != hash) /* strings can't be equal */
401 if (HeKLEN(entry) != klen)
403 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
405 SvREFCNT_dec(HeVAL(entry));
412 HeKEY_hek(entry) = share_hek(key, klen, hash);
413 else /* gotta do the real thing */
414 HeKEY_hek(entry) = save_hek(key, klen, hash);
416 HeNEXT(entry) = *oentry;
420 if (i) { /* initial entry? */
422 if (xhv->xhv_keys > xhv->xhv_max)
430 hv_delete(HV *hv, const char *key, U32 klen, I32 flags)
436 register HE **oentry;
442 if (SvRMAGICAL(hv)) {
445 hv_magic_check (hv, &needs_copy, &needs_store);
447 if (needs_copy && (svp = hv_fetch(hv, key, klen, TRUE))) {
451 if (mg_find(sv, 'p')) {
452 sv_unmagic(sv, 'p'); /* No longer an element */
455 return Nullsv; /* element cannot be deleted */
457 #ifdef ENV_IS_CASELESS
458 else if (mg_find((SV*)hv,'E')) {
459 sv = sv_2mortal(newSVpvn(key,klen));
460 key = strupr(SvPVX(sv));
465 xhv = (XPVHV*)SvANY(hv);
469 PERL_HASH(hash, key, klen);
471 oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
474 for (; entry; i=0, oentry = &HeNEXT(entry), entry = *oentry) {
475 if (HeHASH(entry) != hash) /* strings can't be equal */
477 if (HeKLEN(entry) != klen)
479 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
481 *oentry = HeNEXT(entry);
484 if (flags & G_DISCARD)
487 sv = sv_mortalcopy(HeVAL(entry));
488 if (entry == xhv->xhv_eiter)
491 hv_free_ent(hv, entry);
499 hv_delete_ent(HV *hv, SV *keysv, I32 flags, U32 hash)
506 register HE **oentry;
511 if (SvRMAGICAL(hv)) {
514 hv_magic_check (hv, &needs_copy, &needs_store);
516 if (needs_copy && (entry = hv_fetch_ent(hv, keysv, TRUE, hash))) {
520 if (mg_find(sv, 'p')) {
521 sv_unmagic(sv, 'p'); /* No longer an element */
524 return Nullsv; /* element cannot be deleted */
526 #ifdef ENV_IS_CASELESS
527 else if (mg_find((SV*)hv,'E')) {
528 key = SvPV(keysv, klen);
529 keysv = sv_2mortal(newSVpvn(key,klen));
530 (void)strupr(SvPVX(keysv));
536 xhv = (XPVHV*)SvANY(hv);
540 key = SvPV(keysv, klen);
543 PERL_HASH(hash, key, klen);
545 oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
548 for (; entry; i=0, oentry = &HeNEXT(entry), entry = *oentry) {
549 if (HeHASH(entry) != hash) /* strings can't be equal */
551 if (HeKLEN(entry) != klen)
553 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
555 *oentry = HeNEXT(entry);
558 if (flags & G_DISCARD)
561 sv = sv_mortalcopy(HeVAL(entry));
562 if (entry == xhv->xhv_eiter)
565 hv_free_ent(hv, entry);
573 hv_exists(HV *hv, const char *key, U32 klen)
583 if (SvRMAGICAL(hv)) {
584 if (mg_find((SV*)hv,'P')) {
587 mg_copy((SV*)hv, sv, key, klen);
588 magic_existspack(sv, mg_find(sv, 'p'));
591 #ifdef ENV_IS_CASELESS
592 else if (mg_find((SV*)hv,'E')) {
593 sv = sv_2mortal(newSVpvn(key,klen));
594 key = strupr(SvPVX(sv));
599 xhv = (XPVHV*)SvANY(hv);
600 #ifndef DYNAMIC_ENV_FETCH
605 PERL_HASH(hash, key, klen);
607 #ifdef DYNAMIC_ENV_FETCH
608 if (!xhv->xhv_array) entry = Null(HE*);
611 entry = ((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
612 for (; entry; entry = HeNEXT(entry)) {
613 if (HeHASH(entry) != hash) /* strings can't be equal */
615 if (HeKLEN(entry) != klen)
617 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
621 #ifdef DYNAMIC_ENV_FETCH /* is it out there? */
622 if (HvNAME(hv) && strEQ(HvNAME(hv), ENV_HV_NAME)) {
624 char *env = PerlEnv_ENVgetenv_len(key,&len);
626 sv = newSVpvn(env,len);
628 (void)hv_store(hv,key,klen,sv,hash);
638 hv_exists_ent(HV *hv, SV *keysv, U32 hash)
649 if (SvRMAGICAL(hv)) {
650 if (mg_find((SV*)hv,'P')) {
651 dTHR; /* just for SvTRUE */
653 keysv = sv_2mortal(newSVsv(keysv));
654 mg_copy((SV*)hv, sv, (char*)keysv, HEf_SVKEY);
655 magic_existspack(sv, mg_find(sv, 'p'));
658 #ifdef ENV_IS_CASELESS
659 else if (mg_find((SV*)hv,'E')) {
660 key = SvPV(keysv, klen);
661 keysv = sv_2mortal(newSVpvn(key,klen));
662 (void)strupr(SvPVX(keysv));
668 xhv = (XPVHV*)SvANY(hv);
669 #ifndef DYNAMIC_ENV_FETCH
674 key = SvPV(keysv, klen);
676 PERL_HASH(hash, key, klen);
678 #ifdef DYNAMIC_ENV_FETCH
679 if (!xhv->xhv_array) entry = Null(HE*);
682 entry = ((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
683 for (; entry; entry = HeNEXT(entry)) {
684 if (HeHASH(entry) != hash) /* strings can't be equal */
686 if (HeKLEN(entry) != klen)
688 if (memNE(HeKEY(entry),key,klen)) /* is this it? */
692 #ifdef DYNAMIC_ENV_FETCH /* is it out there? */
693 if (HvNAME(hv) && strEQ(HvNAME(hv), ENV_HV_NAME)) {
695 char *env = PerlEnv_ENVgetenv_len(key,&len);
697 sv = newSVpvn(env,len);
699 (void)hv_store_ent(hv,keysv,sv,hash);
710 register XPVHV* xhv = (XPVHV*)SvANY(hv);
711 I32 oldsize = (I32) xhv->xhv_max + 1; /* sic(k) */
712 register I32 newsize = oldsize * 2;
714 register char *a = xhv->xhv_array;
718 register HE **oentry;
721 #if defined(STRANGE_MALLOC) || defined(MYMALLOC)
722 Renew(a, ARRAY_ALLOC_BYTES(newsize), char);
728 #define MALLOC_OVERHEAD 16
729 New(2, a, ARRAY_ALLOC_BYTES(newsize), char);
734 Copy(xhv->xhv_array, a, oldsize * sizeof(HE*), char);
736 offer_nice_chunk(xhv->xhv_array, ARRAY_ALLOC_BYTES(oldsize));
739 Safefree(xhv->xhv_array);
743 Zero(&a[oldsize * sizeof(HE*)], (newsize-oldsize) * sizeof(HE*), char); /* zero 2nd half*/
744 xhv->xhv_max = --newsize;
748 for (i=0; i<oldsize; i++,aep++) {
749 if (!*aep) /* non-existent */
752 for (oentry = aep, entry = *aep; entry; entry = *oentry) {
753 if ((HeHASH(entry) & newsize) != i) {
754 *oentry = HeNEXT(entry);
755 HeNEXT(entry) = *bep;
762 oentry = &HeNEXT(entry);
764 if (!*aep) /* everything moved */
770 hv_ksplit(HV *hv, IV newmax)
772 register XPVHV* xhv = (XPVHV*)SvANY(hv);
773 I32 oldsize = (I32) xhv->xhv_max + 1; /* sic(k) */
774 register I32 newsize;
780 register HE **oentry;
782 newsize = (I32) newmax; /* possible truncation here */
783 if (newsize != newmax || newmax <= oldsize)
785 while ((newsize & (1 + ~newsize)) != newsize) {
786 newsize &= ~(newsize & (1 + ~newsize)); /* get proper power of 2 */
788 if (newsize < newmax)
790 if (newsize < newmax)
791 return; /* overflow detection */
796 #if defined(STRANGE_MALLOC) || defined(MYMALLOC)
797 Renew(a, ARRAY_ALLOC_BYTES(newsize), char);
803 New(2, a, ARRAY_ALLOC_BYTES(newsize), char);
808 Copy(xhv->xhv_array, a, oldsize * sizeof(HE*), char);
810 offer_nice_chunk(xhv->xhv_array, ARRAY_ALLOC_BYTES(oldsize));
813 Safefree(xhv->xhv_array);
816 Zero(&a[oldsize * sizeof(HE*)], (newsize-oldsize) * sizeof(HE*), char); /* zero 2nd half*/
819 Newz(0, a, ARRAY_ALLOC_BYTES(newsize), char);
821 xhv->xhv_max = --newsize;
823 if (!xhv->xhv_fill) /* skip rest if no entries */
827 for (i=0; i<oldsize; i++,aep++) {
828 if (!*aep) /* non-existent */
830 for (oentry = aep, entry = *aep; entry; entry = *oentry) {
831 if ((j = (HeHASH(entry) & newsize)) != i) {
833 *oentry = HeNEXT(entry);
834 if (!(HeNEXT(entry) = aep[j]))
840 oentry = &HeNEXT(entry);
842 if (!*aep) /* everything moved */
853 hv = (HV*)NEWSV(502,0);
854 sv_upgrade((SV *)hv, SVt_PVHV);
855 xhv = (XPVHV*)SvANY(hv);
858 #ifndef NODEFAULT_SHAREKEYS
859 HvSHAREKEYS_on(hv); /* key-sharing on by default */
861 xhv->xhv_max = 7; /* start with 8 buckets */
864 (void)hv_iterinit(hv); /* so each() will start off right */
872 STRLEN hv_max = ohv ? HvMAX(ohv) : 0;
873 STRLEN hv_fill = ohv ? HvFILL(ohv) : 0;
876 while (hv_max && hv_max + 1 >= hv_fill * 2)
877 hv_max = hv_max / 2; /* Is always 2^n-1 */
883 if (! SvTIED_mg((SV*)ohv, 'P')) {
890 I32 hv_riter = HvRITER(ohv); /* current root of iterator */
891 HE *hv_eiter = HvEITER(ohv); /* current entry of iterator */
895 while (entry = hv_iternext(ohv)) {
896 hv_store(hv, HeKEY(entry), HeKLEN(entry),
897 SvREFCNT_inc(HeVAL(entry)), HeHASH(entry));
899 HvRITER(ohv) = hv_riter;
900 HvEITER(ohv) = hv_eiter;
907 hv_free_ent(HV *hv, register HE *entry)
914 if (val && isGV(val) && GvCVu(val) && HvNAME(hv))
915 PL_sub_generation++; /* may be deletion of method from stash */
917 if (HeKLEN(entry) == HEf_SVKEY) {
918 SvREFCNT_dec(HeKEY_sv(entry));
919 Safefree(HeKEY_hek(entry));
921 else if (HvSHAREKEYS(hv))
922 unshare_hek(HeKEY_hek(entry));
924 Safefree(HeKEY_hek(entry));
929 hv_delayfree_ent(HV *hv, register HE *entry)
933 if (isGV(HeVAL(entry)) && GvCVu(HeVAL(entry)) && HvNAME(hv))
934 PL_sub_generation++; /* may be deletion of method from stash */
935 sv_2mortal(HeVAL(entry)); /* free between statements */
936 if (HeKLEN(entry) == HEf_SVKEY) {
937 sv_2mortal(HeKEY_sv(entry));
938 Safefree(HeKEY_hek(entry));
940 else if (HvSHAREKEYS(hv))
941 unshare_hek(HeKEY_hek(entry));
943 Safefree(HeKEY_hek(entry));
953 xhv = (XPVHV*)SvANY(hv);
958 (void)memzero(xhv->xhv_array, (xhv->xhv_max + 1) * sizeof(HE*));
969 register HE *oentry = Null(HE*);
985 entry = HeNEXT(entry);
986 hv_free_ent(hv, oentry);
991 entry = array[riter];
994 (void)hv_iterinit(hv);
1000 register XPVHV* xhv;
1003 xhv = (XPVHV*)SvANY(hv);
1005 Safefree(xhv->xhv_array);
1007 Safefree(HvNAME(hv));
1011 xhv->xhv_max = 7; /* it's a normal hash */
1022 register XPVHV* xhv;
1027 xhv = (XPVHV*)SvANY(hv);
1028 entry = xhv->xhv_eiter;
1029 if (entry && HvLAZYDEL(hv)) { /* was deleted earlier? */
1031 hv_free_ent(hv, entry);
1033 xhv->xhv_riter = -1;
1034 xhv->xhv_eiter = Null(HE*);
1035 return xhv->xhv_keys; /* used to be xhv->xhv_fill before 5.004_65 */
1041 register XPVHV* xhv;
1048 xhv = (XPVHV*)SvANY(hv);
1049 oldentry = entry = xhv->xhv_eiter;
1051 if (mg = SvTIED_mg((SV*)hv, 'P')) {
1052 SV *key = sv_newmortal();
1054 sv_setsv(key, HeSVKEY_force(entry));
1055 SvREFCNT_dec(HeSVKEY(entry)); /* get rid of previous key */
1061 xhv->xhv_eiter = entry = new_he(); /* one HE per MAGICAL hash */
1063 Newz(54, k, HEK_BASESIZE + sizeof(SV*), char);
1065 HeKEY_hek(entry) = hek;
1066 HeKLEN(entry) = HEf_SVKEY;
1068 magic_nextpack((SV*) hv,mg,key);
1070 /* force key to stay around until next time */
1071 HeSVKEY_set(entry, SvREFCNT_inc(key));
1072 return entry; /* beware, hent_val is not set */
1075 SvREFCNT_dec(HeVAL(entry));
1076 Safefree(HeKEY_hek(entry));
1078 xhv->xhv_eiter = Null(HE*);
1081 #ifdef DYNAMIC_ENV_FETCH /* set up %ENV for iteration */
1082 if (!entry && HvNAME(hv) && strEQ(HvNAME(hv), ENV_HV_NAME))
1086 if (!xhv->xhv_array)
1087 Newz(506,xhv->xhv_array, ARRAY_ALLOC_BYTES(xhv->xhv_max + 1), char);
1089 entry = HeNEXT(entry);
1092 if (xhv->xhv_riter > xhv->xhv_max) {
1093 xhv->xhv_riter = -1;
1096 entry = ((HE**)xhv->xhv_array)[xhv->xhv_riter];
1099 if (oldentry && HvLAZYDEL(hv)) { /* was deleted earlier? */
1101 hv_free_ent(hv, oldentry);
1104 xhv->xhv_eiter = entry;
1109 hv_iterkey(register HE *entry, I32 *retlen)
1111 if (HeKLEN(entry) == HEf_SVKEY) {
1113 char *p = SvPV(HeKEY_sv(entry), len);
1118 *retlen = HeKLEN(entry);
1119 return HeKEY(entry);
1123 /* unlike hv_iterval(), this always returns a mortal copy of the key */
1125 hv_iterkeysv(register HE *entry)
1127 if (HeKLEN(entry) == HEf_SVKEY)
1128 return sv_mortalcopy(HeKEY_sv(entry));
1130 return sv_2mortal(newSVpvn((HeKLEN(entry) ? HeKEY(entry) : ""),
1135 hv_iterval(HV *hv, register HE *entry)
1137 if (SvRMAGICAL(hv)) {
1138 if (mg_find((SV*)hv,'P')) {
1139 SV* sv = sv_newmortal();
1140 if (HeKLEN(entry) == HEf_SVKEY)
1141 mg_copy((SV*)hv, sv, (char*)HeKEY_sv(entry), HEf_SVKEY);
1142 else mg_copy((SV*)hv, sv, HeKEY(entry), HeKLEN(entry));
1146 return HeVAL(entry);
1150 hv_iternextsv(HV *hv, char **key, I32 *retlen)
1153 if ( (he = hv_iternext(hv)) == NULL)
1155 *key = hv_iterkey(he, retlen);
1156 return hv_iterval(hv, he);
1160 hv_magic(HV *hv, GV *gv, int how)
1162 sv_magic((SV*)hv, (SV*)gv, how, Nullch, 0);
1166 sharepvn(const char *sv, I32 len, U32 hash)
1168 return HEK_KEY(share_hek(sv, len, hash));
1171 /* possibly free a shared string if no one has access to it
1172 * len and hash must both be valid for str.
1175 unsharepvn(const char *str, I32 len, U32 hash)
1177 register XPVHV* xhv;
1179 register HE **oentry;
1183 /* what follows is the moral equivalent of:
1184 if ((Svp = hv_fetch(PL_strtab, tmpsv, FALSE, hash))) {
1185 if (--*Svp == Nullsv)
1186 hv_delete(PL_strtab, str, len, G_DISCARD, hash);
1188 xhv = (XPVHV*)SvANY(PL_strtab);
1189 /* assert(xhv_array != 0) */
1191 oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
1192 for (entry = *oentry; entry; i=0, oentry = &HeNEXT(entry), entry = *oentry) {
1193 if (HeHASH(entry) != hash) /* strings can't be equal */
1195 if (HeKLEN(entry) != len)
1197 if (memNE(HeKEY(entry),str,len)) /* is this it? */
1200 if (--HeVAL(entry) == Nullsv) {
1201 *oentry = HeNEXT(entry);
1204 Safefree(HeKEY_hek(entry));
1210 UNLOCK_STRTAB_MUTEX;
1213 warn("Attempt to free non-existent shared string");
1216 /* get a (constant) string ptr from the global string table
1217 * string will get added if it is not already there.
1218 * len and hash must both be valid for str.
1221 share_hek(const char *str, I32 len, register U32 hash)
1223 register XPVHV* xhv;
1225 register HE **oentry;
1229 /* what follows is the moral equivalent of:
1231 if (!(Svp = hv_fetch(PL_strtab, str, len, FALSE)))
1232 hv_store(PL_strtab, str, len, Nullsv, hash);
1234 xhv = (XPVHV*)SvANY(PL_strtab);
1235 /* assert(xhv_array != 0) */
1237 oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
1238 for (entry = *oentry; entry; i=0, entry = HeNEXT(entry)) {
1239 if (HeHASH(entry) != hash) /* strings can't be equal */
1241 if (HeKLEN(entry) != len)
1243 if (memNE(HeKEY(entry),str,len)) /* is this it? */
1250 HeKEY_hek(entry) = save_hek(str, len, hash);
1251 HeVAL(entry) = Nullsv;
1252 HeNEXT(entry) = *oentry;
1255 if (i) { /* initial entry? */
1257 if (xhv->xhv_keys > xhv->xhv_max)
1262 ++HeVAL(entry); /* use value slot as REFCNT */
1263 UNLOCK_STRTAB_MUTEX;
1264 return HeKEY_hek(entry);