Fix a path in the release guide
[perl.git] / hv.c
1 /*    hv.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
4  *    2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 by Larry Wall and others
5  *
6  *    You may distribute under the terms of either the GNU General Public
7  *    License or the Artistic License, as specified in the README file.
8  *
9  */
10
11 /*
12  *      I sit beside the fire and think
13  *          of all that I have seen.
14  *                         --Bilbo
15  *
16  *     [p.278 of _The Lord of the Rings_, II/iii: "The Ring Goes South"]
17  */
18
19 /* 
20 =head1 Hash Manipulation Functions
21
22 A HV structure represents a Perl hash. It consists mainly of an array
23 of pointers, each of which points to a linked list of HE structures. The
24 array is indexed by the hash function of the key, so each linked list
25 represents all the hash entries with the same hash value. Each HE contains
26 a pointer to the actual value, plus a pointer to a HEK structure which
27 holds the key and hash value.
28
29 =cut
30
31 */
32
33 #include "EXTERN.h"
34 #define PERL_IN_HV_C
35 #define PERL_HASH_INTERNAL_ACCESS
36 #include "perl.h"
37
38 #define HV_MAX_LENGTH_BEFORE_SPLIT 14
39
40 static const char S_strtab_error[]
41     = "Cannot modify shared string table in hv_%s";
42
43 #ifdef PURIFY
44
45 #define new_HE() (HE*)safemalloc(sizeof(HE))
46 #define del_HE(p) safefree((char*)p)
47
48 #else
49
50 STATIC HE*
51 S_new_he(pTHX)
52 {
53     dVAR;
54     HE* he;
55     void ** const root = &PL_body_roots[HE_SVSLOT];
56
57     if (!*root)
58         Perl_more_bodies(aTHX_ HE_SVSLOT, sizeof(HE), PERL_ARENA_SIZE);
59     he = (HE*) *root;
60     assert(he);
61     *root = HeNEXT(he);
62     return he;
63 }
64
65 #define new_HE() new_he()
66 #define del_HE(p) \
67     STMT_START { \
68         HeNEXT(p) = (HE*)(PL_body_roots[HE_SVSLOT]);    \
69         PL_body_roots[HE_SVSLOT] = p; \
70     } STMT_END
71
72
73
74 #endif
75
76 STATIC HEK *
77 S_save_hek_flags(const char *str, I32 len, U32 hash, int flags)
78 {
79     const int flags_masked = flags & HVhek_MASK;
80     char *k;
81     register HEK *hek;
82
83     PERL_ARGS_ASSERT_SAVE_HEK_FLAGS;
84
85     Newx(k, HEK_BASESIZE + len + 2, char);
86     hek = (HEK*)k;
87     Copy(str, HEK_KEY(hek), len, char);
88     HEK_KEY(hek)[len] = 0;
89     HEK_LEN(hek) = len;
90     HEK_HASH(hek) = hash;
91     HEK_FLAGS(hek) = (unsigned char)flags_masked | HVhek_UNSHARED;
92
93     if (flags & HVhek_FREEKEY)
94         Safefree(str);
95     return hek;
96 }
97
98 /* free the pool of temporary HE/HEK pairs returned by hv_fetch_ent
99  * for tied hashes */
100
101 void
102 Perl_free_tied_hv_pool(pTHX)
103 {
104     dVAR;
105     HE *he = PL_hv_fetch_ent_mh;
106     while (he) {
107         HE * const ohe = he;
108         Safefree(HeKEY_hek(he));
109         he = HeNEXT(he);
110         del_HE(ohe);
111     }
112     PL_hv_fetch_ent_mh = NULL;
113 }
114
115 #if defined(USE_ITHREADS)
116 HEK *
117 Perl_hek_dup(pTHX_ HEK *source, CLONE_PARAMS* param)
118 {
119     HEK *shared;
120
121     PERL_ARGS_ASSERT_HEK_DUP;
122     PERL_UNUSED_ARG(param);
123
124     if (!source)
125         return NULL;
126
127     shared = (HEK*)ptr_table_fetch(PL_ptr_table, source);
128     if (shared) {
129         /* We already shared this hash key.  */
130         (void)share_hek_hek(shared);
131     }
132     else {
133         shared
134             = share_hek_flags(HEK_KEY(source), HEK_LEN(source),
135                               HEK_HASH(source), HEK_FLAGS(source));
136         ptr_table_store(PL_ptr_table, source, shared);
137     }
138     return shared;
139 }
140
141 HE *
142 Perl_he_dup(pTHX_ const HE *e, bool shared, CLONE_PARAMS* param)
143 {
144     HE *ret;
145
146     PERL_ARGS_ASSERT_HE_DUP;
147
148     if (!e)
149         return NULL;
150     /* look for it in the table first */
151     ret = (HE*)ptr_table_fetch(PL_ptr_table, e);
152     if (ret)
153         return ret;
154
155     /* create anew and remember what it is */
156     ret = new_HE();
157     ptr_table_store(PL_ptr_table, e, ret);
158
159     HeNEXT(ret) = he_dup(HeNEXT(e),shared, param);
160     if (HeKLEN(e) == HEf_SVKEY) {
161         char *k;
162         Newx(k, HEK_BASESIZE + sizeof(const SV *), char);
163         HeKEY_hek(ret) = (HEK*)k;
164         HeKEY_sv(ret) = sv_dup_inc(HeKEY_sv(e), param);
165     }
166     else if (shared) {
167         /* This is hek_dup inlined, which seems to be important for speed
168            reasons.  */
169         HEK * const source = HeKEY_hek(e);
170         HEK *shared = (HEK*)ptr_table_fetch(PL_ptr_table, source);
171
172         if (shared) {
173             /* We already shared this hash key.  */
174             (void)share_hek_hek(shared);
175         }
176         else {
177             shared
178                 = share_hek_flags(HEK_KEY(source), HEK_LEN(source),
179                                   HEK_HASH(source), HEK_FLAGS(source));
180             ptr_table_store(PL_ptr_table, source, shared);
181         }
182         HeKEY_hek(ret) = shared;
183     }
184     else
185         HeKEY_hek(ret) = save_hek_flags(HeKEY(e), HeKLEN(e), HeHASH(e),
186                                         HeKFLAGS(e));
187     HeVAL(ret) = sv_dup_inc(HeVAL(e), param);
188     return ret;
189 }
190 #endif  /* USE_ITHREADS */
191
192 static void
193 S_hv_notallowed(pTHX_ int flags, const char *key, I32 klen,
194                 const char *msg)
195 {
196     SV * const sv = sv_newmortal();
197
198     PERL_ARGS_ASSERT_HV_NOTALLOWED;
199
200     if (!(flags & HVhek_FREEKEY)) {
201         sv_setpvn(sv, key, klen);
202     }
203     else {
204         /* Need to free saved eventually assign to mortal SV */
205         /* XXX is this line an error ???:  SV *sv = sv_newmortal(); */
206         sv_usepvn(sv, (char *) key, klen);
207     }
208     if (flags & HVhek_UTF8) {
209         SvUTF8_on(sv);
210     }
211     Perl_croak(aTHX_ msg, SVfARG(sv));
212 }
213
214 /* (klen == HEf_SVKEY) is special for MAGICAL hv entries, meaning key slot
215  * contains an SV* */
216
217 /*
218 =for apidoc hv_store
219
220 Stores an SV in a hash.  The hash key is specified as C<key> and the
221 absolute value of C<klen> is the length of the key.  If C<klen> is
222 negative the key is assumed to be in UTF-8-encoded Unicode.  The
223 C<hash> parameter is the precomputed hash value; if it is zero then
224 Perl will compute it.
225
226 The return value will be
227 NULL if the operation failed or if the value did not need to be actually
228 stored within the hash (as in the case of tied hashes).  Otherwise it can
229 be dereferenced to get the original C<SV*>.  Note that the caller is
230 responsible for suitably incrementing the reference count of C<val> before
231 the call, and decrementing it if the function returned NULL.  Effectively
232 a successful hv_store takes ownership of one reference to C<val>.  This is
233 usually what you want; a newly created SV has a reference count of one, so
234 if all your code does is create SVs then store them in a hash, hv_store
235 will own the only reference to the new SV, and your code doesn't need to do
236 anything further to tidy up.  hv_store is not implemented as a call to
237 hv_store_ent, and does not create a temporary SV for the key, so if your
238 key data is not already in SV form then use hv_store in preference to
239 hv_store_ent.
240
241 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
242 information on how to use this function on tied hashes.
243
244 =for apidoc hv_store_ent
245
246 Stores C<val> in a hash.  The hash key is specified as C<key>.  The C<hash>
247 parameter is the precomputed hash value; if it is zero then Perl will
248 compute it.  The return value is the new hash entry so created.  It will be
249 NULL if the operation failed or if the value did not need to be actually
250 stored within the hash (as in the case of tied hashes).  Otherwise the
251 contents of the return value can be accessed using the C<He?> macros
252 described here.  Note that the caller is responsible for suitably
253 incrementing the reference count of C<val> before the call, and
254 decrementing it if the function returned NULL.  Effectively a successful
255 hv_store_ent takes ownership of one reference to C<val>.  This is
256 usually what you want; a newly created SV has a reference count of one, so
257 if all your code does is create SVs then store them in a hash, hv_store
258 will own the only reference to the new SV, and your code doesn't need to do
259 anything further to tidy up.  Note that hv_store_ent only reads the C<key>;
260 unlike C<val> it does not take ownership of it, so maintaining the correct
261 reference count on C<key> is entirely the caller's responsibility.  hv_store
262 is not implemented as a call to hv_store_ent, and does not create a temporary
263 SV for the key, so if your key data is not already in SV form then use
264 hv_store in preference to hv_store_ent.
265
266 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
267 information on how to use this function on tied hashes.
268
269 =for apidoc hv_exists
270
271 Returns a boolean indicating whether the specified hash key exists.  The
272 absolute value of C<klen> is the length of the key.  If C<klen> is
273 negative the key is assumed to be in UTF-8-encoded Unicode.
274
275 =for apidoc hv_fetch
276
277 Returns the SV which corresponds to the specified key in the hash.
278 The absolute value of C<klen> is the length of the key.  If C<klen> is
279 negative the key is assumed to be in UTF-8-encoded Unicode.  If
280 C<lval> is set then the fetch will be part of a store.  Check that the
281 return value is non-null before dereferencing it to an C<SV*>.
282
283 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
284 information on how to use this function on tied hashes.
285
286 =for apidoc hv_exists_ent
287
288 Returns a boolean indicating whether the specified hash key exists. C<hash>
289 can be a valid precomputed hash value, or 0 to ask for it to be
290 computed.
291
292 =cut
293 */
294
295 /* returns an HE * structure with the all fields set */
296 /* note that hent_val will be a mortal sv for MAGICAL hashes */
297 /*
298 =for apidoc hv_fetch_ent
299
300 Returns the hash entry which corresponds to the specified key in the hash.
301 C<hash> must be a valid precomputed hash number for the given C<key>, or 0
302 if you want the function to compute it.  IF C<lval> is set then the fetch
303 will be part of a store.  Make sure the return value is non-null before
304 accessing it.  The return value when C<hv> is a tied hash is a pointer to a
305 static location, so be sure to make a copy of the structure if you need to
306 store it somewhere.
307
308 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
309 information on how to use this function on tied hashes.
310
311 =cut
312 */
313
314 /* Common code for hv_delete()/hv_exists()/hv_fetch()/hv_store()  */
315 void *
316 Perl_hv_common_key_len(pTHX_ HV *hv, const char *key, I32 klen_i32,
317                        const int action, SV *val, const U32 hash)
318 {
319     STRLEN klen;
320     int flags;
321
322     PERL_ARGS_ASSERT_HV_COMMON_KEY_LEN;
323
324     if (klen_i32 < 0) {
325         klen = -klen_i32;
326         flags = HVhek_UTF8;
327     } else {
328         klen = klen_i32;
329         flags = 0;
330     }
331     return hv_common(hv, NULL, key, klen, flags, action, val, hash);
332 }
333
334 void *
335 Perl_hv_common(pTHX_ HV *hv, SV *keysv, const char *key, STRLEN klen,
336                int flags, int action, SV *val, register U32 hash)
337 {
338     dVAR;
339     XPVHV* xhv;
340     HE *entry;
341     HE **oentry;
342     SV *sv;
343     bool is_utf8;
344     int masked_flags;
345     const int return_svp = action & HV_FETCH_JUST_SV;
346
347     if (!hv)
348         return NULL;
349     if (SvTYPE(hv) == (svtype)SVTYPEMASK)
350         return NULL;
351
352     assert(SvTYPE(hv) == SVt_PVHV);
353
354     if (SvSMAGICAL(hv) && SvGMAGICAL(hv) && !(action & HV_DISABLE_UVAR_XKEY)) {
355         MAGIC* mg;
356         if ((mg = mg_find((const SV *)hv, PERL_MAGIC_uvar))) {
357             struct ufuncs * const uf = (struct ufuncs *)mg->mg_ptr;
358             if (uf->uf_set == NULL) {
359                 SV* obj = mg->mg_obj;
360
361                 if (!keysv) {
362                     keysv = newSVpvn_flags(key, klen, SVs_TEMP |
363                                            ((flags & HVhek_UTF8)
364                                             ? SVf_UTF8 : 0));
365                 }
366                 
367                 mg->mg_obj = keysv;         /* pass key */
368                 uf->uf_index = action;      /* pass action */
369                 magic_getuvar(MUTABLE_SV(hv), mg);
370                 keysv = mg->mg_obj;         /* may have changed */
371                 mg->mg_obj = obj;
372
373                 /* If the key may have changed, then we need to invalidate
374                    any passed-in computed hash value.  */
375                 hash = 0;
376             }
377         }
378     }
379     if (keysv) {
380         if (flags & HVhek_FREEKEY)
381             Safefree(key);
382         key = SvPV_const(keysv, klen);
383         is_utf8 = (SvUTF8(keysv) != 0);
384         if (SvIsCOW_shared_hash(keysv)) {
385             flags = HVhek_KEYCANONICAL | (is_utf8 ? HVhek_UTF8 : 0);
386         } else {
387             flags = 0;
388         }
389     } else {
390         is_utf8 = ((flags & HVhek_UTF8) ? TRUE : FALSE);
391     }
392
393     if (action & HV_DELETE) {
394         return (void *) hv_delete_common(hv, keysv, key, klen,
395                                          flags | (is_utf8 ? HVhek_UTF8 : 0),
396                                          action, hash);
397     }
398
399     xhv = (XPVHV*)SvANY(hv);
400     if (SvMAGICAL(hv)) {
401         if (SvRMAGICAL(hv) && !(action & (HV_FETCH_ISSTORE|HV_FETCH_ISEXISTS))) {
402             if (mg_find((const SV *)hv, PERL_MAGIC_tied)
403                 || SvGMAGICAL((const SV *)hv))
404             {
405                 /* FIXME should be able to skimp on the HE/HEK here when
406                    HV_FETCH_JUST_SV is true.  */
407                 if (!keysv) {
408                     keysv = newSVpvn_utf8(key, klen, is_utf8);
409                 } else {
410                     keysv = newSVsv(keysv);
411                 }
412                 sv = sv_newmortal();
413                 mg_copy(MUTABLE_SV(hv), sv, (char *)keysv, HEf_SVKEY);
414
415                 /* grab a fake HE/HEK pair from the pool or make a new one */
416                 entry = PL_hv_fetch_ent_mh;
417                 if (entry)
418                     PL_hv_fetch_ent_mh = HeNEXT(entry);
419                 else {
420                     char *k;
421                     entry = new_HE();
422                     Newx(k, HEK_BASESIZE + sizeof(const SV *), char);
423                     HeKEY_hek(entry) = (HEK*)k;
424                 }
425                 HeNEXT(entry) = NULL;
426                 HeSVKEY_set(entry, keysv);
427                 HeVAL(entry) = sv;
428                 sv_upgrade(sv, SVt_PVLV);
429                 LvTYPE(sv) = 'T';
430                  /* so we can free entry when freeing sv */
431                 LvTARG(sv) = MUTABLE_SV(entry);
432
433                 /* XXX remove at some point? */
434                 if (flags & HVhek_FREEKEY)
435                     Safefree(key);
436
437                 if (return_svp) {
438                     return entry ? (void *) &HeVAL(entry) : NULL;
439                 }
440                 return (void *) entry;
441             }
442 #ifdef ENV_IS_CASELESS
443             else if (mg_find((const SV *)hv, PERL_MAGIC_env)) {
444                 U32 i;
445                 for (i = 0; i < klen; ++i)
446                     if (isLOWER(key[i])) {
447                         /* Would be nice if we had a routine to do the
448                            copy and upercase in a single pass through.  */
449                         const char * const nkey = strupr(savepvn(key,klen));
450                         /* Note that this fetch is for nkey (the uppercased
451                            key) whereas the store is for key (the original)  */
452                         void *result = hv_common(hv, NULL, nkey, klen,
453                                                  HVhek_FREEKEY, /* free nkey */
454                                                  0 /* non-LVAL fetch */
455                                                  | HV_DISABLE_UVAR_XKEY
456                                                  | return_svp,
457                                                  NULL /* no value */,
458                                                  0 /* compute hash */);
459                         if (!result && (action & HV_FETCH_LVALUE)) {
460                             /* This call will free key if necessary.
461                                Do it this way to encourage compiler to tail
462                                call optimise.  */
463                             result = hv_common(hv, keysv, key, klen, flags,
464                                                HV_FETCH_ISSTORE
465                                                | HV_DISABLE_UVAR_XKEY
466                                                | return_svp,
467                                                newSV(0), hash);
468                         } else {
469                             if (flags & HVhek_FREEKEY)
470                                 Safefree(key);
471                         }
472                         return result;
473                     }
474             }
475 #endif
476         } /* ISFETCH */
477         else if (SvRMAGICAL(hv) && (action & HV_FETCH_ISEXISTS)) {
478             if (mg_find((const SV *)hv, PERL_MAGIC_tied)
479                 || SvGMAGICAL((const SV *)hv)) {
480                 /* I don't understand why hv_exists_ent has svret and sv,
481                    whereas hv_exists only had one.  */
482                 SV * const svret = sv_newmortal();
483                 sv = sv_newmortal();
484
485                 if (keysv || is_utf8) {
486                     if (!keysv) {
487                         keysv = newSVpvn_utf8(key, klen, TRUE);
488                     } else {
489                         keysv = newSVsv(keysv);
490                     }
491                     mg_copy(MUTABLE_SV(hv), sv, (char *)sv_2mortal(keysv), HEf_SVKEY);
492                 } else {
493                     mg_copy(MUTABLE_SV(hv), sv, key, klen);
494                 }
495                 if (flags & HVhek_FREEKEY)
496                     Safefree(key);
497                 magic_existspack(svret, mg_find(sv, PERL_MAGIC_tiedelem));
498                 /* This cast somewhat evil, but I'm merely using NULL/
499                    not NULL to return the boolean exists.
500                    And I know hv is not NULL.  */
501                 return SvTRUE(svret) ? (void *)hv : NULL;
502                 }
503 #ifdef ENV_IS_CASELESS
504             else if (mg_find((const SV *)hv, PERL_MAGIC_env)) {
505                 /* XXX This code isn't UTF8 clean.  */
506                 char * const keysave = (char * const)key;
507                 /* Will need to free this, so set FREEKEY flag.  */
508                 key = savepvn(key,klen);
509                 key = (const char*)strupr((char*)key);
510                 is_utf8 = FALSE;
511                 hash = 0;
512                 keysv = 0;
513
514                 if (flags & HVhek_FREEKEY) {
515                     Safefree(keysave);
516                 }
517                 flags |= HVhek_FREEKEY;
518             }
519 #endif
520         } /* ISEXISTS */
521         else if (action & HV_FETCH_ISSTORE) {
522             bool needs_copy;
523             bool needs_store;
524             hv_magic_check (hv, &needs_copy, &needs_store);
525             if (needs_copy) {
526                 const bool save_taint = PL_tainted;
527                 if (keysv || is_utf8) {
528                     if (!keysv) {
529                         keysv = newSVpvn_utf8(key, klen, TRUE);
530                     }
531                     if (PL_tainting)
532                         PL_tainted = SvTAINTED(keysv);
533                     keysv = sv_2mortal(newSVsv(keysv));
534                     mg_copy(MUTABLE_SV(hv), val, (char*)keysv, HEf_SVKEY);
535                 } else {
536                     mg_copy(MUTABLE_SV(hv), val, key, klen);
537                 }
538
539                 TAINT_IF(save_taint);
540                 if (!needs_store) {
541                     if (flags & HVhek_FREEKEY)
542                         Safefree(key);
543                     return NULL;
544                 }
545 #ifdef ENV_IS_CASELESS
546                 else if (mg_find((const SV *)hv, PERL_MAGIC_env)) {
547                     /* XXX This code isn't UTF8 clean.  */
548                     const char *keysave = key;
549                     /* Will need to free this, so set FREEKEY flag.  */
550                     key = savepvn(key,klen);
551                     key = (const char*)strupr((char*)key);
552                     is_utf8 = FALSE;
553                     hash = 0;
554                     keysv = 0;
555
556                     if (flags & HVhek_FREEKEY) {
557                         Safefree(keysave);
558                     }
559                     flags |= HVhek_FREEKEY;
560                 }
561 #endif
562             }
563         } /* ISSTORE */
564     } /* SvMAGICAL */
565
566     if (!HvARRAY(hv)) {
567         if ((action & (HV_FETCH_LVALUE | HV_FETCH_ISSTORE))
568 #ifdef DYNAMIC_ENV_FETCH  /* if it's an %ENV lookup, we may get it on the fly */
569                  || (SvRMAGICAL((const SV *)hv)
570                      && mg_find((const SV *)hv, PERL_MAGIC_env))
571 #endif
572                                                                   ) {
573             char *array;
574             Newxz(array,
575                  PERL_HV_ARRAY_ALLOC_BYTES(xhv->xhv_max+1 /* HvMAX(hv)+1 */),
576                  char);
577             HvARRAY(hv) = (HE**)array;
578         }
579 #ifdef DYNAMIC_ENV_FETCH
580         else if (action & HV_FETCH_ISEXISTS) {
581             /* for an %ENV exists, if we do an insert it's by a recursive
582                store call, so avoid creating HvARRAY(hv) right now.  */
583         }
584 #endif
585         else {
586             /* XXX remove at some point? */
587             if (flags & HVhek_FREEKEY)
588                 Safefree(key);
589
590             return NULL;
591         }
592     }
593
594     if (is_utf8 & !(flags & HVhek_KEYCANONICAL)) {
595         char * const keysave = (char *)key;
596         key = (char*)bytes_from_utf8((U8*)key, &klen, &is_utf8);
597         if (is_utf8)
598             flags |= HVhek_UTF8;
599         else
600             flags &= ~HVhek_UTF8;
601         if (key != keysave) {
602             if (flags & HVhek_FREEKEY)
603                 Safefree(keysave);
604             flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
605             /* If the caller calculated a hash, it was on the sequence of
606                octets that are the UTF-8 form. We've now changed the sequence
607                of octets stored to that of the equivalent byte representation,
608                so the hash we need is different.  */
609             hash = 0;
610         }
611     }
612
613     if (HvREHASH(hv) || (!hash && !(keysv && (SvIsCOW_shared_hash(keysv)))))
614         PERL_HASH_INTERNAL_(hash, key, klen, HvREHASH(hv));
615     else if (!hash)
616         hash = SvSHARED_HASH(keysv);
617
618     /* We don't have a pointer to the hv, so we have to replicate the
619        flag into every HEK, so that hv_iterkeysv can see it.
620        And yes, you do need this even though you are not "storing" because
621        you can flip the flags below if doing an lval lookup.  (And that
622        was put in to give the semantics Andreas was expecting.)  */
623     if (HvREHASH(hv))
624         flags |= HVhek_REHASH;
625
626     masked_flags = (flags & HVhek_MASK);
627
628 #ifdef DYNAMIC_ENV_FETCH
629     if (!HvARRAY(hv)) entry = NULL;
630     else
631 #endif
632     {
633         entry = (HvARRAY(hv))[hash & (I32) HvMAX(hv)];
634     }
635     for (; entry; entry = HeNEXT(entry)) {
636         if (HeHASH(entry) != hash)              /* strings can't be equal */
637             continue;
638         if (HeKLEN(entry) != (I32)klen)
639             continue;
640         if (HeKEY(entry) != key && memNE(HeKEY(entry),key,klen))        /* is this it? */
641             continue;
642         if ((HeKFLAGS(entry) ^ masked_flags) & HVhek_UTF8)
643             continue;
644
645         if (action & (HV_FETCH_LVALUE|HV_FETCH_ISSTORE)) {
646             if (HeKFLAGS(entry) != masked_flags) {
647                 /* We match if HVhek_UTF8 bit in our flags and hash key's
648                    match.  But if entry was set previously with HVhek_WASUTF8
649                    and key now doesn't (or vice versa) then we should change
650                    the key's flag, as this is assignment.  */
651                 if (HvSHAREKEYS(hv)) {
652                     /* Need to swap the key we have for a key with the flags we
653                        need. As keys are shared we can't just write to the
654                        flag, so we share the new one, unshare the old one.  */
655                     HEK * const new_hek = share_hek_flags(key, klen, hash,
656                                                    masked_flags);
657                     unshare_hek (HeKEY_hek(entry));
658                     HeKEY_hek(entry) = new_hek;
659                 }
660                 else if (hv == PL_strtab) {
661                     /* PL_strtab is usually the only hash without HvSHAREKEYS,
662                        so putting this test here is cheap  */
663                     if (flags & HVhek_FREEKEY)
664                         Safefree(key);
665                     Perl_croak(aTHX_ S_strtab_error,
666                                action & HV_FETCH_LVALUE ? "fetch" : "store");
667                 }
668                 else
669                     HeKFLAGS(entry) = masked_flags;
670                 if (masked_flags & HVhek_ENABLEHVKFLAGS)
671                     HvHASKFLAGS_on(hv);
672             }
673             if (HeVAL(entry) == &PL_sv_placeholder) {
674                 /* yes, can store into placeholder slot */
675                 if (action & HV_FETCH_LVALUE) {
676                     if (SvMAGICAL(hv)) {
677                         /* This preserves behaviour with the old hv_fetch
678                            implementation which at this point would bail out
679                            with a break; (at "if we find a placeholder, we
680                            pretend we haven't found anything")
681
682                            That break mean that if a placeholder were found, it
683                            caused a call into hv_store, which in turn would
684                            check magic, and if there is no magic end up pretty
685                            much back at this point (in hv_store's code).  */
686                         break;
687                     }
688                     /* LVAL fetch which actually needs a store.  */
689                     val = newSV(0);
690                     HvPLACEHOLDERS(hv)--;
691                 } else {
692                     /* store */
693                     if (val != &PL_sv_placeholder)
694                         HvPLACEHOLDERS(hv)--;
695                 }
696                 HeVAL(entry) = val;
697             } else if (action & HV_FETCH_ISSTORE) {
698                 SvREFCNT_dec(HeVAL(entry));
699                 HeVAL(entry) = val;
700             }
701         } else if (HeVAL(entry) == &PL_sv_placeholder) {
702             /* if we find a placeholder, we pretend we haven't found
703                anything */
704             break;
705         }
706         if (flags & HVhek_FREEKEY)
707             Safefree(key);
708         if (return_svp) {
709             return entry ? (void *) &HeVAL(entry) : NULL;
710         }
711         return entry;
712     }
713 #ifdef DYNAMIC_ENV_FETCH  /* %ENV lookup?  If so, try to fetch the value now */
714     if (!(action & HV_FETCH_ISSTORE) 
715         && SvRMAGICAL((const SV *)hv)
716         && mg_find((const SV *)hv, PERL_MAGIC_env)) {
717         unsigned long len;
718         const char * const env = PerlEnv_ENVgetenv_len(key,&len);
719         if (env) {
720             sv = newSVpvn(env,len);
721             SvTAINTED_on(sv);
722             return hv_common(hv, keysv, key, klen, flags,
723                              HV_FETCH_ISSTORE|HV_DISABLE_UVAR_XKEY|return_svp,
724                              sv, hash);
725         }
726     }
727 #endif
728
729     if (!entry && SvREADONLY(hv) && !(action & HV_FETCH_ISEXISTS)) {
730         hv_notallowed(flags, key, klen,
731                         "Attempt to access disallowed key '%"SVf"' in"
732                         " a restricted hash");
733     }
734     if (!(action & (HV_FETCH_LVALUE|HV_FETCH_ISSTORE))) {
735         /* Not doing some form of store, so return failure.  */
736         if (flags & HVhek_FREEKEY)
737             Safefree(key);
738         return NULL;
739     }
740     if (action & HV_FETCH_LVALUE) {
741         val = action & HV_FETCH_EMPTY_HE ? NULL : newSV(0);
742         if (SvMAGICAL(hv)) {
743             /* At this point the old hv_fetch code would call to hv_store,
744                which in turn might do some tied magic. So we need to make that
745                magic check happen.  */
746             /* gonna assign to this, so it better be there */
747             /* If a fetch-as-store fails on the fetch, then the action is to
748                recurse once into "hv_store". If we didn't do this, then that
749                recursive call would call the key conversion routine again.
750                However, as we replace the original key with the converted
751                key, this would result in a double conversion, which would show
752                up as a bug if the conversion routine is not idempotent.  */
753             return hv_common(hv, keysv, key, klen, flags,
754                              HV_FETCH_ISSTORE|HV_DISABLE_UVAR_XKEY|return_svp,
755                              val, hash);
756             /* XXX Surely that could leak if the fetch-was-store fails?
757                Just like the hv_fetch.  */
758         }
759     }
760
761     /* Welcome to hv_store...  */
762
763     if (!HvARRAY(hv)) {
764         /* Not sure if we can get here.  I think the only case of oentry being
765            NULL is for %ENV with dynamic env fetch.  But that should disappear
766            with magic in the previous code.  */
767         char *array;
768         Newxz(array,
769              PERL_HV_ARRAY_ALLOC_BYTES(xhv->xhv_max+1 /* HvMAX(hv)+1 */),
770              char);
771         HvARRAY(hv) = (HE**)array;
772     }
773
774     oentry = &(HvARRAY(hv))[hash & (I32) xhv->xhv_max];
775
776     entry = new_HE();
777     /* share_hek_flags will do the free for us.  This might be considered
778        bad API design.  */
779     if (HvSHAREKEYS(hv))
780         HeKEY_hek(entry) = share_hek_flags(key, klen, hash, flags);
781     else if (hv == PL_strtab) {
782         /* PL_strtab is usually the only hash without HvSHAREKEYS, so putting
783            this test here is cheap  */
784         if (flags & HVhek_FREEKEY)
785             Safefree(key);
786         Perl_croak(aTHX_ S_strtab_error,
787                    action & HV_FETCH_LVALUE ? "fetch" : "store");
788     }
789     else                                       /* gotta do the real thing */
790         HeKEY_hek(entry) = save_hek_flags(key, klen, hash, flags);
791     HeVAL(entry) = val;
792     HeNEXT(entry) = *oentry;
793     *oentry = entry;
794
795     if (val == &PL_sv_placeholder)
796         HvPLACEHOLDERS(hv)++;
797     if (masked_flags & HVhek_ENABLEHVKFLAGS)
798         HvHASKFLAGS_on(hv);
799
800     {
801         const HE *counter = HeNEXT(entry);
802
803         xhv->xhv_keys++; /* HvTOTALKEYS(hv)++ */
804         if (!counter) {                         /* initial entry? */
805         } else if (xhv->xhv_keys > xhv->xhv_max) {
806                 /* Use only the old HvUSEDKEYS(hv) > HvMAX(hv) condition to limit
807                    bucket splits on a rehashed hash, as we're not going to
808                    split it again, and if someone is lucky (evil) enough to
809                    get all the keys in one list they could exhaust our memory
810                    as we repeatedly double the number of buckets on every
811                    entry. Linear search feels a less worse thing to do.  */
812             hsplit(hv);
813         } else if(!HvREHASH(hv)) {
814             U32 n_links = 1;
815
816             while ((counter = HeNEXT(counter)))
817                 n_links++;
818
819             if (n_links > HV_MAX_LENGTH_BEFORE_SPLIT) {
820                 hsplit(hv);
821             }
822         }
823     }
824
825     if (return_svp) {
826         return entry ? (void *) &HeVAL(entry) : NULL;
827     }
828     return (void *) entry;
829 }
830
831 STATIC void
832 S_hv_magic_check(HV *hv, bool *needs_copy, bool *needs_store)
833 {
834     const MAGIC *mg = SvMAGIC(hv);
835
836     PERL_ARGS_ASSERT_HV_MAGIC_CHECK;
837
838     *needs_copy = FALSE;
839     *needs_store = TRUE;
840     while (mg) {
841         if (isUPPER(mg->mg_type)) {
842             *needs_copy = TRUE;
843             if (mg->mg_type == PERL_MAGIC_tied) {
844                 *needs_store = FALSE;
845                 return; /* We've set all there is to set. */
846             }
847         }
848         mg = mg->mg_moremagic;
849     }
850 }
851
852 /*
853 =for apidoc hv_scalar
854
855 Evaluates the hash in scalar context and returns the result. Handles magic when the hash is tied.
856
857 =cut
858 */
859
860 SV *
861 Perl_hv_scalar(pTHX_ HV *hv)
862 {
863     SV *sv;
864
865     PERL_ARGS_ASSERT_HV_SCALAR;
866
867     if (SvRMAGICAL(hv)) {
868         MAGIC * const mg = mg_find((const SV *)hv, PERL_MAGIC_tied);
869         if (mg)
870             return magic_scalarpack(hv, mg);
871     }
872
873     sv = sv_newmortal();
874     if (HvTOTALKEYS((const HV *)hv)) 
875         Perl_sv_setpvf(aTHX_ sv, "%ld/%ld",
876                 (long)HvFILL(hv), (long)HvMAX(hv) + 1);
877     else
878         sv_setiv(sv, 0);
879     
880     return sv;
881 }
882
883 /*
884 =for apidoc hv_delete
885
886 Deletes a key/value pair in the hash.  The value's SV is removed from
887 the hash, made mortal, and returned to the caller.  The absolute
888 value of C<klen> is the length of the key.  If C<klen> is negative the
889 key is assumed to be in UTF-8-encoded Unicode.  The C<flags> value
890 will normally be zero; if set to G_DISCARD then NULL will be returned.
891 NULL will also be returned if the key is not found.
892
893 =for apidoc hv_delete_ent
894
895 Deletes a key/value pair in the hash.  The value SV is removed from the hash,
896 made mortal, and returned to the caller.  The C<flags> value will normally be
897 zero; if set to G_DISCARD then NULL will be returned.  NULL will also be
898 returned if the key is not found.  C<hash> can be a valid precomputed hash
899 value, or 0 to ask for it to be computed.
900
901 =cut
902 */
903
904 STATIC SV *
905 S_hv_delete_common(pTHX_ HV *hv, SV *keysv, const char *key, STRLEN klen,
906                    int k_flags, I32 d_flags, U32 hash)
907 {
908     dVAR;
909     register XPVHV* xhv;
910     register HE *entry;
911     register HE **oentry;
912     bool is_utf8 = (k_flags & HVhek_UTF8) ? TRUE : FALSE;
913     int masked_flags;
914
915     if (SvRMAGICAL(hv)) {
916         bool needs_copy;
917         bool needs_store;
918         hv_magic_check (hv, &needs_copy, &needs_store);
919
920         if (needs_copy) {
921             SV *sv;
922             entry = (HE *) hv_common(hv, keysv, key, klen,
923                                      k_flags & ~HVhek_FREEKEY,
924                                      HV_FETCH_LVALUE|HV_DISABLE_UVAR_XKEY,
925                                      NULL, hash);
926             sv = entry ? HeVAL(entry) : NULL;
927             if (sv) {
928                 if (SvMAGICAL(sv)) {
929                     mg_clear(sv);
930                 }
931                 if (!needs_store) {
932                     if (mg_find(sv, PERL_MAGIC_tiedelem)) {
933                         /* No longer an element */
934                         sv_unmagic(sv, PERL_MAGIC_tiedelem);
935                         return sv;
936                     }           
937                     return NULL;                /* element cannot be deleted */
938                 }
939 #ifdef ENV_IS_CASELESS
940                 else if (mg_find((const SV *)hv, PERL_MAGIC_env)) {
941                     /* XXX This code isn't UTF8 clean.  */
942                     keysv = newSVpvn_flags(key, klen, SVs_TEMP);
943                     if (k_flags & HVhek_FREEKEY) {
944                         Safefree(key);
945                     }
946                     key = strupr(SvPVX(keysv));
947                     is_utf8 = 0;
948                     k_flags = 0;
949                     hash = 0;
950                 }
951 #endif
952             }
953         }
954     }
955     xhv = (XPVHV*)SvANY(hv);
956     if (!HvARRAY(hv))
957         return NULL;
958
959     if (is_utf8) {
960         const char * const keysave = key;
961         key = (char*)bytes_from_utf8((U8*)key, &klen, &is_utf8);
962
963         if (is_utf8)
964             k_flags |= HVhek_UTF8;
965         else
966             k_flags &= ~HVhek_UTF8;
967         if (key != keysave) {
968             if (k_flags & HVhek_FREEKEY) {
969                 /* This shouldn't happen if our caller does what we expect,
970                    but strictly the API allows it.  */
971                 Safefree(keysave);
972             }
973             k_flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
974         }
975         HvHASKFLAGS_on(MUTABLE_SV(hv));
976     }
977
978     if (HvREHASH(hv) || (!hash && !(keysv && (SvIsCOW_shared_hash(keysv)))))
979         PERL_HASH_INTERNAL_(hash, key, klen, HvREHASH(hv));
980     else if (!hash)
981         hash = SvSHARED_HASH(keysv);
982
983     masked_flags = (k_flags & HVhek_MASK);
984
985     oentry = &(HvARRAY(hv))[hash & (I32) HvMAX(hv)];
986     entry = *oentry;
987     for (; entry; oentry = &HeNEXT(entry), entry = *oentry) {
988         SV *sv;
989         U8 mro_changes = 0; /* 1 = isa; 2 = package moved */
990         GV *gv = NULL;
991         HV *stash = NULL;
992
993         if (HeHASH(entry) != hash)              /* strings can't be equal */
994             continue;
995         if (HeKLEN(entry) != (I32)klen)
996             continue;
997         if (HeKEY(entry) != key && memNE(HeKEY(entry),key,klen))        /* is this it? */
998             continue;
999         if ((HeKFLAGS(entry) ^ masked_flags) & HVhek_UTF8)
1000             continue;
1001
1002         if (hv == PL_strtab) {
1003             if (k_flags & HVhek_FREEKEY)
1004                 Safefree(key);
1005             Perl_croak(aTHX_ S_strtab_error, "delete");
1006         }
1007
1008         /* if placeholder is here, it's already been deleted.... */
1009         if (HeVAL(entry) == &PL_sv_placeholder) {
1010             if (k_flags & HVhek_FREEKEY)
1011                 Safefree(key);
1012             return NULL;
1013         }
1014         if (SvREADONLY(hv) && HeVAL(entry) && SvREADONLY(HeVAL(entry))
1015          && !SvIsCOW(HeVAL(entry))) {
1016             hv_notallowed(k_flags, key, klen,
1017                             "Attempt to delete readonly key '%"SVf"' from"
1018                             " a restricted hash");
1019         }
1020         if (k_flags & HVhek_FREEKEY)
1021             Safefree(key);
1022
1023         /* If this is a stash and the key ends with ::, then someone is 
1024          * deleting a package.
1025          */
1026         if (HeVAL(entry) && HvENAME_get(hv)) {
1027                 gv = (GV *)HeVAL(entry);
1028                 if (keysv) key = SvPV(keysv, klen);
1029                 if ((
1030                      (klen > 1 && key[klen-2] == ':' && key[klen-1] == ':')
1031                       ||
1032                      (klen == 1 && key[0] == ':')
1033                     )
1034                  && (klen != 6 || hv!=PL_defstash || memNE(key,"main::",6))
1035                  && SvTYPE(gv) == SVt_PVGV && (stash = GvHV((GV *)gv))
1036                  && HvENAME_get(stash)) {
1037                         /* A previous version of this code checked that the
1038                          * GV was still in the symbol table by fetching the
1039                          * GV with its name. That is not necessary (and
1040                          * sometimes incorrect), as HvENAME cannot be set
1041                          * on hv if it is not in the symtab. */
1042                         mro_changes = 2;
1043                         /* Hang on to it for a bit. */
1044                         SvREFCNT_inc_simple_void_NN(
1045                          sv_2mortal((SV *)gv)
1046                         );
1047                 }
1048                 else if (klen == 3 && strnEQ(key, "ISA", 3))
1049                     mro_changes = 1;
1050         }
1051
1052         if (d_flags & G_DISCARD) {
1053             sv = HeVAL(entry);
1054             HeVAL(entry) = &PL_sv_placeholder;
1055             if (sv) {
1056                 /* deletion of method from stash */
1057                 if (isGV(sv) && isGV_with_GP(sv) && GvCVu(sv)
1058                  && HvENAME_get(hv))
1059                     mro_method_changed_in(hv);
1060                 SvREFCNT_dec(sv);
1061                 sv = NULL;
1062             }
1063         }
1064         else {
1065             sv = sv_2mortal(HeVAL(entry));
1066             HeVAL(entry) = &PL_sv_placeholder;
1067         }
1068
1069         /*
1070          * If a restricted hash, rather than really deleting the entry, put
1071          * a placeholder there. This marks the key as being "approved", so
1072          * we can still access via not-really-existing key without raising
1073          * an error.
1074          */
1075         if (SvREADONLY(hv))
1076             /* We'll be saving this slot, so the number of allocated keys
1077              * doesn't go down, but the number placeholders goes up */
1078             HvPLACEHOLDERS(hv)++;
1079         else {
1080             *oentry = HeNEXT(entry);
1081             if (SvOOK(hv) && entry == HvAUX(hv)->xhv_eiter /* HvEITER(hv) */)
1082                 HvLAZYDEL_on(hv);
1083             else {
1084                 if (SvOOK(hv) && HvLAZYDEL(hv) &&
1085                     entry == HeNEXT(HvAUX(hv)->xhv_eiter))
1086                     HeNEXT(HvAUX(hv)->xhv_eiter) = HeNEXT(entry);
1087                 hv_free_ent(hv, entry);
1088             }
1089             xhv->xhv_keys--; /* HvTOTALKEYS(hv)-- */
1090             if (xhv->xhv_keys == 0)
1091                 HvHASKFLAGS_off(hv);
1092         }
1093
1094         if (mro_changes == 1) mro_isa_changed_in(hv);
1095         else if (mro_changes == 2)
1096             mro_package_moved(NULL, stash, gv, 1);
1097
1098         return sv;
1099     }
1100     if (SvREADONLY(hv)) {
1101         hv_notallowed(k_flags, key, klen,
1102                         "Attempt to delete disallowed key '%"SVf"' from"
1103                         " a restricted hash");
1104     }
1105
1106     if (k_flags & HVhek_FREEKEY)
1107         Safefree(key);
1108     return NULL;
1109 }
1110
1111 STATIC void
1112 S_hsplit(pTHX_ HV *hv)
1113 {
1114     dVAR;
1115     register XPVHV* const xhv = (XPVHV*)SvANY(hv);
1116     const I32 oldsize = (I32) xhv->xhv_max+1; /* HvMAX(hv)+1 (sick) */
1117     register I32 newsize = oldsize * 2;
1118     register I32 i;
1119     char *a = (char*) HvARRAY(hv);
1120     register HE **aep;
1121     int longest_chain = 0;
1122     int was_shared;
1123
1124     PERL_ARGS_ASSERT_HSPLIT;
1125
1126     /*PerlIO_printf(PerlIO_stderr(), "hsplit called for %p which had %d\n",
1127       (void*)hv, (int) oldsize);*/
1128
1129     if (HvPLACEHOLDERS_get(hv) && !SvREADONLY(hv)) {
1130       /* Can make this clear any placeholders first for non-restricted hashes,
1131          even though Storable rebuilds restricted hashes by putting in all the
1132          placeholders (first) before turning on the readonly flag, because
1133          Storable always pre-splits the hash.  */
1134       hv_clear_placeholders(hv);
1135     }
1136                
1137     PL_nomemok = TRUE;
1138 #if defined(STRANGE_MALLOC) || defined(MYMALLOC)
1139     Renew(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize)
1140           + (SvOOK(hv) ? sizeof(struct xpvhv_aux) : 0), char);
1141     if (!a) {
1142       PL_nomemok = FALSE;
1143       return;
1144     }
1145     if (SvOOK(hv)) {
1146         Move(&a[oldsize * sizeof(HE*)], &a[newsize * sizeof(HE*)], 1, struct xpvhv_aux);
1147     }
1148 #else
1149     Newx(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize)
1150         + (SvOOK(hv) ? sizeof(struct xpvhv_aux) : 0), char);
1151     if (!a) {
1152       PL_nomemok = FALSE;
1153       return;
1154     }
1155     Copy(HvARRAY(hv), a, oldsize * sizeof(HE*), char);
1156     if (SvOOK(hv)) {
1157         Copy(HvAUX(hv), &a[newsize * sizeof(HE*)], 1, struct xpvhv_aux);
1158     }
1159     Safefree(HvARRAY(hv));
1160 #endif
1161
1162     PL_nomemok = FALSE;
1163     Zero(&a[oldsize * sizeof(HE*)], (newsize-oldsize) * sizeof(HE*), char);     /* zero 2nd half*/
1164     xhv->xhv_max = --newsize;   /* HvMAX(hv) = --newsize */
1165     HvARRAY(hv) = (HE**) a;
1166     aep = (HE**)a;
1167
1168     for (i=0; i<oldsize; i++,aep++) {
1169         int left_length = 0;
1170         int right_length = 0;
1171         HE **oentry = aep;
1172         HE *entry = *aep;
1173         register HE **bep;
1174
1175         if (!entry)                             /* non-existent */
1176             continue;
1177         bep = aep+oldsize;
1178         do {
1179             if ((HeHASH(entry) & newsize) != (U32)i) {
1180                 *oentry = HeNEXT(entry);
1181                 HeNEXT(entry) = *bep;
1182                 *bep = entry;
1183                 right_length++;
1184             }
1185             else {
1186                 oentry = &HeNEXT(entry);
1187                 left_length++;
1188             }
1189             entry = *oentry;
1190         } while (entry);
1191         /* I think we don't actually need to keep track of the longest length,
1192            merely flag if anything is too long. But for the moment while
1193            developing this code I'll track it.  */
1194         if (left_length > longest_chain)
1195             longest_chain = left_length;
1196         if (right_length > longest_chain)
1197             longest_chain = right_length;
1198     }
1199
1200
1201     /* Pick your policy for "hashing isn't working" here:  */
1202     if (longest_chain <= HV_MAX_LENGTH_BEFORE_SPLIT /* split worked?  */
1203         || HvREHASH(hv)) {
1204         return;
1205     }
1206
1207     if (hv == PL_strtab) {
1208         /* Urg. Someone is doing something nasty to the string table.
1209            Can't win.  */
1210         return;
1211     }
1212
1213     /* Awooga. Awooga. Pathological data.  */
1214     /*PerlIO_printf(PerlIO_stderr(), "%p %d of %d with %d/%d buckets\n", (void*)hv,
1215       longest_chain, HvTOTALKEYS(hv), HvFILL(hv),  1+HvMAX(hv));*/
1216
1217     ++newsize;
1218     Newxz(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize)
1219          + (SvOOK(hv) ? sizeof(struct xpvhv_aux) : 0), char);
1220     if (SvOOK(hv)) {
1221         Copy(HvAUX(hv), &a[newsize * sizeof(HE*)], 1, struct xpvhv_aux);
1222     }
1223
1224     was_shared = HvSHAREKEYS(hv);
1225
1226     HvSHAREKEYS_off(hv);
1227     HvREHASH_on(hv);
1228
1229     aep = HvARRAY(hv);
1230
1231     for (i=0; i<newsize; i++,aep++) {
1232         register HE *entry = *aep;
1233         while (entry) {
1234             /* We're going to trash this HE's next pointer when we chain it
1235                into the new hash below, so store where we go next.  */
1236             HE * const next = HeNEXT(entry);
1237             UV hash;
1238             HE **bep;
1239
1240             /* Rehash it */
1241             PERL_HASH_INTERNAL(hash, HeKEY(entry), HeKLEN(entry));
1242
1243             if (was_shared) {
1244                 /* Unshare it.  */
1245                 HEK * const new_hek
1246                     = save_hek_flags(HeKEY(entry), HeKLEN(entry),
1247                                      hash, HeKFLAGS(entry));
1248                 unshare_hek (HeKEY_hek(entry));
1249                 HeKEY_hek(entry) = new_hek;
1250             } else {
1251                 /* Not shared, so simply write the new hash in. */
1252                 HeHASH(entry) = hash;
1253             }
1254             /*PerlIO_printf(PerlIO_stderr(), "%d ", HeKFLAGS(entry));*/
1255             HEK_REHASH_on(HeKEY_hek(entry));
1256             /*PerlIO_printf(PerlIO_stderr(), "%d\n", HeKFLAGS(entry));*/
1257
1258             /* Copy oentry to the correct new chain.  */
1259             bep = ((HE**)a) + (hash & (I32) xhv->xhv_max);
1260             HeNEXT(entry) = *bep;
1261             *bep = entry;
1262
1263             entry = next;
1264         }
1265     }
1266     Safefree (HvARRAY(hv));
1267     HvARRAY(hv) = (HE **)a;
1268 }
1269
1270 void
1271 Perl_hv_ksplit(pTHX_ HV *hv, IV newmax)
1272 {
1273     dVAR;
1274     register XPVHV* xhv = (XPVHV*)SvANY(hv);
1275     const I32 oldsize = (I32) xhv->xhv_max+1; /* HvMAX(hv)+1 (sick) */
1276     register I32 newsize;
1277     register I32 i;
1278     register char *a;
1279     register HE **aep;
1280
1281     PERL_ARGS_ASSERT_HV_KSPLIT;
1282
1283     newsize = (I32) newmax;                     /* possible truncation here */
1284     if (newsize != newmax || newmax <= oldsize)
1285         return;
1286     while ((newsize & (1 + ~newsize)) != newsize) {
1287         newsize &= ~(newsize & (1 + ~newsize)); /* get proper power of 2 */
1288     }
1289     if (newsize < newmax)
1290         newsize *= 2;
1291     if (newsize < newmax)
1292         return;                                 /* overflow detection */
1293
1294     a = (char *) HvARRAY(hv);
1295     if (a) {
1296         PL_nomemok = TRUE;
1297 #if defined(STRANGE_MALLOC) || defined(MYMALLOC)
1298         Renew(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize)
1299               + (SvOOK(hv) ? sizeof(struct xpvhv_aux) : 0), char);
1300         if (!a) {
1301           PL_nomemok = FALSE;
1302           return;
1303         }
1304         if (SvOOK(hv)) {
1305             Copy(&a[oldsize * sizeof(HE*)], &a[newsize * sizeof(HE*)], 1, struct xpvhv_aux);
1306         }
1307 #else
1308         Newx(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize)
1309             + (SvOOK(hv) ? sizeof(struct xpvhv_aux) : 0), char);
1310         if (!a) {
1311           PL_nomemok = FALSE;
1312           return;
1313         }
1314         Copy(HvARRAY(hv), a, oldsize * sizeof(HE*), char);
1315         if (SvOOK(hv)) {
1316             Copy(HvAUX(hv), &a[newsize * sizeof(HE*)], 1, struct xpvhv_aux);
1317         }
1318         Safefree(HvARRAY(hv));
1319 #endif
1320         PL_nomemok = FALSE;
1321         Zero(&a[oldsize * sizeof(HE*)], (newsize-oldsize) * sizeof(HE*), char); /* zero 2nd half*/
1322     }
1323     else {
1324         Newxz(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize), char);
1325     }
1326     xhv->xhv_max = --newsize;   /* HvMAX(hv) = --newsize */
1327     HvARRAY(hv) = (HE **) a;
1328     if (!xhv->xhv_keys /* !HvTOTALKEYS(hv) */)  /* skip rest if no entries */
1329         return;
1330
1331     aep = (HE**)a;
1332     for (i=0; i<oldsize; i++,aep++) {
1333         HE **oentry = aep;
1334         HE *entry = *aep;
1335
1336         if (!entry)                             /* non-existent */
1337             continue;
1338         do {
1339             register I32 j = (HeHASH(entry) & newsize);
1340
1341             if (j != i) {
1342                 j -= i;
1343                 *oentry = HeNEXT(entry);
1344                 HeNEXT(entry) = aep[j];
1345                 aep[j] = entry;
1346             }
1347             else
1348                 oentry = &HeNEXT(entry);
1349             entry = *oentry;
1350         } while (entry);
1351     }
1352 }
1353
1354 HV *
1355 Perl_newHVhv(pTHX_ HV *ohv)
1356 {
1357     dVAR;
1358     HV * const hv = newHV();
1359     STRLEN hv_max;
1360
1361     if (!ohv || !HvTOTALKEYS(ohv))
1362         return hv;
1363     hv_max = HvMAX(ohv);
1364
1365     if (!SvMAGICAL((const SV *)ohv)) {
1366         /* It's an ordinary hash, so copy it fast. AMS 20010804 */
1367         STRLEN i;
1368         const bool shared = !!HvSHAREKEYS(ohv);
1369         HE **ents, ** const oents = (HE **)HvARRAY(ohv);
1370         char *a;
1371         Newx(a, PERL_HV_ARRAY_ALLOC_BYTES(hv_max+1), char);
1372         ents = (HE**)a;
1373
1374         /* In each bucket... */
1375         for (i = 0; i <= hv_max; i++) {
1376             HE *prev = NULL;
1377             HE *oent = oents[i];
1378
1379             if (!oent) {
1380                 ents[i] = NULL;
1381                 continue;
1382             }
1383
1384             /* Copy the linked list of entries. */
1385             for (; oent; oent = HeNEXT(oent)) {
1386                 const U32 hash   = HeHASH(oent);
1387                 const char * const key = HeKEY(oent);
1388                 const STRLEN len = HeKLEN(oent);
1389                 const int flags  = HeKFLAGS(oent);
1390                 HE * const ent   = new_HE();
1391                 SV *const val    = HeVAL(oent);
1392
1393                 HeVAL(ent) = SvIMMORTAL(val) ? val : newSVsv(val);
1394                 HeKEY_hek(ent)
1395                     = shared ? share_hek_flags(key, len, hash, flags)
1396                              :  save_hek_flags(key, len, hash, flags);
1397                 if (prev)
1398                     HeNEXT(prev) = ent;
1399                 else
1400                     ents[i] = ent;
1401                 prev = ent;
1402                 HeNEXT(ent) = NULL;
1403             }
1404         }
1405
1406         HvMAX(hv)   = hv_max;
1407         HvTOTALKEYS(hv)  = HvTOTALKEYS(ohv);
1408         HvARRAY(hv) = ents;
1409     } /* not magical */
1410     else {
1411         /* Iterate over ohv, copying keys and values one at a time. */
1412         HE *entry;
1413         const I32 riter = HvRITER_get(ohv);
1414         HE * const eiter = HvEITER_get(ohv);
1415         STRLEN hv_fill = HvFILL(ohv);
1416
1417         /* Can we use fewer buckets? (hv_max is always 2^n-1) */
1418         while (hv_max && hv_max + 1 >= hv_fill * 2)
1419             hv_max = hv_max / 2;
1420         HvMAX(hv) = hv_max;
1421
1422         hv_iterinit(ohv);
1423         while ((entry = hv_iternext_flags(ohv, 0))) {
1424             SV *const val = HeVAL(entry);
1425             (void)hv_store_flags(hv, HeKEY(entry), HeKLEN(entry),
1426                                  SvIMMORTAL(val) ? val : newSVsv(val),
1427                                  HeHASH(entry), HeKFLAGS(entry));
1428         }
1429         HvRITER_set(ohv, riter);
1430         HvEITER_set(ohv, eiter);
1431     }
1432
1433     return hv;
1434 }
1435
1436 /*
1437 =for apidoc Am|HV *|hv_copy_hints_hv|HV *ohv
1438
1439 A specialised version of L</newHVhv> for copying C<%^H>.  I<ohv> must be
1440 a pointer to a hash (which may have C<%^H> magic, but should be generally
1441 non-magical), or C<NULL> (interpreted as an empty hash).  The content
1442 of I<ohv> is copied to a new hash, which has the C<%^H>-specific magic
1443 added to it.  A pointer to the new hash is returned.
1444
1445 =cut
1446 */
1447
1448 HV *
1449 Perl_hv_copy_hints_hv(pTHX_ HV *const ohv)
1450 {
1451     HV * const hv = newHV();
1452
1453     if (ohv && HvTOTALKEYS(ohv)) {
1454         STRLEN hv_max = HvMAX(ohv);
1455         STRLEN hv_fill = HvFILL(ohv);
1456         HE *entry;
1457         const I32 riter = HvRITER_get(ohv);
1458         HE * const eiter = HvEITER_get(ohv);
1459
1460         while (hv_max && hv_max + 1 >= hv_fill * 2)
1461             hv_max = hv_max / 2;
1462         HvMAX(hv) = hv_max;
1463
1464         hv_iterinit(ohv);
1465         while ((entry = hv_iternext_flags(ohv, 0))) {
1466             SV *const sv = newSVsv(HeVAL(entry));
1467             SV *heksv = newSVhek(HeKEY_hek(entry));
1468             sv_magic(sv, NULL, PERL_MAGIC_hintselem,
1469                      (char *)heksv, HEf_SVKEY);
1470             SvREFCNT_dec(heksv);
1471             (void)hv_store_flags(hv, HeKEY(entry), HeKLEN(entry),
1472                                  sv, HeHASH(entry), HeKFLAGS(entry));
1473         }
1474         HvRITER_set(ohv, riter);
1475         HvEITER_set(ohv, eiter);
1476     }
1477     hv_magic(hv, NULL, PERL_MAGIC_hints);
1478     return hv;
1479 }
1480
1481 /* like hv_free_ent, but returns the SV rather than freeing it */
1482 STATIC SV*
1483 S_hv_free_ent_ret(pTHX_ HV *hv, register HE *entry)
1484 {
1485     dVAR;
1486     SV *val;
1487
1488     PERL_ARGS_ASSERT_HV_FREE_ENT_RET;
1489
1490     if (!entry)
1491         return NULL;
1492     val = HeVAL(entry);
1493     if (val && isGV(val) && isGV_with_GP(val) && GvCVu(val) && HvENAME(hv))
1494         mro_method_changed_in(hv);      /* deletion of method from stash */
1495     if (HeKLEN(entry) == HEf_SVKEY) {
1496         SvREFCNT_dec(HeKEY_sv(entry));
1497         Safefree(HeKEY_hek(entry));
1498     }
1499     else if (HvSHAREKEYS(hv))
1500         unshare_hek(HeKEY_hek(entry));
1501     else
1502         Safefree(HeKEY_hek(entry));
1503     del_HE(entry);
1504     return val;
1505 }
1506
1507
1508 void
1509 Perl_hv_free_ent(pTHX_ HV *hv, register HE *entry)
1510 {
1511     dVAR;
1512     SV *val;
1513
1514     PERL_ARGS_ASSERT_HV_FREE_ENT;
1515
1516     if (!entry)
1517         return;
1518     val = hv_free_ent_ret(hv, entry);
1519     SvREFCNT_dec(val);
1520 }
1521
1522
1523 void
1524 Perl_hv_delayfree_ent(pTHX_ HV *hv, register HE *entry)
1525 {
1526     dVAR;
1527
1528     PERL_ARGS_ASSERT_HV_DELAYFREE_ENT;
1529
1530     if (!entry)
1531         return;
1532     /* SvREFCNT_inc to counter the SvREFCNT_dec in hv_free_ent  */
1533     sv_2mortal(SvREFCNT_inc(HeVAL(entry)));     /* free between statements */
1534     if (HeKLEN(entry) == HEf_SVKEY) {
1535         sv_2mortal(SvREFCNT_inc(HeKEY_sv(entry)));
1536     }
1537     hv_free_ent(hv, entry);
1538 }
1539
1540 /*
1541 =for apidoc hv_clear
1542
1543 Frees the all the elements of a hash, leaving it empty.
1544 The XS equivalent of %hash = (). See also L</hv_undef>.
1545
1546 =cut
1547 */
1548
1549 void
1550 Perl_hv_clear(pTHX_ HV *hv)
1551 {
1552     dVAR;
1553     register XPVHV* xhv;
1554     if (!hv)
1555         return;
1556
1557     DEBUG_A(Perl_hv_assert(aTHX_ hv));
1558
1559     xhv = (XPVHV*)SvANY(hv);
1560
1561     if (SvREADONLY(hv) && HvARRAY(hv) != NULL) {
1562         /* restricted hash: convert all keys to placeholders */
1563         STRLEN i;
1564         for (i = 0; i <= xhv->xhv_max; i++) {
1565             HE *entry = (HvARRAY(hv))[i];
1566             for (; entry; entry = HeNEXT(entry)) {
1567                 /* not already placeholder */
1568                 if (HeVAL(entry) != &PL_sv_placeholder) {
1569                     if (HeVAL(entry) && SvREADONLY(HeVAL(entry))
1570                      && !SvIsCOW(HeVAL(entry))) {
1571                         SV* const keysv = hv_iterkeysv(entry);
1572                         Perl_croak(aTHX_
1573                                    "Attempt to delete readonly key '%"SVf"' from a restricted hash",
1574                                    (void*)keysv);
1575                     }
1576                     SvREFCNT_dec(HeVAL(entry));
1577                     HeVAL(entry) = &PL_sv_placeholder;
1578                     HvPLACEHOLDERS(hv)++;
1579                 }
1580             }
1581         }
1582     }
1583     else {
1584         hfreeentries(hv);
1585         HvPLACEHOLDERS_set(hv, 0);
1586
1587         if (SvRMAGICAL(hv))
1588             mg_clear(MUTABLE_SV(hv));
1589
1590         HvHASKFLAGS_off(hv);
1591         HvREHASH_off(hv);
1592     }
1593     if (SvOOK(hv)) {
1594         if(HvENAME_get(hv))
1595             mro_isa_changed_in(hv);
1596         HvEITER_set(hv, NULL);
1597     }
1598 }
1599
1600 /*
1601 =for apidoc hv_clear_placeholders
1602
1603 Clears any placeholders from a hash.  If a restricted hash has any of its keys
1604 marked as readonly and the key is subsequently deleted, the key is not actually
1605 deleted but is marked by assigning it a value of &PL_sv_placeholder.  This tags
1606 it so it will be ignored by future operations such as iterating over the hash,
1607 but will still allow the hash to have a value reassigned to the key at some
1608 future point.  This function clears any such placeholder keys from the hash.
1609 See Hash::Util::lock_keys() for an example of its use.
1610
1611 =cut
1612 */
1613
1614 void
1615 Perl_hv_clear_placeholders(pTHX_ HV *hv)
1616 {
1617     dVAR;
1618     const U32 items = (U32)HvPLACEHOLDERS_get(hv);
1619
1620     PERL_ARGS_ASSERT_HV_CLEAR_PLACEHOLDERS;
1621
1622     if (items)
1623         clear_placeholders(hv, items);
1624 }
1625
1626 static void
1627 S_clear_placeholders(pTHX_ HV *hv, U32 items)
1628 {
1629     dVAR;
1630     I32 i;
1631
1632     PERL_ARGS_ASSERT_CLEAR_PLACEHOLDERS;
1633
1634     if (items == 0)
1635         return;
1636
1637     i = HvMAX(hv);
1638     do {
1639         /* Loop down the linked list heads  */
1640         HE **oentry = &(HvARRAY(hv))[i];
1641         HE *entry;
1642
1643         while ((entry = *oentry)) {
1644             if (HeVAL(entry) == &PL_sv_placeholder) {
1645                 *oentry = HeNEXT(entry);
1646                 if (entry == HvEITER_get(hv))
1647                     HvLAZYDEL_on(hv);
1648                 else {
1649                     if (SvOOK(hv) && HvLAZYDEL(hv) &&
1650                         entry == HeNEXT(HvAUX(hv)->xhv_eiter))
1651                         HeNEXT(HvAUX(hv)->xhv_eiter) = HeNEXT(entry);
1652                     hv_free_ent(hv, entry);
1653                 }
1654
1655                 if (--items == 0) {
1656                     /* Finished.  */
1657                     HvTOTALKEYS(hv) -= (IV)HvPLACEHOLDERS_get(hv);
1658                     if (HvUSEDKEYS(hv) == 0)
1659                         HvHASKFLAGS_off(hv);
1660                     HvPLACEHOLDERS_set(hv, 0);
1661                     return;
1662                 }
1663             } else {
1664                 oentry = &HeNEXT(entry);
1665             }
1666         }
1667     } while (--i >= 0);
1668     /* You can't get here, hence assertion should always fail.  */
1669     assert (items == 0);
1670     assert (0);
1671 }
1672
1673 STATIC void
1674 S_hfreeentries(pTHX_ HV *hv)
1675 {
1676     STRLEN index = 0;
1677     XPVHV * const xhv = (XPVHV*)SvANY(hv);
1678     SV *sv;
1679
1680     PERL_ARGS_ASSERT_HFREEENTRIES;
1681
1682     while ((sv = Perl_hfree_next_entry(aTHX_ hv, &index))||xhv->xhv_keys) {
1683         SvREFCNT_dec(sv);
1684     }
1685 }
1686
1687
1688 /* hfree_next_entry()
1689  * For use only by S_hfreeentries() and sv_clear().
1690  * Delete the next available HE from hv and return the associated SV.
1691  * Returns null on empty hash. Nevertheless null is not a reliable
1692  * indicator that the hash is empty, as the deleted entry may have a
1693  * null value.
1694  * indexp is a pointer to the current index into HvARRAY. The index should
1695  * initially be set to 0. hfree_next_entry() may update it.  */
1696
1697 SV*
1698 Perl_hfree_next_entry(pTHX_ HV *hv, STRLEN *indexp)
1699 {
1700     struct xpvhv_aux *iter;
1701     HE *entry;
1702     HE ** array;
1703 #ifdef DEBUGGING
1704     STRLEN orig_index = *indexp;
1705 #endif
1706
1707     PERL_ARGS_ASSERT_HFREE_NEXT_ENTRY;
1708
1709     if (SvOOK(hv) && ((iter = HvAUX(hv)))
1710         && ((entry = iter->xhv_eiter)) )
1711     {
1712         /* the iterator may get resurrected after each
1713          * destructor call, so check each time */
1714         if (entry && HvLAZYDEL(hv)) {   /* was deleted earlier? */
1715             HvLAZYDEL_off(hv);
1716             hv_free_ent(hv, entry);
1717             /* warning: at this point HvARRAY may have been
1718              * re-allocated, HvMAX changed etc */
1719         }
1720         iter->xhv_riter = -1;   /* HvRITER(hv) = -1 */
1721         iter->xhv_eiter = NULL; /* HvEITER(hv) = NULL */
1722     }
1723
1724     if (!((XPVHV*)SvANY(hv))->xhv_keys)
1725         return NULL;
1726
1727     array = HvARRAY(hv);
1728     assert(array);
1729     while ( ! ((entry = array[*indexp])) ) {
1730         if ((*indexp)++ >= HvMAX(hv))
1731             *indexp = 0;
1732         assert(*indexp != orig_index);
1733     }
1734     array[*indexp] = HeNEXT(entry);
1735     ((XPVHV*) SvANY(hv))->xhv_keys--;
1736
1737     if (   PL_phase != PERL_PHASE_DESTRUCT && HvENAME(hv)
1738         && HeVAL(entry) && isGV(HeVAL(entry))
1739         && GvHV(HeVAL(entry)) && HvENAME(GvHV(HeVAL(entry)))
1740     ) {
1741         STRLEN klen;
1742         const char * const key = HePV(entry,klen);
1743         if ((klen > 1 && key[klen-1]==':' && key[klen-2]==':')
1744          || (klen == 1 && key[0] == ':')) {
1745             mro_package_moved(
1746              NULL, GvHV(HeVAL(entry)),
1747              (GV *)HeVAL(entry), 0
1748             );
1749         }
1750     }
1751     return hv_free_ent_ret(hv, entry);
1752 }
1753
1754
1755 /*
1756 =for apidoc hv_undef
1757
1758 Undefines the hash.  The XS equivalent of undef(%hash).
1759
1760 As well as freeing all the elements of the hash (like hv_clear()), this
1761 also frees any auxiliary data and storage associated with the hash.
1762 See also L</hv_clear>.
1763
1764 =cut
1765 */
1766
1767 void
1768 Perl_hv_undef_flags(pTHX_ HV *hv, U32 flags)
1769 {
1770     dVAR;
1771     register XPVHV* xhv;
1772     const char *name;
1773
1774     if (!hv)
1775         return;
1776     DEBUG_A(Perl_hv_assert(aTHX_ hv));
1777     xhv = (XPVHV*)SvANY(hv);
1778
1779     /* The name must be deleted before the call to hfreeeeentries so that
1780        CVs are anonymised properly. But the effective name must be pre-
1781        served until after that call (and only deleted afterwards if the
1782        call originated from sv_clear). For stashes with one name that is
1783        both the canonical name and the effective name, hv_name_set has to
1784        allocate an array for storing the effective name. We can skip that
1785        during global destruction, as it does not matter where the CVs point
1786        if they will be freed anyway. */
1787     /* note that the code following prior to hfreeentries is duplicated
1788      * in sv_clear(), and changes here should be done there too */
1789     if (PL_phase != PERL_PHASE_DESTRUCT && (name = HvNAME(hv))) {
1790         if (PL_stashcache)
1791             (void)hv_delete(PL_stashcache, name,
1792                             HEK_UTF8(HvNAME_HEK(hv)) ? -HvNAMELEN_get(hv) : HvNAMELEN_get(hv),
1793                             G_DISCARD
1794                            );
1795         hv_name_set(hv, NULL, 0, 0);
1796     }
1797     hfreeentries(hv);
1798     if (SvOOK(hv)) {
1799       struct xpvhv_aux * const aux = HvAUX(hv);
1800       struct mro_meta *meta;
1801
1802       if ((name = HvENAME_get(hv))) {
1803         if (PL_phase != PERL_PHASE_DESTRUCT)
1804             mro_isa_changed_in(hv);
1805         if (PL_stashcache)
1806             (void)hv_delete(
1807                     PL_stashcache, name,
1808                     HEK_UTF8(HvENAME_HEK(hv)) ? -HvENAMELEN_get(hv) : HvENAMELEN_get(hv),
1809                     G_DISCARD
1810                   );
1811       }
1812
1813       /* If this call originated from sv_clear, then we must check for
1814        * effective names that need freeing, as well as the usual name. */
1815       name = HvNAME(hv);
1816       if (flags & HV_NAME_SETALL ? !!aux->xhv_name_u.xhvnameu_name : !!name) {
1817         if (name && PL_stashcache)
1818             (void)hv_delete(PL_stashcache, name, (HEK_UTF8(HvNAME_HEK(hv)) ? -HvNAMELEN_get(hv) : HvNAMELEN_get(hv)), G_DISCARD);
1819         hv_name_set(hv, NULL, 0, flags);
1820       }
1821       if((meta = aux->xhv_mro_meta)) {
1822         if (meta->mro_linear_all) {
1823             SvREFCNT_dec(MUTABLE_SV(meta->mro_linear_all));
1824             meta->mro_linear_all = NULL;
1825             /* This is just acting as a shortcut pointer.  */
1826             meta->mro_linear_current = NULL;
1827         } else if (meta->mro_linear_current) {
1828             /* Only the current MRO is stored, so this owns the data.
1829              */
1830             SvREFCNT_dec(meta->mro_linear_current);
1831             meta->mro_linear_current = NULL;
1832         }
1833         SvREFCNT_dec(meta->mro_nextmethod);
1834         SvREFCNT_dec(meta->isa);
1835         Safefree(meta);
1836         aux->xhv_mro_meta = NULL;
1837       }
1838       if (!aux->xhv_name_u.xhvnameu_name && ! aux->xhv_backreferences)
1839         SvFLAGS(hv) &= ~SVf_OOK;
1840     }
1841     if (!SvOOK(hv)) {
1842         Safefree(HvARRAY(hv));
1843         xhv->xhv_max   = 7;     /* HvMAX(hv) = 7 (it's a normal hash) */
1844         HvARRAY(hv) = 0;
1845     }
1846     HvPLACEHOLDERS_set(hv, 0);
1847
1848     if (SvRMAGICAL(hv))
1849         mg_clear(MUTABLE_SV(hv));
1850 }
1851
1852 /*
1853 =for apidoc hv_fill
1854
1855 Returns the number of hash buckets that happen to be in use. This function is
1856 wrapped by the macro C<HvFILL>.
1857
1858 Previously this value was stored in the HV structure, rather than being
1859 calculated on demand.
1860
1861 =cut
1862 */
1863
1864 STRLEN
1865 Perl_hv_fill(pTHX_ HV const *const hv)
1866 {
1867     STRLEN count = 0;
1868     HE **ents = HvARRAY(hv);
1869
1870     PERL_ARGS_ASSERT_HV_FILL;
1871
1872     if (ents) {
1873         HE *const *const last = ents + HvMAX(hv);
1874         count = last + 1 - ents;
1875
1876         do {
1877             if (!*ents)
1878                 --count;
1879         } while (++ents <= last);
1880     }
1881     return count;
1882 }
1883
1884 static struct xpvhv_aux*
1885 S_hv_auxinit(HV *hv) {
1886     struct xpvhv_aux *iter;
1887     char *array;
1888
1889     PERL_ARGS_ASSERT_HV_AUXINIT;
1890
1891     if (!HvARRAY(hv)) {
1892         Newxz(array, PERL_HV_ARRAY_ALLOC_BYTES(HvMAX(hv) + 1)
1893             + sizeof(struct xpvhv_aux), char);
1894     } else {
1895         array = (char *) HvARRAY(hv);
1896         Renew(array, PERL_HV_ARRAY_ALLOC_BYTES(HvMAX(hv) + 1)
1897               + sizeof(struct xpvhv_aux), char);
1898     }
1899     HvARRAY(hv) = (HE**) array;
1900     /* SvOOK_on(hv) attacks the IV flags.  */
1901     SvFLAGS(hv) |= SVf_OOK;
1902     iter = HvAUX(hv);
1903
1904     iter->xhv_riter = -1;       /* HvRITER(hv) = -1 */
1905     iter->xhv_eiter = NULL;     /* HvEITER(hv) = NULL */
1906     iter->xhv_name_u.xhvnameu_name = 0;
1907     iter->xhv_name_count = 0;
1908     iter->xhv_backreferences = 0;
1909     iter->xhv_mro_meta = NULL;
1910     return iter;
1911 }
1912
1913 /*
1914 =for apidoc hv_iterinit
1915
1916 Prepares a starting point to traverse a hash table.  Returns the number of
1917 keys in the hash (i.e. the same as C<HvUSEDKEYS(hv)>).  The return value is
1918 currently only meaningful for hashes without tie magic.
1919
1920 NOTE: Before version 5.004_65, C<hv_iterinit> used to return the number of
1921 hash buckets that happen to be in use.  If you still need that esoteric
1922 value, you can get it through the macro C<HvFILL(hv)>.
1923
1924
1925 =cut
1926 */
1927
1928 I32
1929 Perl_hv_iterinit(pTHX_ HV *hv)
1930 {
1931     PERL_ARGS_ASSERT_HV_ITERINIT;
1932
1933     /* FIXME: Are we not NULL, or do we croak? Place bets now! */
1934
1935     if (!hv)
1936         Perl_croak(aTHX_ "Bad hash");
1937
1938     if (SvOOK(hv)) {
1939         struct xpvhv_aux * const iter = HvAUX(hv);
1940         HE * const entry = iter->xhv_eiter; /* HvEITER(hv) */
1941         if (entry && HvLAZYDEL(hv)) {   /* was deleted earlier? */
1942             HvLAZYDEL_off(hv);
1943             hv_free_ent(hv, entry);
1944         }
1945         iter->xhv_riter = -1;   /* HvRITER(hv) = -1 */
1946         iter->xhv_eiter = NULL; /* HvEITER(hv) = NULL */
1947     } else {
1948         hv_auxinit(hv);
1949     }
1950
1951     /* used to be xhv->xhv_fill before 5.004_65 */
1952     return HvTOTALKEYS(hv);
1953 }
1954
1955 I32 *
1956 Perl_hv_riter_p(pTHX_ HV *hv) {
1957     struct xpvhv_aux *iter;
1958
1959     PERL_ARGS_ASSERT_HV_RITER_P;
1960
1961     if (!hv)
1962         Perl_croak(aTHX_ "Bad hash");
1963
1964     iter = SvOOK(hv) ? HvAUX(hv) : hv_auxinit(hv);
1965     return &(iter->xhv_riter);
1966 }
1967
1968 HE **
1969 Perl_hv_eiter_p(pTHX_ HV *hv) {
1970     struct xpvhv_aux *iter;
1971
1972     PERL_ARGS_ASSERT_HV_EITER_P;
1973
1974     if (!hv)
1975         Perl_croak(aTHX_ "Bad hash");
1976
1977     iter = SvOOK(hv) ? HvAUX(hv) : hv_auxinit(hv);
1978     return &(iter->xhv_eiter);
1979 }
1980
1981 void
1982 Perl_hv_riter_set(pTHX_ HV *hv, I32 riter) {
1983     struct xpvhv_aux *iter;
1984
1985     PERL_ARGS_ASSERT_HV_RITER_SET;
1986
1987     if (!hv)
1988         Perl_croak(aTHX_ "Bad hash");
1989
1990     if (SvOOK(hv)) {
1991         iter = HvAUX(hv);
1992     } else {
1993         if (riter == -1)
1994             return;
1995
1996         iter = hv_auxinit(hv);
1997     }
1998     iter->xhv_riter = riter;
1999 }
2000
2001 void
2002 Perl_hv_eiter_set(pTHX_ HV *hv, HE *eiter) {
2003     struct xpvhv_aux *iter;
2004
2005     PERL_ARGS_ASSERT_HV_EITER_SET;
2006
2007     if (!hv)
2008         Perl_croak(aTHX_ "Bad hash");
2009
2010     if (SvOOK(hv)) {
2011         iter = HvAUX(hv);
2012     } else {
2013         /* 0 is the default so don't go malloc()ing a new structure just to
2014            hold 0.  */
2015         if (!eiter)
2016             return;
2017
2018         iter = hv_auxinit(hv);
2019     }
2020     iter->xhv_eiter = eiter;
2021 }
2022
2023 void
2024 Perl_hv_name_set(pTHX_ HV *hv, const char *name, U32 len, U32 flags)
2025 {
2026     dVAR;
2027     struct xpvhv_aux *iter;
2028     U32 hash;
2029     HEK **spot;
2030
2031     PERL_ARGS_ASSERT_HV_NAME_SET;
2032
2033     if (len > I32_MAX)
2034         Perl_croak(aTHX_ "panic: hv name too long (%"UVuf")", (UV) len);
2035
2036     if (SvOOK(hv)) {
2037         iter = HvAUX(hv);
2038         if (iter->xhv_name_u.xhvnameu_name) {
2039             if(iter->xhv_name_count) {
2040               if(flags & HV_NAME_SETALL) {
2041                 HEK ** const name = HvAUX(hv)->xhv_name_u.xhvnameu_names;
2042                 HEK **hekp = name + (
2043                     iter->xhv_name_count < 0
2044                      ? -iter->xhv_name_count
2045                      :  iter->xhv_name_count
2046                    );
2047                 while(hekp-- > name+1) 
2048                     unshare_hek_or_pvn(*hekp, 0, 0, 0);
2049                 /* The first elem may be null. */
2050                 if(*name) unshare_hek_or_pvn(*name, 0, 0, 0);
2051                 Safefree(name);
2052                 spot = &iter->xhv_name_u.xhvnameu_name;
2053                 iter->xhv_name_count = 0;
2054               }
2055               else {
2056                 if(iter->xhv_name_count > 0) {
2057                     /* shift some things over */
2058                     Renew(
2059                      iter->xhv_name_u.xhvnameu_names, iter->xhv_name_count + 1, HEK *
2060                     );
2061                     spot = iter->xhv_name_u.xhvnameu_names;
2062                     spot[iter->xhv_name_count] = spot[1];
2063                     spot[1] = spot[0];
2064                     iter->xhv_name_count = -(iter->xhv_name_count + 1);
2065                 }
2066                 else if(*(spot = iter->xhv_name_u.xhvnameu_names)) {
2067                     unshare_hek_or_pvn(*spot, 0, 0, 0);
2068                 }
2069               }
2070             }
2071             else if (flags & HV_NAME_SETALL) {
2072                 unshare_hek_or_pvn(iter->xhv_name_u.xhvnameu_name, 0, 0, 0);
2073                 spot = &iter->xhv_name_u.xhvnameu_name;
2074             }
2075             else {
2076                 HEK * const existing_name = iter->xhv_name_u.xhvnameu_name;
2077                 Newx(iter->xhv_name_u.xhvnameu_names, 2, HEK *);
2078                 iter->xhv_name_count = -2;
2079                 spot = iter->xhv_name_u.xhvnameu_names;
2080                 spot[1] = existing_name;
2081             }
2082         }
2083         else { spot = &iter->xhv_name_u.xhvnameu_name; iter->xhv_name_count = 0; }
2084     } else {
2085         if (name == 0)
2086             return;
2087
2088         iter = hv_auxinit(hv);
2089         spot = &iter->xhv_name_u.xhvnameu_name;
2090     }
2091     PERL_HASH(hash, name, len);
2092     *spot = name ? share_hek(name, flags & SVf_UTF8 ? -(I32)len : (I32)len, hash) : NULL;
2093 }
2094
2095 /*
2096 This is basically sv_eq_flags() in sv.c, but we avoid the magic
2097 and bytes checking.
2098 */
2099
2100 STATIC I32
2101 hek_eq_pvn_flags(pTHX_ const HEK *hek, const char* pv, const I32 pvlen, const U32 flags) {
2102     if ( (HEK_UTF8(hek) ? 1 : 0) != (flags & SVf_UTF8 ? 1 : 0) ) {
2103         if (flags & SVf_UTF8)
2104             return (bytes_cmp_utf8(
2105                         (const U8*)HEK_KEY(hek), HEK_LEN(hek),
2106                         (const U8*)pv, pvlen) == 0);
2107         else
2108             return (bytes_cmp_utf8(
2109                         (const U8*)pv, pvlen,
2110                         (const U8*)HEK_KEY(hek), HEK_LEN(hek)) == 0);
2111     }
2112     else
2113         return HEK_LEN(hek) == pvlen && ((HEK_KEY(hek) == pv)
2114                     || memEQ(HEK_KEY(hek), pv, pvlen));
2115 }
2116
2117 /*
2118 =for apidoc hv_ename_add
2119
2120 Adds a name to a stash's internal list of effective names. See
2121 C<hv_ename_delete>.
2122
2123 This is called when a stash is assigned to a new location in the symbol
2124 table.
2125
2126 =cut
2127 */
2128
2129 void
2130 Perl_hv_ename_add(pTHX_ HV *hv, const char *name, U32 len, U32 flags)
2131 {
2132     dVAR;
2133     struct xpvhv_aux *aux = SvOOK(hv) ? HvAUX(hv) : hv_auxinit(hv);
2134     U32 hash;
2135
2136     PERL_ARGS_ASSERT_HV_ENAME_ADD;
2137
2138     if (len > I32_MAX)
2139         Perl_croak(aTHX_ "panic: hv name too long (%"UVuf")", (UV) len);
2140
2141     PERL_HASH(hash, name, len);
2142
2143     if (aux->xhv_name_count) {
2144         HEK ** const xhv_name = aux->xhv_name_u.xhvnameu_names;
2145         I32 count = aux->xhv_name_count;
2146         HEK **hekp = xhv_name + (count < 0 ? -count : count);
2147         while (hekp-- > xhv_name)
2148             if (
2149                  (HEK_UTF8(*hekp) || (flags & SVf_UTF8)) 
2150                     ? hek_eq_pvn_flags(aTHX_ *hekp, name, (I32)len, flags)
2151                     : (HEK_LEN(*hekp) == (I32)len && memEQ(HEK_KEY(*hekp), name, len))
2152                ) {
2153                 if (hekp == xhv_name && count < 0)
2154                     aux->xhv_name_count = -count;
2155                 return;
2156             }
2157         if (count < 0) aux->xhv_name_count--, count = -count;
2158         else aux->xhv_name_count++;
2159         Renew(aux->xhv_name_u.xhvnameu_names, count + 1, HEK *);
2160         (aux->xhv_name_u.xhvnameu_names)[count] = share_hek(name, (flags & SVf_UTF8 ? -(I32)len : (I32)len), hash);
2161     }
2162     else {
2163         HEK *existing_name = aux->xhv_name_u.xhvnameu_name;
2164         if (
2165             existing_name && (
2166              (HEK_UTF8(existing_name) || (flags & SVf_UTF8))
2167                 ? hek_eq_pvn_flags(aTHX_ existing_name, name, (I32)len, flags)
2168                 : (HEK_LEN(existing_name) == (I32)len && memEQ(HEK_KEY(existing_name), name, len))
2169             )
2170         ) return;
2171         Newx(aux->xhv_name_u.xhvnameu_names, 2, HEK *);
2172         aux->xhv_name_count = existing_name ? 2 : -2;
2173         *aux->xhv_name_u.xhvnameu_names = existing_name;
2174         (aux->xhv_name_u.xhvnameu_names)[1] = share_hek(name, (flags & SVf_UTF8 ? -(I32)len : (I32)len), hash);
2175     }
2176 }
2177
2178 /*
2179 =for apidoc hv_ename_delete
2180
2181 Removes a name from a stash's internal list of effective names. If this is
2182 the name returned by C<HvENAME>, then another name in the list will take
2183 its place (C<HvENAME> will use it).
2184
2185 This is called when a stash is deleted from the symbol table.
2186
2187 =cut
2188 */
2189
2190 void
2191 Perl_hv_ename_delete(pTHX_ HV *hv, const char *name, U32 len, U32 flags)
2192 {
2193     dVAR;
2194     struct xpvhv_aux *aux;
2195
2196     PERL_ARGS_ASSERT_HV_ENAME_DELETE;
2197
2198     if (len > I32_MAX)
2199         Perl_croak(aTHX_ "panic: hv name too long (%"UVuf")", (UV) len);
2200
2201     if (!SvOOK(hv)) return;
2202
2203     aux = HvAUX(hv);
2204     if (!aux->xhv_name_u.xhvnameu_name) return;
2205
2206     if (aux->xhv_name_count) {
2207         HEK ** const namep = aux->xhv_name_u.xhvnameu_names;
2208         I32 const count = aux->xhv_name_count;
2209         HEK **victim = namep + (count < 0 ? -count : count);
2210         while (victim-- > namep + 1)
2211             if (
2212              (HEK_UTF8(*victim) || (flags & SVf_UTF8)) 
2213                 ? hek_eq_pvn_flags(aTHX_ *victim, name, (I32)len, flags)
2214                 : (HEK_LEN(*victim) == (I32)len && memEQ(HEK_KEY(*victim), name, len))
2215             ) {
2216                 unshare_hek_or_pvn(*victim, 0, 0, 0);
2217                 if (count < 0) ++aux->xhv_name_count;
2218                 else --aux->xhv_name_count;
2219                 if (
2220                     (aux->xhv_name_count == 1 || aux->xhv_name_count == -1)
2221                  && !*namep
2222                 ) {  /* if there are none left */
2223                     Safefree(namep);
2224                     aux->xhv_name_u.xhvnameu_names = NULL;
2225                     aux->xhv_name_count = 0;
2226                 }
2227                 else {
2228                     /* Move the last one back to fill the empty slot. It
2229                        does not matter what order they are in. */
2230                     *victim = *(namep + (count < 0 ? -count : count) - 1);
2231                 }
2232                 return;
2233             }
2234         if (
2235             count > 0 && (HEK_UTF8(*namep) || (flags & SVf_UTF8)) 
2236                 ? hek_eq_pvn_flags(aTHX_ *namep, name, (I32)len, flags)
2237                 : (HEK_LEN(*namep) == (I32)len && memEQ(HEK_KEY(*namep), name, len))
2238         ) {
2239             aux->xhv_name_count = -count;
2240         }
2241     }
2242     else if(
2243         (HEK_UTF8(aux->xhv_name_u.xhvnameu_name) || (flags & SVf_UTF8)) 
2244                 ? hek_eq_pvn_flags(aTHX_ aux->xhv_name_u.xhvnameu_name, name, (I32)len, flags)
2245                 : (HEK_LEN(aux->xhv_name_u.xhvnameu_name) == (I32)len &&
2246                             memEQ(HEK_KEY(aux->xhv_name_u.xhvnameu_name), name, len))
2247     ) {
2248         HEK * const namehek = aux->xhv_name_u.xhvnameu_name;
2249         Newx(aux->xhv_name_u.xhvnameu_names, 1, HEK *);
2250         *aux->xhv_name_u.xhvnameu_names = namehek;
2251         aux->xhv_name_count = -1;
2252     }
2253 }
2254
2255 AV **
2256 Perl_hv_backreferences_p(pTHX_ HV *hv) {
2257     struct xpvhv_aux * const iter = SvOOK(hv) ? HvAUX(hv) : hv_auxinit(hv);
2258
2259     PERL_ARGS_ASSERT_HV_BACKREFERENCES_P;
2260     PERL_UNUSED_CONTEXT;
2261
2262     return &(iter->xhv_backreferences);
2263 }
2264
2265 void
2266 Perl_hv_kill_backrefs(pTHX_ HV *hv) {
2267     AV *av;
2268
2269     PERL_ARGS_ASSERT_HV_KILL_BACKREFS;
2270
2271     if (!SvOOK(hv))
2272         return;
2273
2274     av = HvAUX(hv)->xhv_backreferences;
2275
2276     if (av) {
2277         HvAUX(hv)->xhv_backreferences = 0;
2278         Perl_sv_kill_backrefs(aTHX_ MUTABLE_SV(hv), av);
2279         if (SvTYPE(av) == SVt_PVAV)
2280             SvREFCNT_dec(av);
2281     }
2282 }
2283
2284 /*
2285 hv_iternext is implemented as a macro in hv.h
2286
2287 =for apidoc hv_iternext
2288
2289 Returns entries from a hash iterator.  See C<hv_iterinit>.
2290
2291 You may call C<hv_delete> or C<hv_delete_ent> on the hash entry that the
2292 iterator currently points to, without losing your place or invalidating your
2293 iterator.  Note that in this case the current entry is deleted from the hash
2294 with your iterator holding the last reference to it.  Your iterator is flagged
2295 to free the entry on the next call to C<hv_iternext>, so you must not discard
2296 your iterator immediately else the entry will leak - call C<hv_iternext> to
2297 trigger the resource deallocation.
2298
2299 =for apidoc hv_iternext_flags
2300
2301 Returns entries from a hash iterator.  See C<hv_iterinit> and C<hv_iternext>.
2302 The C<flags> value will normally be zero; if HV_ITERNEXT_WANTPLACEHOLDERS is
2303 set the placeholders keys (for restricted hashes) will be returned in addition
2304 to normal keys. By default placeholders are automatically skipped over.
2305 Currently a placeholder is implemented with a value that is
2306 C<&Perl_sv_placeholder>. Note that the implementation of placeholders and
2307 restricted hashes may change, and the implementation currently is
2308 insufficiently abstracted for any change to be tidy.
2309
2310 =cut
2311 */
2312
2313 HE *
2314 Perl_hv_iternext_flags(pTHX_ HV *hv, I32 flags)
2315 {
2316     dVAR;
2317     register XPVHV* xhv;
2318     register HE *entry;
2319     HE *oldentry;
2320     MAGIC* mg;
2321     struct xpvhv_aux *iter;
2322
2323     PERL_ARGS_ASSERT_HV_ITERNEXT_FLAGS;
2324
2325     if (!hv)
2326         Perl_croak(aTHX_ "Bad hash");
2327
2328     xhv = (XPVHV*)SvANY(hv);
2329
2330     if (!SvOOK(hv)) {
2331         /* Too many things (well, pp_each at least) merrily assume that you can
2332            call iv_iternext without calling hv_iterinit, so we'll have to deal
2333            with it.  */
2334         hv_iterinit(hv);
2335     }
2336     iter = HvAUX(hv);
2337
2338     oldentry = entry = iter->xhv_eiter; /* HvEITER(hv) */
2339     if (SvMAGICAL(hv) && SvRMAGICAL(hv)) {
2340         if ( ( mg = mg_find((const SV *)hv, PERL_MAGIC_tied) ) ) {
2341             SV * const key = sv_newmortal();
2342             if (entry) {
2343                 sv_setsv(key, HeSVKEY_force(entry));
2344                 SvREFCNT_dec(HeSVKEY(entry));       /* get rid of previous key */
2345             }
2346             else {
2347                 char *k;
2348                 HEK *hek;
2349
2350                 /* one HE per MAGICAL hash */
2351                 iter->xhv_eiter = entry = new_HE(); /* HvEITER(hv) = new_HE() */
2352                 Zero(entry, 1, HE);
2353                 Newxz(k, HEK_BASESIZE + sizeof(const SV *), char);
2354                 hek = (HEK*)k;
2355                 HeKEY_hek(entry) = hek;
2356                 HeKLEN(entry) = HEf_SVKEY;
2357             }
2358             magic_nextpack(MUTABLE_SV(hv),mg,key);
2359             if (SvOK(key)) {
2360                 /* force key to stay around until next time */
2361                 HeSVKEY_set(entry, SvREFCNT_inc_simple_NN(key));
2362                 return entry;               /* beware, hent_val is not set */
2363             }
2364             SvREFCNT_dec(HeVAL(entry));
2365             Safefree(HeKEY_hek(entry));
2366             del_HE(entry);
2367             iter->xhv_eiter = NULL; /* HvEITER(hv) = NULL */
2368             return NULL;
2369         }
2370     }
2371 #if defined(DYNAMIC_ENV_FETCH) && !defined(__riscos__)  /* set up %ENV for iteration */
2372     if (!entry && SvRMAGICAL((const SV *)hv)
2373         && mg_find((const SV *)hv, PERL_MAGIC_env)) {
2374         prime_env_iter();
2375 #ifdef VMS
2376         /* The prime_env_iter() on VMS just loaded up new hash values
2377          * so the iteration count needs to be reset back to the beginning
2378          */
2379         hv_iterinit(hv);
2380         iter = HvAUX(hv);
2381         oldentry = entry = iter->xhv_eiter; /* HvEITER(hv) */
2382 #endif
2383     }
2384 #endif
2385
2386     /* hv_iterint now ensures this.  */
2387     assert (HvARRAY(hv));
2388
2389     /* At start of hash, entry is NULL.  */
2390     if (entry)
2391     {
2392         entry = HeNEXT(entry);
2393         if (!(flags & HV_ITERNEXT_WANTPLACEHOLDERS)) {
2394             /*
2395              * Skip past any placeholders -- don't want to include them in
2396              * any iteration.
2397              */
2398             while (entry && HeVAL(entry) == &PL_sv_placeholder) {
2399                 entry = HeNEXT(entry);
2400             }
2401         }
2402     }
2403
2404     /* Skip the entire loop if the hash is empty.   */
2405     if ((flags & HV_ITERNEXT_WANTPLACEHOLDERS)
2406         ? HvTOTALKEYS(hv) : HvUSEDKEYS(hv)) {
2407         while (!entry) {
2408             /* OK. Come to the end of the current list.  Grab the next one.  */
2409
2410             iter->xhv_riter++; /* HvRITER(hv)++ */
2411             if (iter->xhv_riter > (I32)xhv->xhv_max /* HvRITER(hv) > HvMAX(hv) */) {
2412                 /* There is no next one.  End of the hash.  */
2413                 iter->xhv_riter = -1; /* HvRITER(hv) = -1 */
2414                 break;
2415             }
2416             entry = (HvARRAY(hv))[iter->xhv_riter];
2417
2418             if (!(flags & HV_ITERNEXT_WANTPLACEHOLDERS)) {
2419                 /* If we have an entry, but it's a placeholder, don't count it.
2420                    Try the next.  */
2421                 while (entry && HeVAL(entry) == &PL_sv_placeholder)
2422                     entry = HeNEXT(entry);
2423             }
2424             /* Will loop again if this linked list starts NULL
2425                (for HV_ITERNEXT_WANTPLACEHOLDERS)
2426                or if we run through it and find only placeholders.  */
2427         }
2428     }
2429
2430     if (oldentry && HvLAZYDEL(hv)) {            /* was deleted earlier? */
2431         HvLAZYDEL_off(hv);
2432         hv_free_ent(hv, oldentry);
2433     }
2434
2435     /*if (HvREHASH(hv) && entry && !HeKREHASH(entry))
2436       PerlIO_printf(PerlIO_stderr(), "Awooga %p %p\n", (void*)hv, (void*)entry);*/
2437
2438     iter->xhv_eiter = entry; /* HvEITER(hv) = entry */
2439     return entry;
2440 }
2441
2442 /*
2443 =for apidoc hv_iterkey
2444
2445 Returns the key from the current position of the hash iterator.  See
2446 C<hv_iterinit>.
2447
2448 =cut
2449 */
2450
2451 char *
2452 Perl_hv_iterkey(pTHX_ register HE *entry, I32 *retlen)
2453 {
2454     PERL_ARGS_ASSERT_HV_ITERKEY;
2455
2456     if (HeKLEN(entry) == HEf_SVKEY) {
2457         STRLEN len;
2458         char * const p = SvPV(HeKEY_sv(entry), len);
2459         *retlen = len;
2460         return p;
2461     }
2462     else {
2463         *retlen = HeKLEN(entry);
2464         return HeKEY(entry);
2465     }
2466 }
2467
2468 /* unlike hv_iterval(), this always returns a mortal copy of the key */
2469 /*
2470 =for apidoc hv_iterkeysv
2471
2472 Returns the key as an C<SV*> from the current position of the hash
2473 iterator.  The return value will always be a mortal copy of the key.  Also
2474 see C<hv_iterinit>.
2475
2476 =cut
2477 */
2478
2479 SV *
2480 Perl_hv_iterkeysv(pTHX_ register HE *entry)
2481 {
2482     PERL_ARGS_ASSERT_HV_ITERKEYSV;
2483
2484     return sv_2mortal(newSVhek(HeKEY_hek(entry)));
2485 }
2486
2487 /*
2488 =for apidoc hv_iterval
2489
2490 Returns the value from the current position of the hash iterator.  See
2491 C<hv_iterkey>.
2492
2493 =cut
2494 */
2495
2496 SV *
2497 Perl_hv_iterval(pTHX_ HV *hv, register HE *entry)
2498 {
2499     PERL_ARGS_ASSERT_HV_ITERVAL;
2500
2501     if (SvRMAGICAL(hv)) {
2502         if (mg_find((const SV *)hv, PERL_MAGIC_tied)) {
2503             SV* const sv = sv_newmortal();
2504             if (HeKLEN(entry) == HEf_SVKEY)
2505                 mg_copy(MUTABLE_SV(hv), sv, (char*)HeKEY_sv(entry), HEf_SVKEY);
2506             else
2507                 mg_copy(MUTABLE_SV(hv), sv, HeKEY(entry), HeKLEN(entry));
2508             return sv;
2509         }
2510     }
2511     return HeVAL(entry);
2512 }
2513
2514 /*
2515 =for apidoc hv_iternextsv
2516
2517 Performs an C<hv_iternext>, C<hv_iterkey>, and C<hv_iterval> in one
2518 operation.
2519
2520 =cut
2521 */
2522
2523 SV *
2524 Perl_hv_iternextsv(pTHX_ HV *hv, char **key, I32 *retlen)
2525 {
2526     HE * const he = hv_iternext_flags(hv, 0);
2527
2528     PERL_ARGS_ASSERT_HV_ITERNEXTSV;
2529
2530     if (!he)
2531         return NULL;
2532     *key = hv_iterkey(he, retlen);
2533     return hv_iterval(hv, he);
2534 }
2535
2536 /*
2537
2538 Now a macro in hv.h
2539
2540 =for apidoc hv_magic
2541
2542 Adds magic to a hash.  See C<sv_magic>.
2543
2544 =cut
2545 */
2546
2547 /* possibly free a shared string if no one has access to it
2548  * len and hash must both be valid for str.
2549  */
2550 void
2551 Perl_unsharepvn(pTHX_ const char *str, I32 len, U32 hash)
2552 {
2553     unshare_hek_or_pvn (NULL, str, len, hash);
2554 }
2555
2556
2557 void
2558 Perl_unshare_hek(pTHX_ HEK *hek)
2559 {
2560     assert(hek);
2561     unshare_hek_or_pvn(hek, NULL, 0, 0);
2562 }
2563
2564 /* possibly free a shared string if no one has access to it
2565    hek if non-NULL takes priority over the other 3, else str, len and hash
2566    are used.  If so, len and hash must both be valid for str.
2567  */
2568 STATIC void
2569 S_unshare_hek_or_pvn(pTHX_ const HEK *hek, const char *str, I32 len, U32 hash)
2570 {
2571     dVAR;
2572     register XPVHV* xhv;
2573     HE *entry;
2574     register HE **oentry;
2575     bool is_utf8 = FALSE;
2576     int k_flags = 0;
2577     const char * const save = str;
2578     struct shared_he *he = NULL;
2579
2580     if (hek) {
2581         /* Find the shared he which is just before us in memory.  */
2582         he = (struct shared_he *)(((char *)hek)
2583                                   - STRUCT_OFFSET(struct shared_he,
2584                                                   shared_he_hek));
2585
2586         /* Assert that the caller passed us a genuine (or at least consistent)
2587            shared hek  */
2588         assert (he->shared_he_he.hent_hek == hek);
2589
2590         if (he->shared_he_he.he_valu.hent_refcount - 1) {
2591             --he->shared_he_he.he_valu.hent_refcount;
2592             return;
2593         }
2594
2595         hash = HEK_HASH(hek);
2596     } else if (len < 0) {
2597         STRLEN tmplen = -len;
2598         is_utf8 = TRUE;
2599         /* See the note in hv_fetch(). --jhi */
2600         str = (char*)bytes_from_utf8((U8*)str, &tmplen, &is_utf8);
2601         len = tmplen;
2602         if (is_utf8)
2603             k_flags = HVhek_UTF8;
2604         if (str != save)
2605             k_flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
2606     }
2607
2608     /* what follows was the moral equivalent of:
2609     if ((Svp = hv_fetch(PL_strtab, tmpsv, FALSE, hash))) {
2610         if (--*Svp == NULL)
2611             hv_delete(PL_strtab, str, len, G_DISCARD, hash);
2612     } */
2613     xhv = (XPVHV*)SvANY(PL_strtab);
2614     /* assert(xhv_array != 0) */
2615     oentry = &(HvARRAY(PL_strtab))[hash & (I32) HvMAX(PL_strtab)];
2616     if (he) {
2617         const HE *const he_he = &(he->shared_he_he);
2618         for (entry = *oentry; entry; oentry = &HeNEXT(entry), entry = *oentry) {
2619             if (entry == he_he)
2620                 break;
2621         }
2622     } else {
2623         const int flags_masked = k_flags & HVhek_MASK;
2624         for (entry = *oentry; entry; oentry = &HeNEXT(entry), entry = *oentry) {
2625             if (HeHASH(entry) != hash)          /* strings can't be equal */
2626                 continue;
2627             if (HeKLEN(entry) != len)
2628                 continue;
2629             if (HeKEY(entry) != str && memNE(HeKEY(entry),str,len))     /* is this it? */
2630                 continue;
2631             if (HeKFLAGS(entry) != flags_masked)
2632                 continue;
2633             break;
2634         }
2635     }
2636
2637     if (entry) {
2638         if (--entry->he_valu.hent_refcount == 0) {
2639             *oentry = HeNEXT(entry);
2640             Safefree(entry);
2641             xhv->xhv_keys--; /* HvTOTALKEYS(hv)-- */
2642         }
2643     }
2644
2645     if (!entry)
2646         Perl_ck_warner_d(aTHX_ packWARN(WARN_INTERNAL),
2647                          "Attempt to free non-existent shared string '%s'%s"
2648                          pTHX__FORMAT,
2649                          hek ? HEK_KEY(hek) : str,
2650                          ((k_flags & HVhek_UTF8) ? " (utf8)" : "") pTHX__VALUE);
2651     if (k_flags & HVhek_FREEKEY)
2652         Safefree(str);
2653 }
2654
2655 /* get a (constant) string ptr from the global string table
2656  * string will get added if it is not already there.
2657  * len and hash must both be valid for str.
2658  */
2659 HEK *
2660 Perl_share_hek(pTHX_ const char *str, I32 len, register U32 hash)
2661 {
2662     bool is_utf8 = FALSE;
2663     int flags = 0;
2664     const char * const save = str;
2665
2666     PERL_ARGS_ASSERT_SHARE_HEK;
2667
2668     if (len < 0) {
2669       STRLEN tmplen = -len;
2670       is_utf8 = TRUE;
2671       /* See the note in hv_fetch(). --jhi */
2672       str = (char*)bytes_from_utf8((U8*)str, &tmplen, &is_utf8);
2673       len = tmplen;
2674       /* If we were able to downgrade here, then than means that we were passed
2675          in a key which only had chars 0-255, but was utf8 encoded.  */
2676       if (is_utf8)
2677           flags = HVhek_UTF8;
2678       /* If we found we were able to downgrade the string to bytes, then
2679          we should flag that it needs upgrading on keys or each.  Also flag
2680          that we need share_hek_flags to free the string.  */
2681       if (str != save) {
2682           PERL_HASH(hash, str, len);
2683           flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
2684       }
2685     }
2686
2687     return share_hek_flags (str, len, hash, flags);
2688 }
2689
2690 STATIC HEK *
2691 S_share_hek_flags(pTHX_ const char *str, I32 len, register U32 hash, int flags)
2692 {
2693     dVAR;
2694     register HE *entry;
2695     const int flags_masked = flags & HVhek_MASK;
2696     const U32 hindex = hash & (I32) HvMAX(PL_strtab);
2697     register XPVHV * const xhv = (XPVHV*)SvANY(PL_strtab);
2698
2699     PERL_ARGS_ASSERT_SHARE_HEK_FLAGS;
2700
2701     /* what follows is the moral equivalent of:
2702
2703     if (!(Svp = hv_fetch(PL_strtab, str, len, FALSE)))
2704         hv_store(PL_strtab, str, len, NULL, hash);
2705
2706         Can't rehash the shared string table, so not sure if it's worth
2707         counting the number of entries in the linked list
2708     */
2709
2710     /* assert(xhv_array != 0) */
2711     entry = (HvARRAY(PL_strtab))[hindex];
2712     for (;entry; entry = HeNEXT(entry)) {
2713         if (HeHASH(entry) != hash)              /* strings can't be equal */
2714             continue;
2715         if (HeKLEN(entry) != len)
2716             continue;
2717         if (HeKEY(entry) != str && memNE(HeKEY(entry),str,len)) /* is this it? */
2718             continue;
2719         if (HeKFLAGS(entry) != flags_masked)
2720             continue;
2721         break;
2722     }
2723
2724     if (!entry) {
2725         /* What used to be head of the list.
2726            If this is NULL, then we're the first entry for this slot, which
2727            means we need to increate fill.  */
2728         struct shared_he *new_entry;
2729         HEK *hek;
2730         char *k;
2731         HE **const head = &HvARRAY(PL_strtab)[hindex];
2732         HE *const next = *head;
2733
2734         /* We don't actually store a HE from the arena and a regular HEK.
2735            Instead we allocate one chunk of memory big enough for both,
2736            and put the HEK straight after the HE. This way we can find the
2737            HEK directly from the HE.
2738         */
2739
2740         Newx(k, STRUCT_OFFSET(struct shared_he,
2741                                 shared_he_hek.hek_key[0]) + len + 2, char);
2742         new_entry = (struct shared_he *)k;
2743         entry = &(new_entry->shared_he_he);
2744         hek = &(new_entry->shared_he_hek);
2745
2746         Copy(str, HEK_KEY(hek), len, char);
2747         HEK_KEY(hek)[len] = 0;
2748         HEK_LEN(hek) = len;
2749         HEK_HASH(hek) = hash;
2750         HEK_FLAGS(hek) = (unsigned char)flags_masked;
2751
2752         /* Still "point" to the HEK, so that other code need not know what
2753            we're up to.  */
2754         HeKEY_hek(entry) = hek;
2755         entry->he_valu.hent_refcount = 0;
2756         HeNEXT(entry) = next;
2757         *head = entry;
2758
2759         xhv->xhv_keys++; /* HvTOTALKEYS(hv)++ */
2760         if (!next) {                    /* initial entry? */
2761         } else if (xhv->xhv_keys > xhv->xhv_max /* HvUSEDKEYS(hv) > HvMAX(hv) */) {
2762                 hsplit(PL_strtab);
2763         }
2764     }
2765
2766     ++entry->he_valu.hent_refcount;
2767
2768     if (flags & HVhek_FREEKEY)
2769         Safefree(str);
2770
2771     return HeKEY_hek(entry);
2772 }
2773
2774 I32 *
2775 Perl_hv_placeholders_p(pTHX_ HV *hv)
2776 {
2777     dVAR;
2778     MAGIC *mg = mg_find((const SV *)hv, PERL_MAGIC_rhash);
2779
2780     PERL_ARGS_ASSERT_HV_PLACEHOLDERS_P;
2781
2782     if (!mg) {
2783         mg = sv_magicext(MUTABLE_SV(hv), 0, PERL_MAGIC_rhash, 0, 0, 0);
2784
2785         if (!mg) {
2786             Perl_die(aTHX_ "panic: hv_placeholders_p");
2787         }
2788     }
2789     return &(mg->mg_len);
2790 }
2791
2792
2793 I32
2794 Perl_hv_placeholders_get(pTHX_ const HV *hv)
2795 {
2796     dVAR;
2797     MAGIC * const mg = mg_find((const SV *)hv, PERL_MAGIC_rhash);
2798
2799     PERL_ARGS_ASSERT_HV_PLACEHOLDERS_GET;
2800
2801     return mg ? mg->mg_len : 0;
2802 }
2803
2804 void
2805 Perl_hv_placeholders_set(pTHX_ HV *hv, I32 ph)
2806 {
2807     dVAR;
2808     MAGIC * const mg = mg_find((const SV *)hv, PERL_MAGIC_rhash);
2809
2810     PERL_ARGS_ASSERT_HV_PLACEHOLDERS_SET;
2811
2812     if (mg) {
2813         mg->mg_len = ph;
2814     } else if (ph) {
2815         if (!sv_magicext(MUTABLE_SV(hv), 0, PERL_MAGIC_rhash, 0, 0, ph))
2816             Perl_die(aTHX_ "panic: hv_placeholders_set");
2817     }
2818     /* else we don't need to add magic to record 0 placeholders.  */
2819 }
2820
2821 STATIC SV *
2822 S_refcounted_he_value(pTHX_ const struct refcounted_he *he)
2823 {
2824     dVAR;
2825     SV *value;
2826
2827     PERL_ARGS_ASSERT_REFCOUNTED_HE_VALUE;
2828
2829     switch(he->refcounted_he_data[0] & HVrhek_typemask) {
2830     case HVrhek_undef:
2831         value = newSV(0);
2832         break;
2833     case HVrhek_delete:
2834         value = &PL_sv_placeholder;
2835         break;
2836     case HVrhek_IV:
2837         value = newSViv(he->refcounted_he_val.refcounted_he_u_iv);
2838         break;
2839     case HVrhek_UV:
2840         value = newSVuv(he->refcounted_he_val.refcounted_he_u_uv);
2841         break;
2842     case HVrhek_PV:
2843     case HVrhek_PV_UTF8:
2844         /* Create a string SV that directly points to the bytes in our
2845            structure.  */
2846         value = newSV_type(SVt_PV);
2847         SvPV_set(value, (char *) he->refcounted_he_data + 1);
2848         SvCUR_set(value, he->refcounted_he_val.refcounted_he_u_len);
2849         /* This stops anything trying to free it  */
2850         SvLEN_set(value, 0);
2851         SvPOK_on(value);
2852         SvREADONLY_on(value);
2853         if ((he->refcounted_he_data[0] & HVrhek_typemask) == HVrhek_PV_UTF8)
2854             SvUTF8_on(value);
2855         break;
2856     default:
2857         Perl_croak(aTHX_ "panic: refcounted_he_value bad flags %"UVxf,
2858                    (UV)he->refcounted_he_data[0]);
2859     }
2860     return value;
2861 }
2862
2863 /*
2864 =for apidoc m|HV *|refcounted_he_chain_2hv|const struct refcounted_he *c|U32 flags
2865
2866 Generates and returns a C<HV *> representing the content of a
2867 C<refcounted_he> chain.
2868 I<flags> is currently unused and must be zero.
2869
2870 =cut
2871 */
2872 HV *
2873 Perl_refcounted_he_chain_2hv(pTHX_ const struct refcounted_he *chain, U32 flags)
2874 {
2875     dVAR;
2876     HV *hv;
2877     U32 placeholders, max;
2878
2879     if (flags)
2880         Perl_croak(aTHX_ "panic: refcounted_he_chain_2hv bad flags %"UVxf,
2881             (UV)flags);
2882
2883     /* We could chase the chain once to get an idea of the number of keys,
2884        and call ksplit.  But for now we'll make a potentially inefficient
2885        hash with only 8 entries in its array.  */
2886     hv = newHV();
2887     max = HvMAX(hv);
2888     if (!HvARRAY(hv)) {
2889         char *array;
2890         Newxz(array, PERL_HV_ARRAY_ALLOC_BYTES(max + 1), char);
2891         HvARRAY(hv) = (HE**)array;
2892     }
2893
2894     placeholders = 0;
2895     while (chain) {
2896 #ifdef USE_ITHREADS
2897         U32 hash = chain->refcounted_he_hash;
2898 #else
2899         U32 hash = HEK_HASH(chain->refcounted_he_hek);
2900 #endif
2901         HE **oentry = &((HvARRAY(hv))[hash & max]);
2902         HE *entry = *oentry;
2903         SV *value;
2904
2905         for (; entry; entry = HeNEXT(entry)) {
2906             if (HeHASH(entry) == hash) {
2907                 /* We might have a duplicate key here.  If so, entry is older
2908                    than the key we've already put in the hash, so if they are
2909                    the same, skip adding entry.  */
2910 #ifdef USE_ITHREADS
2911                 const STRLEN klen = HeKLEN(entry);
2912                 const char *const key = HeKEY(entry);
2913                 if (klen == chain->refcounted_he_keylen
2914                     && (!!HeKUTF8(entry)
2915                         == !!(chain->refcounted_he_data[0] & HVhek_UTF8))
2916                     && memEQ(key, REF_HE_KEY(chain), klen))
2917                     goto next_please;
2918 #else
2919                 if (HeKEY_hek(entry) == chain->refcounted_he_hek)
2920                     goto next_please;
2921                 if (HeKLEN(entry) == HEK_LEN(chain->refcounted_he_hek)
2922                     && HeKUTF8(entry) == HEK_UTF8(chain->refcounted_he_hek)
2923                     && memEQ(HeKEY(entry), HEK_KEY(chain->refcounted_he_hek),
2924                              HeKLEN(entry)))
2925                     goto next_please;
2926 #endif
2927             }
2928         }
2929         assert (!entry);
2930         entry = new_HE();
2931
2932 #ifdef USE_ITHREADS
2933         HeKEY_hek(entry)
2934             = share_hek_flags(REF_HE_KEY(chain),
2935                               chain->refcounted_he_keylen,
2936                               chain->refcounted_he_hash,
2937                               (chain->refcounted_he_data[0]
2938                                & (HVhek_UTF8|HVhek_WASUTF8)));
2939 #else
2940         HeKEY_hek(entry) = share_hek_hek(chain->refcounted_he_hek);
2941 #endif
2942         value = refcounted_he_value(chain);
2943         if (value == &PL_sv_placeholder)
2944             placeholders++;
2945         HeVAL(entry) = value;
2946
2947         /* Link it into the chain.  */
2948         HeNEXT(entry) = *oentry;
2949         *oentry = entry;
2950
2951         HvTOTALKEYS(hv)++;
2952
2953     next_please:
2954         chain = chain->refcounted_he_next;
2955     }
2956
2957     if (placeholders) {
2958         clear_placeholders(hv, placeholders);
2959         HvTOTALKEYS(hv) -= placeholders;
2960     }
2961
2962     /* We could check in the loop to see if we encounter any keys with key
2963        flags, but it's probably not worth it, as this per-hash flag is only
2964        really meant as an optimisation for things like Storable.  */
2965     HvHASKFLAGS_on(hv);
2966     DEBUG_A(Perl_hv_assert(aTHX_ hv));
2967
2968     return hv;
2969 }
2970
2971 /*
2972 =for apidoc m|SV *|refcounted_he_fetch_pvn|const struct refcounted_he *chain|const char *keypv|STRLEN keylen|U32 hash|U32 flags
2973
2974 Search along a C<refcounted_he> chain for an entry with the key specified
2975 by I<keypv> and I<keylen>.  If I<flags> has the C<REFCOUNTED_HE_KEY_UTF8>
2976 bit set, the key octets are interpreted as UTF-8, otherwise they
2977 are interpreted as Latin-1.  I<hash> is a precomputed hash of the key
2978 string, or zero if it has not been precomputed.  Returns a mortal scalar
2979 representing the value associated with the key, or C<&PL_sv_placeholder>
2980 if there is no value associated with the key.
2981
2982 =cut
2983 */
2984
2985 SV *
2986 Perl_refcounted_he_fetch_pvn(pTHX_ const struct refcounted_he *chain,
2987                          const char *keypv, STRLEN keylen, U32 hash, U32 flags)
2988 {
2989     dVAR;
2990     U8 utf8_flag;
2991     PERL_ARGS_ASSERT_REFCOUNTED_HE_FETCH_PVN;
2992
2993     if (flags & ~REFCOUNTED_HE_KEY_UTF8)
2994         Perl_croak(aTHX_ "panic: refcounted_he_fetch_pvn bad flags %"UVxf,
2995             (UV)flags);
2996     if (!chain)
2997         return &PL_sv_placeholder;
2998     if (flags & REFCOUNTED_HE_KEY_UTF8) {
2999         /* For searching purposes, canonicalise to Latin-1 where possible. */
3000         const char *keyend = keypv + keylen, *p;
3001         STRLEN nonascii_count = 0;
3002         for (p = keypv; p != keyend; p++) {
3003             U8 c = (U8)*p;
3004             if (c & 0x80) {
3005                 if (!((c & 0xfe) == 0xc2 && ++p != keyend &&
3006                             (((U8)*p) & 0xc0) == 0x80))
3007                     goto canonicalised_key;
3008                 nonascii_count++;
3009             }
3010         }
3011         if (nonascii_count) {
3012             char *q;
3013             const char *p = keypv, *keyend = keypv + keylen;
3014             keylen -= nonascii_count;
3015             Newx(q, keylen, char);
3016             SAVEFREEPV(q);
3017             keypv = q;
3018             for (; p != keyend; p++, q++) {
3019                 U8 c = (U8)*p;
3020                 *q = (char)
3021                     ((c & 0x80) ? ((c & 0x03) << 6) | (((U8)*++p) & 0x3f) : c);
3022             }
3023         }
3024         flags &= ~REFCOUNTED_HE_KEY_UTF8;
3025         canonicalised_key: ;
3026     }
3027     utf8_flag = (flags & REFCOUNTED_HE_KEY_UTF8) ? HVhek_UTF8 : 0;
3028     if (!hash)
3029         PERL_HASH(hash, keypv, keylen);
3030
3031     for (; chain; chain = chain->refcounted_he_next) {
3032         if (
3033 #ifdef USE_ITHREADS
3034             hash == chain->refcounted_he_hash &&
3035             keylen == chain->refcounted_he_keylen &&
3036             memEQ(REF_HE_KEY(chain), keypv, keylen) &&
3037             utf8_flag == (chain->refcounted_he_data[0] & HVhek_UTF8)
3038 #else
3039             hash == HEK_HASH(chain->refcounted_he_hek) &&
3040             keylen == (STRLEN)HEK_LEN(chain->refcounted_he_hek) &&
3041             memEQ(HEK_KEY(chain->refcounted_he_hek), keypv, keylen) &&
3042             utf8_flag == (HEK_FLAGS(chain->refcounted_he_hek) & HVhek_UTF8)
3043 #endif
3044         )
3045             return sv_2mortal(refcounted_he_value(chain));
3046     }
3047     return &PL_sv_placeholder;
3048 }
3049
3050 /*
3051 =for apidoc m|SV *|refcounted_he_fetch_pv|const struct refcounted_he *chain|const char *key|U32 hash|U32 flags
3052
3053 Like L</refcounted_he_fetch_pvn>, but takes a nul-terminated string
3054 instead of a string/length pair.
3055
3056 =cut
3057 */
3058
3059 SV *
3060 Perl_refcounted_he_fetch_pv(pTHX_ const struct refcounted_he *chain,
3061                          const char *key, U32 hash, U32 flags)
3062 {
3063     PERL_ARGS_ASSERT_REFCOUNTED_HE_FETCH_PV;
3064     return refcounted_he_fetch_pvn(chain, key, strlen(key), hash, flags);
3065 }
3066
3067 /*
3068 =for apidoc m|SV *|refcounted_he_fetch_sv|const struct refcounted_he *chain|SV *key|U32 hash|U32 flags
3069
3070 Like L</refcounted_he_fetch_pvn>, but takes a Perl scalar instead of a
3071 string/length pair.
3072
3073 =cut
3074 */
3075
3076 SV *
3077 Perl_refcounted_he_fetch_sv(pTHX_ const struct refcounted_he *chain,
3078                          SV *key, U32 hash, U32 flags)
3079 {
3080     const char *keypv;
3081     STRLEN keylen;
3082     PERL_ARGS_ASSERT_REFCOUNTED_HE_FETCH_SV;
3083     if (flags & REFCOUNTED_HE_KEY_UTF8)
3084         Perl_croak(aTHX_ "panic: refcounted_he_fetch_sv bad flags %"UVxf,
3085             (UV)flags);
3086     keypv = SvPV_const(key, keylen);
3087     if (SvUTF8(key))
3088         flags |= REFCOUNTED_HE_KEY_UTF8;
3089     if (!hash && SvIsCOW_shared_hash(key))
3090         hash = SvSHARED_HASH(key);
3091     return refcounted_he_fetch_pvn(chain, keypv, keylen, hash, flags);
3092 }
3093
3094 /*
3095 =for apidoc m|struct refcounted_he *|refcounted_he_new_pvn|struct refcounted_he *parent|const char *keypv|STRLEN keylen|U32 hash|SV *value|U32 flags
3096
3097 Creates a new C<refcounted_he>.  This consists of a single key/value
3098 pair and a reference to an existing C<refcounted_he> chain (which may
3099 be empty), and thus forms a longer chain.  When using the longer chain,
3100 the new key/value pair takes precedence over any entry for the same key
3101 further along the chain.
3102
3103 The new key is specified by I<keypv> and I<keylen>.  If I<flags> has
3104 the C<REFCOUNTED_HE_KEY_UTF8> bit set, the key octets are interpreted
3105 as UTF-8, otherwise they are interpreted as Latin-1.  I<hash> is
3106 a precomputed hash of the key string, or zero if it has not been
3107 precomputed.
3108
3109 I<value> is the scalar value to store for this key.  I<value> is copied
3110 by this function, which thus does not take ownership of any reference
3111 to it, and later changes to the scalar will not be reflected in the
3112 value visible in the C<refcounted_he>.  Complex types of scalar will not
3113 be stored with referential integrity, but will be coerced to strings.
3114 I<value> may be either null or C<&PL_sv_placeholder> to indicate that no
3115 value is to be associated with the key; this, as with any non-null value,
3116 takes precedence over the existence of a value for the key further along
3117 the chain.
3118
3119 I<parent> points to the rest of the C<refcounted_he> chain to be
3120 attached to the new C<refcounted_he>.  This function takes ownership
3121 of one reference to I<parent>, and returns one reference to the new
3122 C<refcounted_he>.
3123
3124 =cut
3125 */
3126
3127 struct refcounted_he *
3128 Perl_refcounted_he_new_pvn(pTHX_ struct refcounted_he *parent,
3129         const char *keypv, STRLEN keylen, U32 hash, SV *value, U32 flags)
3130 {
3131     dVAR;
3132     STRLEN value_len = 0;
3133     const char *value_p = NULL;
3134     bool is_pv;
3135     char value_type;
3136     char hekflags;
3137     STRLEN key_offset = 1;
3138     struct refcounted_he *he;
3139     PERL_ARGS_ASSERT_REFCOUNTED_HE_NEW_PVN;
3140
3141     if (!value || value == &PL_sv_placeholder) {
3142         value_type = HVrhek_delete;
3143     } else if (SvPOK(value)) {
3144         value_type = HVrhek_PV;
3145     } else if (SvIOK(value)) {
3146         value_type = SvUOK((const SV *)value) ? HVrhek_UV : HVrhek_IV;
3147     } else if (!SvOK(value)) {
3148         value_type = HVrhek_undef;
3149     } else {
3150         value_type = HVrhek_PV;
3151     }
3152     is_pv = value_type == HVrhek_PV;
3153     if (is_pv) {
3154         /* Do it this way so that the SvUTF8() test is after the SvPV, in case
3155            the value is overloaded, and doesn't yet have the UTF-8flag set.  */
3156         value_p = SvPV_const(value, value_len);
3157         if (SvUTF8(value))
3158             value_type = HVrhek_PV_UTF8;
3159         key_offset = value_len + 2;
3160     }
3161     hekflags = value_type;
3162
3163     if (flags & REFCOUNTED_HE_KEY_UTF8) {
3164         /* Canonicalise to Latin-1 where possible. */
3165         const char *keyend = keypv + keylen, *p;
3166         STRLEN nonascii_count = 0;
3167         for (p = keypv; p != keyend; p++) {
3168             U8 c = (U8)*p;
3169             if (c & 0x80) {
3170                 if (!((c & 0xfe) == 0xc2 && ++p != keyend &&
3171                             (((U8)*p) & 0xc0) == 0x80))
3172                     goto canonicalised_key;
3173                 nonascii_count++;
3174             }
3175         }
3176         if (nonascii_count) {
3177             char *q;
3178             const char *p = keypv, *keyend = keypv + keylen;
3179             keylen -= nonascii_count;
3180             Newx(q, keylen, char);
3181             SAVEFREEPV(q);
3182             keypv = q;
3183             for (; p != keyend; p++, q++) {
3184                 U8 c = (U8)*p;
3185                 *q = (char)
3186                     ((c & 0x80) ? ((c & 0x03) << 6) | (((U8)*++p) & 0x3f) : c);
3187             }
3188         }
3189         flags &= ~REFCOUNTED_HE_KEY_UTF8;
3190         canonicalised_key: ;
3191     }
3192     if (flags & REFCOUNTED_HE_KEY_UTF8)
3193         hekflags |= HVhek_UTF8;
3194     if (!hash)
3195         PERL_HASH(hash, keypv, keylen);
3196
3197 #ifdef USE_ITHREADS
3198     he = (struct refcounted_he*)
3199         PerlMemShared_malloc(sizeof(struct refcounted_he) - 1
3200                              + keylen
3201                              + key_offset);
3202 #else
3203     he = (struct refcounted_he*)
3204         PerlMemShared_malloc(sizeof(struct refcounted_he) - 1
3205                              + key_offset);
3206 #endif
3207
3208     he->refcounted_he_next = parent;
3209
3210     if (is_pv) {
3211         Copy(value_p, he->refcounted_he_data + 1, value_len + 1, char);
3212         he->refcounted_he_val.refcounted_he_u_len = value_len;
3213     } else if (value_type == HVrhek_IV) {
3214         he->refcounted_he_val.refcounted_he_u_iv = SvIVX(value);
3215     } else if (value_type == HVrhek_UV) {
3216         he->refcounted_he_val.refcounted_he_u_uv = SvUVX(value);
3217     }
3218
3219 #ifdef USE_ITHREADS
3220     he->refcounted_he_hash = hash;
3221     he->refcounted_he_keylen = keylen;
3222     Copy(keypv, he->refcounted_he_data + key_offset, keylen, char);
3223 #else
3224     he->refcounted_he_hek = share_hek_flags(keypv, keylen, hash, hekflags);
3225 #endif
3226
3227     he->refcounted_he_data[0] = hekflags;
3228     he->refcounted_he_refcnt = 1;
3229
3230     return he;
3231 }
3232
3233 /*
3234 =for apidoc m|struct refcounted_he *|refcounted_he_new_pv|struct refcounted_he *parent|const char *key|U32 hash|SV *value|U32 flags
3235
3236 Like L</refcounted_he_new_pvn>, but takes a nul-terminated string instead
3237 of a string/length pair.
3238
3239 =cut
3240 */
3241
3242 struct refcounted_he *
3243 Perl_refcounted_he_new_pv(pTHX_ struct refcounted_he *parent,
3244         const char *key, U32 hash, SV *value, U32 flags)
3245 {
3246     PERL_ARGS_ASSERT_REFCOUNTED_HE_NEW_PV;
3247     return refcounted_he_new_pvn(parent, key, strlen(key), hash, value, flags);
3248 }
3249
3250 /*
3251 =for apidoc m|struct refcounted_he *|refcounted_he_new_sv|struct refcounted_he *parent|SV *key|U32 hash|SV *value|U32 flags
3252
3253 Like L</refcounted_he_new_pvn>, but takes a Perl scalar instead of a
3254 string/length pair.
3255
3256 =cut
3257 */
3258
3259 struct refcounted_he *
3260 Perl_refcounted_he_new_sv(pTHX_ struct refcounted_he *parent,
3261         SV *key, U32 hash, SV *value, U32 flags)
3262 {
3263     const char *keypv;
3264     STRLEN keylen;
3265     PERL_ARGS_ASSERT_REFCOUNTED_HE_NEW_SV;
3266     if (flags & REFCOUNTED_HE_KEY_UTF8)
3267         Perl_croak(aTHX_ "panic: refcounted_he_new_sv bad flags %"UVxf,
3268             (UV)flags);
3269     keypv = SvPV_const(key, keylen);
3270     if (SvUTF8(key))
3271         flags |= REFCOUNTED_HE_KEY_UTF8;
3272     if (!hash && SvIsCOW_shared_hash(key))
3273         hash = SvSHARED_HASH(key);
3274     return refcounted_he_new_pvn(parent, keypv, keylen, hash, value, flags);
3275 }
3276
3277 /*
3278 =for apidoc m|void|refcounted_he_free|struct refcounted_he *he
3279
3280 Decrements the reference count of a C<refcounted_he> by one.  If the
3281 reference count reaches zero the structure's memory is freed, which
3282 (recursively) causes a reduction of its parent C<refcounted_he>'s
3283 reference count.  It is safe to pass a null pointer to this function:
3284 no action occurs in this case.
3285
3286 =cut
3287 */
3288
3289 void
3290 Perl_refcounted_he_free(pTHX_ struct refcounted_he *he) {
3291     dVAR;
3292     PERL_UNUSED_CONTEXT;
3293
3294     while (he) {
3295         struct refcounted_he *copy;
3296         U32 new_count;
3297
3298         HINTS_REFCNT_LOCK;
3299         new_count = --he->refcounted_he_refcnt;
3300         HINTS_REFCNT_UNLOCK;
3301         
3302         if (new_count) {
3303             return;
3304         }
3305
3306 #ifndef USE_ITHREADS
3307         unshare_hek_or_pvn (he->refcounted_he_hek, 0, 0, 0);
3308 #endif
3309         copy = he;
3310         he = he->refcounted_he_next;
3311         PerlMemShared_free(copy);
3312     }
3313 }
3314
3315 /*
3316 =for apidoc m|struct refcounted_he *|refcounted_he_inc|struct refcounted_he *he
3317
3318 Increment the reference count of a C<refcounted_he>.  The pointer to the
3319 C<refcounted_he> is also returned.  It is safe to pass a null pointer
3320 to this function: no action occurs and a null pointer is returned.
3321
3322 =cut
3323 */
3324
3325 struct refcounted_he *
3326 Perl_refcounted_he_inc(pTHX_ struct refcounted_he *he)
3327 {
3328     dVAR;
3329     if (he) {
3330         HINTS_REFCNT_LOCK;
3331         he->refcounted_he_refcnt++;
3332         HINTS_REFCNT_UNLOCK;
3333     }
3334     return he;
3335 }
3336
3337 /*
3338 =for apidoc cop_fetch_label
3339
3340 Returns the label attached to a cop.
3341 The flags pointer may be set to C<SVf_UTF8> or 0.
3342
3343 =cut
3344 */
3345
3346 /* pp_entereval is aware that labels are stored with a key ':' at the top of
3347    the linked list.  */
3348 const char *
3349 Perl_cop_fetch_label(pTHX_ COP *const cop, STRLEN *len, U32 *flags) {
3350     struct refcounted_he *const chain = cop->cop_hints_hash;
3351
3352     PERL_ARGS_ASSERT_COP_FETCH_LABEL;
3353
3354     if (!chain)
3355         return NULL;
3356 #ifdef USE_ITHREADS
3357     if (chain->refcounted_he_keylen != 1)
3358         return NULL;
3359     if (*REF_HE_KEY(chain) != ':')
3360         return NULL;
3361 #else
3362     if ((STRLEN)HEK_LEN(chain->refcounted_he_hek) != 1)
3363         return NULL;
3364     if (*HEK_KEY(chain->refcounted_he_hek) != ':')
3365         return NULL;
3366 #endif
3367     /* Stop anyone trying to really mess us up by adding their own value for
3368        ':' into %^H  */
3369     if ((chain->refcounted_he_data[0] & HVrhek_typemask) != HVrhek_PV
3370         && (chain->refcounted_he_data[0] & HVrhek_typemask) != HVrhek_PV_UTF8)
3371         return NULL;
3372
3373     if (len)
3374         *len = chain->refcounted_he_val.refcounted_he_u_len;
3375     if (flags) {
3376         *flags = ((chain->refcounted_he_data[0] & HVrhek_typemask)
3377                   == HVrhek_PV_UTF8) ? SVf_UTF8 : 0;
3378     }
3379     return chain->refcounted_he_data + 1;
3380 }
3381
3382 /*
3383 =for apidoc cop_store_label
3384
3385 Save a label into a C<cop_hints_hash>. You need to set flags to C<SVf_UTF8>
3386 for a utf-8 label.
3387
3388 =cut
3389 */
3390
3391 void
3392 Perl_cop_store_label(pTHX_ COP *const cop, const char *label, STRLEN len,
3393                      U32 flags)
3394 {
3395     SV *labelsv;
3396     PERL_ARGS_ASSERT_COP_STORE_LABEL;
3397
3398     if (flags & ~(SVf_UTF8))
3399         Perl_croak(aTHX_ "panic: cop_store_label illegal flag bits 0x%" UVxf,
3400                    (UV)flags);
3401     labelsv = newSVpvn_flags(label, len, SVs_TEMP);
3402     if (flags & SVf_UTF8)
3403         SvUTF8_on(labelsv);
3404     cop->cop_hints_hash
3405         = refcounted_he_new_pvs(cop->cop_hints_hash, ":", labelsv, 0);
3406 }
3407
3408 /*
3409 =for apidoc hv_assert
3410
3411 Check that a hash is in an internally consistent state.
3412
3413 =cut
3414 */
3415
3416 #ifdef DEBUGGING
3417
3418 void
3419 Perl_hv_assert(pTHX_ HV *hv)
3420 {
3421     dVAR;
3422     HE* entry;
3423     int withflags = 0;
3424     int placeholders = 0;
3425     int real = 0;
3426     int bad = 0;
3427     const I32 riter = HvRITER_get(hv);
3428     HE *eiter = HvEITER_get(hv);
3429
3430     PERL_ARGS_ASSERT_HV_ASSERT;
3431
3432     (void)hv_iterinit(hv);
3433
3434     while ((entry = hv_iternext_flags(hv, HV_ITERNEXT_WANTPLACEHOLDERS))) {
3435         /* sanity check the values */
3436         if (HeVAL(entry) == &PL_sv_placeholder)
3437             placeholders++;
3438         else
3439             real++;
3440         /* sanity check the keys */
3441         if (HeSVKEY(entry)) {
3442             NOOP;   /* Don't know what to check on SV keys.  */
3443         } else if (HeKUTF8(entry)) {
3444             withflags++;
3445             if (HeKWASUTF8(entry)) {
3446                 PerlIO_printf(Perl_debug_log,
3447                             "hash key has both WASUTF8 and UTF8: '%.*s'\n",
3448                             (int) HeKLEN(entry),  HeKEY(entry));
3449                 bad = 1;
3450             }
3451         } else if (HeKWASUTF8(entry))
3452             withflags++;
3453     }
3454     if (!SvTIED_mg((const SV *)hv, PERL_MAGIC_tied)) {
3455         static const char bad_count[] = "Count %d %s(s), but hash reports %d\n";
3456         const int nhashkeys = HvUSEDKEYS(hv);
3457         const int nhashplaceholders = HvPLACEHOLDERS_get(hv);
3458
3459         if (nhashkeys != real) {
3460             PerlIO_printf(Perl_debug_log, bad_count, real, "keys", nhashkeys );
3461             bad = 1;
3462         }
3463         if (nhashplaceholders != placeholders) {
3464             PerlIO_printf(Perl_debug_log, bad_count, placeholders, "placeholder", nhashplaceholders );
3465             bad = 1;
3466         }
3467     }
3468     if (withflags && ! HvHASKFLAGS(hv)) {
3469         PerlIO_printf(Perl_debug_log,
3470                     "Hash has HASKFLAGS off but I count %d key(s) with flags\n",
3471                     withflags);
3472         bad = 1;
3473     }
3474     if (bad) {
3475         sv_dump(MUTABLE_SV(hv));
3476     }
3477     HvRITER_set(hv, riter);             /* Restore hash iterator state */
3478     HvEITER_set(hv, eiter);
3479 }
3480
3481 #endif
3482
3483 /*
3484  * Local variables:
3485  * c-indentation-style: bsd
3486  * c-basic-offset: 4
3487  * indent-tabs-mode: t
3488  * End:
3489  *
3490  * ex: set ts=8 sts=4 sw=4 noet:
3491  */