This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
My re-implementation of hv_clear_placeholders was buggy - not sure why
[perl5.git] / hv.c
1 /*    hv.c
2  *
3  *    Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
4  *    2000, 2001, 2002, 2003, 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 of all that I have seen."  --Bilbo
13  */
14
15 /* 
16 =head1 Hash Manipulation Functions
17 */
18
19 #include "EXTERN.h"
20 #define PERL_IN_HV_C
21 #define PERL_HASH_INTERNAL_ACCESS
22 #include "perl.h"
23
24 #define HV_MAX_LENGTH_BEFORE_SPLIT 14
25
26 STATIC HE*
27 S_new_he(pTHX)
28 {
29     HE* he;
30     LOCK_SV_MUTEX;
31     if (!PL_he_root)
32         more_he();
33     he = PL_he_root;
34     PL_he_root = HeNEXT(he);
35     UNLOCK_SV_MUTEX;
36     return he;
37 }
38
39 STATIC void
40 S_del_he(pTHX_ HE *p)
41 {
42     LOCK_SV_MUTEX;
43     HeNEXT(p) = (HE*)PL_he_root;
44     PL_he_root = p;
45     UNLOCK_SV_MUTEX;
46 }
47
48 STATIC void
49 S_more_he(pTHX)
50 {
51     register HE* he;
52     register HE* heend;
53     XPV *ptr;
54     New(54, ptr, 1008/sizeof(XPV), XPV);
55     ptr->xpv_pv = (char*)PL_he_arenaroot;
56     PL_he_arenaroot = ptr;
57
58     he = (HE*)ptr;
59     heend = &he[1008 / sizeof(HE) - 1];
60     PL_he_root = ++he;
61     while (he < heend) {
62         HeNEXT(he) = (HE*)(he + 1);
63         he++;
64     }
65     HeNEXT(he) = 0;
66 }
67
68 #ifdef PURIFY
69
70 #define new_HE() (HE*)safemalloc(sizeof(HE))
71 #define del_HE(p) safefree((char*)p)
72
73 #else
74
75 #define new_HE() new_he()
76 #define del_HE(p) del_he(p)
77
78 #endif
79
80 STATIC HEK *
81 S_save_hek_flags(pTHX_ const char *str, I32 len, U32 hash, int flags)
82 {
83     int flags_masked = flags & HVhek_MASK;
84     char *k;
85     register HEK *hek;
86
87     New(54, k, HEK_BASESIZE + len + 2, char);
88     hek = (HEK*)k;
89     Copy(str, HEK_KEY(hek), len, char);
90     HEK_KEY(hek)[len] = 0;
91     HEK_LEN(hek) = len;
92     HEK_HASH(hek) = hash;
93     HEK_FLAGS(hek) = (unsigned char)flags_masked;
94
95     if (flags & HVhek_FREEKEY)
96         Safefree(str);
97     return hek;
98 }
99
100 /* free the pool of temporary HE/HEK pairs retunrned by hv_fetch_ent
101  * for tied hashes */
102
103 void
104 Perl_free_tied_hv_pool(pTHX)
105 {
106     HE *ohe;
107     HE *he = PL_hv_fetch_ent_mh;
108     while (he) {
109         Safefree(HeKEY_hek(he));
110         ohe = he;
111         he = HeNEXT(he);
112         del_HE(ohe);
113     }
114     PL_hv_fetch_ent_mh = Nullhe;
115 }
116
117 #if defined(USE_ITHREADS)
118 HE *
119 Perl_he_dup(pTHX_ HE *e, bool shared, CLONE_PARAMS* param)
120 {
121     HE *ret;
122
123     if (!e)
124         return Nullhe;
125     /* look for it in the table first */
126     ret = (HE*)ptr_table_fetch(PL_ptr_table, e);
127     if (ret)
128         return ret;
129
130     /* create anew and remember what it is */
131     ret = new_HE();
132     ptr_table_store(PL_ptr_table, e, ret);
133
134     HeNEXT(ret) = he_dup(HeNEXT(e),shared, param);
135     if (HeKLEN(e) == HEf_SVKEY) {
136         char *k;
137         New(54, k, HEK_BASESIZE + sizeof(SV*), char);
138         HeKEY_hek(ret) = (HEK*)k;
139         HeKEY_sv(ret) = SvREFCNT_inc(sv_dup(HeKEY_sv(e), param));
140     }
141     else if (shared)
142         HeKEY_hek(ret) = share_hek_flags(HeKEY(e), HeKLEN(e), HeHASH(e),
143                                          HeKFLAGS(e));
144     else
145         HeKEY_hek(ret) = save_hek_flags(HeKEY(e), HeKLEN(e), HeHASH(e),
146                                         HeKFLAGS(e));
147     HeVAL(ret) = SvREFCNT_inc(sv_dup(HeVAL(e), param));
148     return ret;
149 }
150 #endif  /* USE_ITHREADS */
151
152 static void
153 S_hv_notallowed(pTHX_ int flags, const char *key, I32 klen,
154                 const char *msg)
155 {
156     SV *sv = sv_newmortal(), *esv = sv_newmortal();
157     if (!(flags & HVhek_FREEKEY)) {
158         sv_setpvn(sv, key, klen);
159     }
160     else {
161         /* Need to free saved eventually assign to mortal SV */
162         /* XXX is this line an error ???:  SV *sv = sv_newmortal(); */
163         sv_usepvn(sv, (char *) key, klen);
164     }
165     if (flags & HVhek_UTF8) {
166         SvUTF8_on(sv);
167     }
168     Perl_sv_setpvf(aTHX_ esv, "Attempt to %s a restricted hash", msg);
169     Perl_croak(aTHX_ SvPVX(esv), sv);
170 }
171
172 /* (klen == HEf_SVKEY) is special for MAGICAL hv entries, meaning key slot
173  * contains an SV* */
174
175 #define HV_FETCH_ISSTORE   0x01
176 #define HV_FETCH_ISEXISTS  0x02
177 #define HV_FETCH_LVALUE    0x04
178 #define HV_FETCH_JUST_SV   0x08
179
180 /*
181 =for apidoc hv_store
182
183 Stores an SV in a hash.  The hash key is specified as C<key> and C<klen> is
184 the length of the key.  The C<hash> parameter is the precomputed hash
185 value; if it is zero then Perl will compute it.  The return value will be
186 NULL if the operation failed or if the value did not need to be actually
187 stored within the hash (as in the case of tied hashes).  Otherwise it can
188 be dereferenced to get the original C<SV*>.  Note that the caller is
189 responsible for suitably incrementing the reference count of C<val> before
190 the call, and decrementing it if the function returned NULL.  Effectively
191 a successful hv_store takes ownership of one reference to C<val>.  This is
192 usually what you want; a newly created SV has a reference count of one, so
193 if all your code does is create SVs then store them in a hash, hv_store
194 will own the only reference to the new SV, and your code doesn't need to do
195 anything further to tidy up.  hv_store is not implemented as a call to
196 hv_store_ent, and does not create a temporary SV for the key, so if your
197 key data is not already in SV form then use hv_store in preference to
198 hv_store_ent.
199
200 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
201 information on how to use this function on tied hashes.
202
203 =cut
204 */
205
206 SV**
207 Perl_hv_store(pTHX_ HV *hv, const char *key, I32 klen_i32, SV *val, U32 hash)
208 {
209     HE *hek;
210     STRLEN klen;
211     int flags;
212
213     if (klen_i32 < 0) {
214         klen = -klen_i32;
215         flags = HVhek_UTF8;
216     } else {
217         klen = klen_i32;
218         flags = 0;
219     }
220     hek = hv_fetch_common (hv, NULL, key, klen, flags,
221                            (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, 0);
222     return hek ? &HeVAL(hek) : NULL;
223 }
224
225 SV**
226 Perl_hv_store_flags(pTHX_ HV *hv, const char *key, I32 klen, SV *val,
227                  register U32 hash, int flags)
228 {
229     HE *hek = hv_fetch_common (hv, NULL, key, klen, flags,
230                                (HV_FETCH_ISSTORE|HV_FETCH_JUST_SV), val, hash);
231     return hek ? &HeVAL(hek) : NULL;
232 }
233
234 /*
235 =for apidoc hv_store_ent
236
237 Stores C<val> in a hash.  The hash key is specified as C<key>.  The C<hash>
238 parameter is the precomputed hash value; if it is zero then Perl will
239 compute it.  The return value is the new hash entry so created.  It will be
240 NULL if the operation failed or if the value did not need to be actually
241 stored within the hash (as in the case of tied hashes).  Otherwise the
242 contents of the return value can be accessed using the C<He?> macros
243 described here.  Note that the caller is responsible for suitably
244 incrementing the reference count of C<val> before the call, and
245 decrementing it if the function returned NULL.  Effectively a successful
246 hv_store_ent takes ownership of one reference to C<val>.  This is
247 usually what you want; a newly created SV has a reference count of one, so
248 if all your code does is create SVs then store them in a hash, hv_store
249 will own the only reference to the new SV, and your code doesn't need to do
250 anything further to tidy up.  Note that hv_store_ent only reads the C<key>;
251 unlike C<val> it does not take ownership of it, so maintaining the correct
252 reference count on C<key> is entirely the caller's responsibility.  hv_store
253 is not implemented as a call to hv_store_ent, and does not create a temporary
254 SV for the key, so if your key data is not already in SV form then use
255 hv_store in preference to hv_store_ent.
256
257 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
258 information on how to use this function on tied hashes.
259
260 =cut
261 */
262
263 HE *
264 Perl_hv_store_ent(pTHX_ HV *hv, SV *keysv, SV *val, U32 hash)
265 {
266   return hv_fetch_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISSTORE, val, hash);
267 }
268
269 /*
270 =for apidoc hv_exists
271
272 Returns a boolean indicating whether the specified hash key exists.  The
273 C<klen> is the length of the key.
274
275 =cut
276 */
277
278 bool
279 Perl_hv_exists(pTHX_ HV *hv, const char *key, I32 klen_i32)
280 {
281     STRLEN klen;
282     int flags;
283
284     if (klen_i32 < 0) {
285         klen = -klen_i32;
286         flags = HVhek_UTF8;
287     } else {
288         klen = klen_i32;
289         flags = 0;
290     }
291     return hv_fetch_common(hv, NULL, key, klen, flags, HV_FETCH_ISEXISTS, 0, 0)
292         ? TRUE : FALSE;
293 }
294
295 /*
296 =for apidoc hv_fetch
297
298 Returns the SV which corresponds to the specified key in the hash.  The
299 C<klen> is the length of the key.  If C<lval> is set then the fetch will be
300 part of a store.  Check that the return value is non-null before
301 dereferencing it to an C<SV*>.
302
303 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
304 information on how to use this function on tied hashes.
305
306 =cut
307 */
308
309 SV**
310 Perl_hv_fetch(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 lval)
311 {
312     HE *hek;
313     STRLEN klen;
314     int flags;
315
316     if (klen_i32 < 0) {
317         klen = -klen_i32;
318         flags = HVhek_UTF8;
319     } else {
320         klen = klen_i32;
321         flags = 0;
322     }
323     hek = hv_fetch_common (hv, NULL, key, klen, flags,
324                            HV_FETCH_JUST_SV | (lval ? HV_FETCH_LVALUE : 0),
325                            Nullsv, 0);
326     return hek ? &HeVAL(hek) : NULL;
327 }
328
329 /*
330 =for apidoc hv_exists_ent
331
332 Returns a boolean indicating whether the specified hash key exists. C<hash>
333 can be a valid precomputed hash value, or 0 to ask for it to be
334 computed.
335
336 =cut
337 */
338
339 bool
340 Perl_hv_exists_ent(pTHX_ HV *hv, SV *keysv, U32 hash)
341 {
342     return hv_fetch_common(hv, keysv, NULL, 0, 0, HV_FETCH_ISEXISTS, 0, hash)
343         ? TRUE : FALSE;
344 }
345
346 /* returns an HE * structure with the all fields set */
347 /* note that hent_val will be a mortal sv for MAGICAL hashes */
348 /*
349 =for apidoc hv_fetch_ent
350
351 Returns the hash entry which corresponds to the specified key in the hash.
352 C<hash> must be a valid precomputed hash number for the given C<key>, or 0
353 if you want the function to compute it.  IF C<lval> is set then the fetch
354 will be part of a store.  Make sure the return value is non-null before
355 accessing it.  The return value when C<tb> is a tied hash is a pointer to a
356 static location, so be sure to make a copy of the structure if you need to
357 store it somewhere.
358
359 See L<perlguts/"Understanding the Magic of Tied Hashes and Arrays"> for more
360 information on how to use this function on tied hashes.
361
362 =cut
363 */
364
365 HE *
366 Perl_hv_fetch_ent(pTHX_ HV *hv, SV *keysv, I32 lval, register U32 hash)
367 {
368     return hv_fetch_common(hv, keysv, NULL, 0, 0, 
369                            (lval ? HV_FETCH_LVALUE : 0), Nullsv, hash);
370 }
371
372 STATIC HE *
373 S_hv_fetch_common(pTHX_ HV *hv, SV *keysv, const char *key, STRLEN klen,
374                   int flags, int action, SV *val, register U32 hash)
375 {
376     XPVHV* xhv;
377     U32 n_links;
378     HE *entry;
379     HE **oentry;
380     SV *sv;
381     bool is_utf8;
382     int masked_flags;
383
384     if (!hv)
385         return 0;
386
387     if (keysv) {
388         if (flags & HVhek_FREEKEY)
389             Safefree(key);
390         key = SvPV(keysv, klen);
391         flags = 0;
392         is_utf8 = (SvUTF8(keysv) != 0);
393     } else {
394         is_utf8 = ((flags & HVhek_UTF8) ? TRUE : FALSE);
395     }
396
397     xhv = (XPVHV*)SvANY(hv);
398     if (SvMAGICAL(hv)) {
399         if (SvRMAGICAL(hv) && !(action & (HV_FETCH_ISSTORE|HV_FETCH_ISEXISTS)))
400           {
401             if (mg_find((SV*)hv, PERL_MAGIC_tied) || SvGMAGICAL((SV*)hv)) {
402                 sv = sv_newmortal();
403
404                 /* XXX should be able to skimp on the HE/HEK here when
405                    HV_FETCH_JUST_SV is true.  */
406
407                 if (!keysv) {
408                     keysv = newSVpvn(key, klen);
409                     if (is_utf8) {
410                         SvUTF8_on(keysv);
411                     }
412                 } else {
413                     keysv = newSVsv(keysv);
414                 }
415                 mg_copy((SV*)hv, sv, (char *)keysv, HEf_SVKEY);
416
417                 /* grab a fake HE/HEK pair from the pool or make a new one */
418                 entry = PL_hv_fetch_ent_mh;
419                 if (entry)
420                     PL_hv_fetch_ent_mh = HeNEXT(entry);
421                 else {
422                     char *k;
423                     entry = new_HE();
424                     New(54, k, HEK_BASESIZE + sizeof(SV*), char);
425                     HeKEY_hek(entry) = (HEK*)k;
426                 }
427                 HeNEXT(entry) = Nullhe;
428                 HeSVKEY_set(entry, keysv);
429                 HeVAL(entry) = sv;
430                 sv_upgrade(sv, SVt_PVLV);
431                 LvTYPE(sv) = 'T';
432                  /* so we can free entry when freeing sv */
433                 LvTARG(sv) = (SV*)entry;
434
435                 /* XXX remove at some point? */
436                 if (flags & HVhek_FREEKEY)
437                     Safefree(key);
438
439                 return entry;
440             }
441 #ifdef ENV_IS_CASELESS
442             else if (mg_find((SV*)hv, PERL_MAGIC_env)) {
443                 U32 i;
444                 for (i = 0; i < klen; ++i)
445                     if (isLOWER(key[i])) {
446                         /* Would be nice if we had a routine to do the
447                            copy and upercase in a single pass through.  */
448                         char *nkey = strupr(savepvn(key,klen));
449                         /* Note that this fetch is for nkey (the uppercased
450                            key) whereas the store is for key (the original)  */
451                         entry = hv_fetch_common(hv, Nullsv, nkey, klen,
452                                                 HVhek_FREEKEY, /* free nkey */
453                                                 0 /* non-LVAL fetch */,
454                                                 Nullsv /* no value */,
455                                                 0 /* compute hash */);
456                         if (!entry && (action & HV_FETCH_LVALUE)) {
457                             /* This call will free key if necessary.
458                                Do it this way to encourage compiler to tail
459                                call optimise.  */
460                             entry = hv_fetch_common(hv, keysv, key, klen,
461                                                     flags, HV_FETCH_ISSTORE,
462                                                     NEWSV(61,0), hash);
463                         } else {
464                             if (flags & HVhek_FREEKEY)
465                                 Safefree(key);
466                         }
467                         return entry;
468                     }
469             }
470 #endif
471         } /* ISFETCH */
472         else if (SvRMAGICAL(hv) && (action & HV_FETCH_ISEXISTS)) {
473             if (mg_find((SV*)hv, PERL_MAGIC_tied) || SvGMAGICAL((SV*)hv)) {
474                 SV* svret;
475                 /* I don't understand why hv_exists_ent has svret and sv,
476                    whereas hv_exists only had one.  */
477                 svret = sv_newmortal();
478                 sv = sv_newmortal();
479
480                 if (keysv || is_utf8) {
481                     if (!keysv) {
482                         keysv = newSVpvn(key, klen);
483                         SvUTF8_on(keysv);
484                     } else {
485                         keysv = newSVsv(keysv);
486                     }
487                     mg_copy((SV*)hv, sv, (char *)sv_2mortal(keysv), HEf_SVKEY);
488                 } else {
489                     mg_copy((SV*)hv, sv, key, klen);
490                 }
491                 if (flags & HVhek_FREEKEY)
492                     Safefree(key);
493                 magic_existspack(svret, mg_find(sv, PERL_MAGIC_tiedelem));
494                 /* This cast somewhat evil, but I'm merely using NULL/
495                    not NULL to return the boolean exists.
496                    And I know hv is not NULL.  */
497                 return SvTRUE(svret) ? (HE *)hv : NULL;
498                 }
499 #ifdef ENV_IS_CASELESS
500             else if (mg_find((SV*)hv, PERL_MAGIC_env)) {
501                 /* XXX This code isn't UTF8 clean.  */
502                 const char *keysave = key;
503                 /* Will need to free this, so set FREEKEY flag.  */
504                 key = savepvn(key,klen);
505                 key = (const char*)strupr((char*)key);
506                 is_utf8 = 0;
507                 hash = 0;
508
509                 if (flags & HVhek_FREEKEY) {
510                     Safefree(keysave);
511                 }
512                 flags |= HVhek_FREEKEY;
513             }
514 #endif
515         } /* ISEXISTS */
516         else if (action & HV_FETCH_ISSTORE) {
517             bool needs_copy;
518             bool needs_store;
519             hv_magic_check (hv, &needs_copy, &needs_store);
520             if (needs_copy) {
521                 bool save_taint = PL_tainted;   
522                 if (keysv || is_utf8) {
523                     if (!keysv) {
524                         keysv = newSVpvn(key, klen);
525                         SvUTF8_on(keysv);
526                     }
527                     if (PL_tainting)
528                         PL_tainted = SvTAINTED(keysv);
529                     keysv = sv_2mortal(newSVsv(keysv));
530                     mg_copy((SV*)hv, val, (char*)keysv, HEf_SVKEY);
531                 } else {
532                     mg_copy((SV*)hv, val, key, klen);
533                 }
534
535                 TAINT_IF(save_taint);
536                 if (!xhv->xhv_array /* !HvARRAY(hv) */ && !needs_store) {
537                     if (flags & HVhek_FREEKEY)
538                         Safefree(key);
539                     return Nullhe;
540                 }
541 #ifdef ENV_IS_CASELESS
542                 else if (mg_find((SV*)hv, PERL_MAGIC_env)) {
543                     /* XXX This code isn't UTF8 clean.  */
544                     const char *keysave = key;
545                     /* Will need to free this, so set FREEKEY flag.  */
546                     key = savepvn(key,klen);
547                     key = (const char*)strupr((char*)key);
548                     is_utf8 = 0;
549                     hash = 0;
550
551                     if (flags & HVhek_FREEKEY) {
552                         Safefree(keysave);
553                     }
554                     flags |= HVhek_FREEKEY;
555                 }
556 #endif
557             }
558         } /* ISSTORE */
559     } /* SvMAGICAL */
560
561     if (!xhv->xhv_array /* !HvARRAY(hv) */) {
562         if ((action & (HV_FETCH_LVALUE | HV_FETCH_ISSTORE))
563 #ifdef DYNAMIC_ENV_FETCH  /* if it's an %ENV lookup, we may get it on the fly */
564                  || (SvRMAGICAL((SV*)hv) && mg_find((SV*)hv, PERL_MAGIC_env))
565 #endif
566                                                                   )
567             Newz(503, xhv->xhv_array /* HvARRAY(hv) */,
568                  PERL_HV_ARRAY_ALLOC_BYTES(xhv->xhv_max+1 /* HvMAX(hv)+1 */),
569                  char);
570 #ifdef DYNAMIC_ENV_FETCH
571         else if (action & HV_FETCH_ISEXISTS) {
572             /* for an %ENV exists, if we do an insert it's by a recursive
573                store call, so avoid creating HvARRAY(hv) right now.  */
574         }
575 #endif
576         else {
577             /* XXX remove at some point? */
578             if (flags & HVhek_FREEKEY)
579                 Safefree(key);
580
581             return 0;
582         }
583     }
584
585     if (is_utf8) {
586         const char *keysave = key;
587         key = (char*)bytes_from_utf8((U8*)key, &klen, &is_utf8);
588         if (is_utf8)
589             flags |= HVhek_UTF8;
590         else
591             flags &= ~HVhek_UTF8;
592         if (key != keysave) {
593             if (flags & HVhek_FREEKEY)
594                 Safefree(keysave);
595             flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
596         }
597     }
598
599     if (HvREHASH(hv)) {
600         PERL_HASH_INTERNAL(hash, key, klen);
601         /* We don't have a pointer to the hv, so we have to replicate the
602            flag into every HEK, so that hv_iterkeysv can see it.  */
603         /* And yes, you do need this even though you are not "storing" because
604            you can flip the flags below if doing an lval lookup.  (And that
605            was put in to give the semantics Andreas was expecting.)  */
606         flags |= HVhek_REHASH;
607     } else if (!hash) {
608         if (keysv && (SvIsCOW_shared_hash(keysv))) {
609             hash = SvUVX(keysv);
610         } else {
611             PERL_HASH(hash, key, klen);
612         }
613     }
614
615     masked_flags = (flags & HVhek_MASK);
616     n_links = 0;
617
618 #ifdef DYNAMIC_ENV_FETCH
619     if (!xhv->xhv_array /* !HvARRAY(hv) */) entry = Null(HE*);
620     else
621 #endif
622     {
623         /* entry = (HvARRAY(hv))[hash & (I32) HvMAX(hv)]; */
624         entry = ((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
625     }
626     for (; entry; ++n_links, entry = HeNEXT(entry)) {
627         if (HeHASH(entry) != hash)              /* strings can't be equal */
628             continue;
629         if (HeKLEN(entry) != (I32)klen)
630             continue;
631         if (HeKEY(entry) != key && memNE(HeKEY(entry),key,klen))        /* is this it? */
632             continue;
633         if ((HeKFLAGS(entry) ^ masked_flags) & HVhek_UTF8)
634             continue;
635
636         if (action & (HV_FETCH_LVALUE|HV_FETCH_ISSTORE)) {
637             if (HeKFLAGS(entry) != masked_flags) {
638                 /* We match if HVhek_UTF8 bit in our flags and hash key's
639                    match.  But if entry was set previously with HVhek_WASUTF8
640                    and key now doesn't (or vice versa) then we should change
641                    the key's flag, as this is assignment.  */
642                 if (HvSHAREKEYS(hv)) {
643                     /* Need to swap the key we have for a key with the flags we
644                        need. As keys are shared we can't just write to the
645                        flag, so we share the new one, unshare the old one.  */
646                     HEK *new_hek = share_hek_flags(key, klen, hash,
647                                                    masked_flags);
648                     unshare_hek (HeKEY_hek(entry));
649                     HeKEY_hek(entry) = new_hek;
650                 }
651                 else
652                     HeKFLAGS(entry) = masked_flags;
653                 if (masked_flags & HVhek_ENABLEHVKFLAGS)
654                     HvHASKFLAGS_on(hv);
655             }
656             if (HeVAL(entry) == &PL_sv_placeholder) {
657                 /* yes, can store into placeholder slot */
658                 if (action & HV_FETCH_LVALUE) {
659                     if (SvMAGICAL(hv)) {
660                         /* This preserves behaviour with the old hv_fetch
661                            implementation which at this point would bail out
662                            with a break; (at "if we find a placeholder, we
663                            pretend we haven't found anything")
664
665                            That break mean that if a placeholder were found, it
666                            caused a call into hv_store, which in turn would
667                            check magic, and if there is no magic end up pretty
668                            much back at this point (in hv_store's code).  */
669                         break;
670                     }
671                     /* LVAL fetch which actaully needs a store.  */
672                     val = NEWSV(61,0);
673                     xhv->xhv_placeholders--;
674                 } else {
675                     /* store */
676                     if (val != &PL_sv_placeholder)
677                         xhv->xhv_placeholders--;
678                 }
679                 HeVAL(entry) = val;
680             } else if (action & HV_FETCH_ISSTORE) {
681                 SvREFCNT_dec(HeVAL(entry));
682                 HeVAL(entry) = val;
683             }
684         } else if (HeVAL(entry) == &PL_sv_placeholder) {
685             /* if we find a placeholder, we pretend we haven't found
686                anything */
687             break;
688         }
689         if (flags & HVhek_FREEKEY)
690             Safefree(key);
691         return entry;
692     }
693 #ifdef DYNAMIC_ENV_FETCH  /* %ENV lookup?  If so, try to fetch the value now */
694     if (!(action & HV_FETCH_ISSTORE) 
695         && SvRMAGICAL((SV*)hv) && mg_find((SV*)hv, PERL_MAGIC_env)) {
696         unsigned long len;
697         char *env = PerlEnv_ENVgetenv_len(key,&len);
698         if (env) {
699             sv = newSVpvn(env,len);
700             SvTAINTED_on(sv);
701             return hv_fetch_common(hv,keysv,key,klen,flags,HV_FETCH_ISSTORE,sv,
702                                    hash);
703         }
704     }
705 #endif
706
707     if (!entry && SvREADONLY(hv) && !(action & HV_FETCH_ISEXISTS)) {
708         S_hv_notallowed(aTHX_ flags, key, klen,
709                         "access disallowed key '%"SVf"' in"
710                         );
711     }
712     if (!(action & (HV_FETCH_LVALUE|HV_FETCH_ISSTORE))) {
713         /* Not doing some form of store, so return failure.  */
714         if (flags & HVhek_FREEKEY)
715             Safefree(key);
716         return 0;
717     }
718     if (action & HV_FETCH_LVALUE) {
719         val = NEWSV(61,0);
720         if (SvMAGICAL(hv)) {
721             /* At this point the old hv_fetch code would call to hv_store,
722                which in turn might do some tied magic. So we need to make that
723                magic check happen.  */
724             /* gonna assign to this, so it better be there */
725             return hv_fetch_common(hv, keysv, key, klen, flags,
726                                    HV_FETCH_ISSTORE, val, hash);
727             /* XXX Surely that could leak if the fetch-was-store fails?
728                Just like the hv_fetch.  */
729         }
730     }
731
732     /* Welcome to hv_store...  */
733
734     if (!xhv->xhv_array) {
735         /* Not sure if we can get here.  I think the only case of oentry being
736            NULL is for %ENV with dynamic env fetch.  But that should disappear
737            with magic in the previous code.  */
738         Newz(503, xhv->xhv_array /* HvARRAY(hv) */,
739              PERL_HV_ARRAY_ALLOC_BYTES(xhv->xhv_max+1 /* HvMAX(hv)+1 */),
740              char);
741     }
742
743     oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
744
745     entry = new_HE();
746     /* share_hek_flags will do the free for us.  This might be considered
747        bad API design.  */
748     if (HvSHAREKEYS(hv))
749         HeKEY_hek(entry) = share_hek_flags(key, klen, hash, flags);
750     else                                       /* gotta do the real thing */
751         HeKEY_hek(entry) = save_hek_flags(key, klen, hash, flags);
752     HeVAL(entry) = val;
753     HeNEXT(entry) = *oentry;
754     *oentry = entry;
755
756     if (val == &PL_sv_placeholder)
757         xhv->xhv_placeholders++;
758     if (masked_flags & HVhek_ENABLEHVKFLAGS)
759         HvHASKFLAGS_on(hv);
760
761     xhv->xhv_keys++; /* HvKEYS(hv)++ */
762     if (!n_links) {                             /* initial entry? */
763         xhv->xhv_fill++; /* HvFILL(hv)++ */
764     } else if ((xhv->xhv_keys > (IV)xhv->xhv_max)
765                || ((n_links > HV_MAX_LENGTH_BEFORE_SPLIT) && !HvREHASH(hv))) {
766         /* Use only the old HvKEYS(hv) > HvMAX(hv) condition to limit bucket
767            splits on a rehashed hash, as we're not going to split it again,
768            and if someone is lucky (evil) enough to get all the keys in one
769            list they could exhaust our memory as we repeatedly double the
770            number of buckets on every entry. Linear search feels a less worse
771            thing to do.  */
772         hsplit(hv);
773     }
774
775     return entry;
776 }
777
778 STATIC void
779 S_hv_magic_check(pTHX_ HV *hv, bool *needs_copy, bool *needs_store)
780 {
781     MAGIC *mg = SvMAGIC(hv);
782     *needs_copy = FALSE;
783     *needs_store = TRUE;
784     while (mg) {
785         if (isUPPER(mg->mg_type)) {
786             *needs_copy = TRUE;
787             switch (mg->mg_type) {
788             case PERL_MAGIC_tied:
789             case PERL_MAGIC_sig:
790                 *needs_store = FALSE;
791             }
792         }
793         mg = mg->mg_moremagic;
794     }
795 }
796
797 /*
798 =for apidoc hv_scalar
799
800 Evaluates the hash in scalar context and returns the result. Handles magic when the hash is tied.
801
802 =cut
803 */
804
805 SV *
806 Perl_hv_scalar(pTHX_ HV *hv)
807 {
808     MAGIC *mg;
809     SV *sv;
810     
811     if ((SvRMAGICAL(hv) && (mg = mg_find((SV*)hv, PERL_MAGIC_tied)))) {
812         sv = magic_scalarpack(hv, mg);
813         return sv;
814     } 
815
816     sv = sv_newmortal();
817     if (HvFILL((HV*)hv)) 
818         Perl_sv_setpvf(aTHX_ sv, "%ld/%ld",
819                 (long)HvFILL(hv), (long)HvMAX(hv) + 1);
820     else
821         sv_setiv(sv, 0);
822     
823     return sv;
824 }
825
826 /*
827 =for apidoc hv_delete
828
829 Deletes a key/value pair in the hash.  The value SV is removed from the
830 hash and returned to the caller.  The C<klen> is the length of the key.
831 The C<flags> value will normally be zero; if set to G_DISCARD then NULL
832 will be returned.
833
834 =cut
835 */
836
837 SV *
838 Perl_hv_delete(pTHX_ HV *hv, const char *key, I32 klen_i32, I32 flags)
839 {
840     STRLEN klen;
841     int k_flags = 0;
842
843     if (klen_i32 < 0) {
844         klen = -klen_i32;
845         k_flags |= HVhek_UTF8;
846     } else {
847         klen = klen_i32;
848     }
849     return hv_delete_common(hv, NULL, key, klen, k_flags, flags, 0);
850 }
851
852 /*
853 =for apidoc hv_delete_ent
854
855 Deletes a key/value pair in the hash.  The value SV is removed from the
856 hash and returned to the caller.  The C<flags> value will normally be zero;
857 if set to G_DISCARD then NULL will be returned.  C<hash> can be a valid
858 precomputed hash value, or 0 to ask for it to be computed.
859
860 =cut
861 */
862
863 SV *
864 Perl_hv_delete_ent(pTHX_ HV *hv, SV *keysv, I32 flags, U32 hash)
865 {
866     return hv_delete_common(hv, keysv, NULL, 0, 0, flags, hash);
867 }
868
869 STATIC SV *
870 S_hv_delete_common(pTHX_ HV *hv, SV *keysv, const char *key, STRLEN klen,
871                    int k_flags, I32 d_flags, U32 hash)
872 {
873     register XPVHV* xhv;
874     register I32 i;
875     register HE *entry;
876     register HE **oentry;
877     SV *sv;
878     bool is_utf8;
879     int masked_flags;
880
881     if (!hv)
882         return Nullsv;
883
884     if (keysv) {
885         if (k_flags & HVhek_FREEKEY)
886             Safefree(key);
887         key = SvPV(keysv, klen);
888         k_flags = 0;
889         is_utf8 = (SvUTF8(keysv) != 0);
890     } else {
891         is_utf8 = ((k_flags & HVhek_UTF8) ? TRUE : FALSE);
892     }
893
894     if (SvRMAGICAL(hv)) {
895         bool needs_copy;
896         bool needs_store;
897         hv_magic_check (hv, &needs_copy, &needs_store);
898
899         if (needs_copy) {
900             entry = hv_fetch_common(hv, keysv, key, klen,
901                                     k_flags & ~HVhek_FREEKEY, HV_FETCH_LVALUE,
902                                     Nullsv, hash);
903             sv = entry ? HeVAL(entry) : NULL;
904             if (sv) {
905                 if (SvMAGICAL(sv)) {
906                     mg_clear(sv);
907                 }
908                 if (!needs_store) {
909                     if (mg_find(sv, PERL_MAGIC_tiedelem)) {
910                         /* No longer an element */
911                         sv_unmagic(sv, PERL_MAGIC_tiedelem);
912                         return sv;
913                     }           
914                     return Nullsv;              /* element cannot be deleted */
915                 }
916 #ifdef ENV_IS_CASELESS
917                 else if (mg_find((SV*)hv, PERL_MAGIC_env)) {
918                     /* XXX This code isn't UTF8 clean.  */
919                     keysv = sv_2mortal(newSVpvn(key,klen));
920                     if (k_flags & HVhek_FREEKEY) {
921                         Safefree(key);
922                     }
923                     key = strupr(SvPVX(keysv));
924                     is_utf8 = 0;
925                     k_flags = 0;
926                     hash = 0;
927                 }
928 #endif
929             }
930         }
931     }
932     xhv = (XPVHV*)SvANY(hv);
933     if (!xhv->xhv_array /* !HvARRAY(hv) */)
934         return Nullsv;
935
936     if (is_utf8) {
937     const char *keysave = key;
938     key = (char*)bytes_from_utf8((U8*)key, &klen, &is_utf8);
939
940         if (is_utf8)
941             k_flags |= HVhek_UTF8;
942         else
943             k_flags &= ~HVhek_UTF8;
944         if (key != keysave) {
945             if (k_flags & HVhek_FREEKEY) {
946                 /* This shouldn't happen if our caller does what we expect,
947                    but strictly the API allows it.  */
948                 Safefree(keysave);
949             }
950             k_flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
951         }
952         HvHASKFLAGS_on((SV*)hv);
953     }
954
955     if (HvREHASH(hv)) {
956         PERL_HASH_INTERNAL(hash, key, klen);
957     } else if (!hash) {
958         if (keysv && (SvIsCOW_shared_hash(keysv))) {
959             hash = SvUVX(keysv);
960         } else {
961             PERL_HASH(hash, key, klen);
962         }
963     }
964
965     masked_flags = (k_flags & HVhek_MASK);
966
967     /* oentry = &(HvARRAY(hv))[hash & (I32) HvMAX(hv)]; */
968     oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
969     entry = *oentry;
970     i = 1;
971     for (; entry; i=0, oentry = &HeNEXT(entry), entry = *oentry) {
972         if (HeHASH(entry) != hash)              /* strings can't be equal */
973             continue;
974         if (HeKLEN(entry) != (I32)klen)
975             continue;
976         if (HeKEY(entry) != key && memNE(HeKEY(entry),key,klen))        /* is this it? */
977             continue;
978         if ((HeKFLAGS(entry) ^ masked_flags) & HVhek_UTF8)
979             continue;
980         if (k_flags & HVhek_FREEKEY)
981             Safefree(key);
982
983         /* if placeholder is here, it's already been deleted.... */
984         if (HeVAL(entry) == &PL_sv_placeholder)
985         {
986            return Nullsv;
987         }
988         else if (SvREADONLY(hv) && HeVAL(entry) && SvREADONLY(HeVAL(entry))) {
989             S_hv_notallowed(aTHX_ k_flags, key, klen,
990                             "delete readonly key '%"SVf"' from"
991                             );
992         }
993
994         if (d_flags & G_DISCARD)
995             sv = Nullsv;
996         else {
997             sv = sv_2mortal(HeVAL(entry));
998             HeVAL(entry) = &PL_sv_placeholder;
999         }
1000
1001         /*
1002          * If a restricted hash, rather than really deleting the entry, put
1003          * a placeholder there. This marks the key as being "approved", so
1004          * we can still access via not-really-existing key without raising
1005          * an error.
1006          */
1007         if (SvREADONLY(hv)) {
1008             SvREFCNT_dec(HeVAL(entry));
1009             HeVAL(entry) = &PL_sv_placeholder;
1010             /* We'll be saving this slot, so the number of allocated keys
1011              * doesn't go down, but the number placeholders goes up */
1012             xhv->xhv_placeholders++; /* HvPLACEHOLDERS(hv)++ */
1013         } else {
1014             *oentry = HeNEXT(entry);
1015             if (i && !*oentry)
1016                 xhv->xhv_fill--; /* HvFILL(hv)-- */
1017             if (entry == xhv->xhv_eiter /* HvEITER(hv) */)
1018                 HvLAZYDEL_on(hv);
1019             else
1020                 hv_free_ent(hv, entry);
1021             xhv->xhv_keys--; /* HvKEYS(hv)-- */
1022             if (xhv->xhv_keys == 0)
1023                 HvHASKFLAGS_off(hv);
1024         }
1025         return sv;
1026     }
1027     if (SvREADONLY(hv)) {
1028         S_hv_notallowed(aTHX_ k_flags, key, klen,
1029                         "delete disallowed key '%"SVf"' from"
1030                         );
1031     }
1032
1033     if (k_flags & HVhek_FREEKEY)
1034         Safefree(key);
1035     return Nullsv;
1036 }
1037
1038 STATIC void
1039 S_hsplit(pTHX_ HV *hv)
1040 {
1041     /* Can't make this clear any placeholders first for non-restricted hashes,
1042        as Storable rebuilds restricted hashes by putting in all the
1043        placeholders (first) before turning on the readonly flag.  Hence midway
1044        through restoring the hash there are placeholders which need to remain
1045        even though the hash isn't (currently) flagged as restricted. */
1046     register XPVHV* xhv = (XPVHV*)SvANY(hv);
1047     I32 oldsize = (I32) xhv->xhv_max+1; /* HvMAX(hv)+1 (sick) */
1048     register I32 newsize = oldsize * 2;
1049     register I32 i;
1050     register char *a = xhv->xhv_array; /* HvARRAY(hv) */
1051     register HE **aep;
1052     register HE **bep;
1053     register HE *entry;
1054     register HE **oentry;
1055     int longest_chain = 0;
1056     int was_shared;
1057
1058     PL_nomemok = TRUE;
1059 #if defined(STRANGE_MALLOC) || defined(MYMALLOC)
1060     Renew(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize), char);
1061     if (!a) {
1062       PL_nomemok = FALSE;
1063       return;
1064     }
1065 #else
1066     New(2, a, PERL_HV_ARRAY_ALLOC_BYTES(newsize), char);
1067     if (!a) {
1068       PL_nomemok = FALSE;
1069       return;
1070     }
1071     Copy(xhv->xhv_array /* HvARRAY(hv) */, a, oldsize * sizeof(HE*), char);
1072     if (oldsize >= 64) {
1073         offer_nice_chunk(xhv->xhv_array /* HvARRAY(hv) */,
1074                         PERL_HV_ARRAY_ALLOC_BYTES(oldsize));
1075     }
1076     else
1077         Safefree(xhv->xhv_array /* HvARRAY(hv) */);
1078 #endif
1079
1080     PL_nomemok = FALSE;
1081     Zero(&a[oldsize * sizeof(HE*)], (newsize-oldsize) * sizeof(HE*), char);     /* zero 2nd half*/
1082     xhv->xhv_max = --newsize;   /* HvMAX(hv) = --newsize */
1083     xhv->xhv_array = a;         /* HvARRAY(hv) = a */
1084     aep = (HE**)a;
1085
1086     for (i=0; i<oldsize; i++,aep++) {
1087         int left_length = 0;
1088         int right_length = 0;
1089
1090         if (!*aep)                              /* non-existent */
1091             continue;
1092         bep = aep+oldsize;
1093         for (oentry = aep, entry = *aep; entry; entry = *oentry) {
1094             if ((HeHASH(entry) & newsize) != (U32)i) {
1095                 *oentry = HeNEXT(entry);
1096                 HeNEXT(entry) = *bep;
1097                 if (!*bep)
1098                     xhv->xhv_fill++; /* HvFILL(hv)++ */
1099                 *bep = entry;
1100                 right_length++;
1101                 continue;
1102             }
1103             else {
1104                 oentry = &HeNEXT(entry);
1105                 left_length++;
1106             }
1107         }
1108         if (!*aep)                              /* everything moved */
1109             xhv->xhv_fill--; /* HvFILL(hv)-- */
1110         /* I think we don't actually need to keep track of the longest length,
1111            merely flag if anything is too long. But for the moment while
1112            developing this code I'll track it.  */
1113         if (left_length > longest_chain)
1114             longest_chain = left_length;
1115         if (right_length > longest_chain)
1116             longest_chain = right_length;
1117     }
1118
1119
1120     /* Pick your policy for "hashing isn't working" here:  */
1121     if (longest_chain <= HV_MAX_LENGTH_BEFORE_SPLIT /* split worked?  */
1122         || HvREHASH(hv)) {
1123         return;
1124     }
1125
1126     if (hv == PL_strtab) {
1127         /* Urg. Someone is doing something nasty to the string table.
1128            Can't win.  */
1129         return;
1130     }
1131
1132     /* Awooga. Awooga. Pathological data.  */
1133     /*PerlIO_printf(PerlIO_stderr(), "%p %d of %d with %d/%d buckets\n", hv,
1134       longest_chain, HvTOTALKEYS(hv), HvFILL(hv),  1+HvMAX(hv));*/
1135
1136     ++newsize;
1137     Newz(2, a, PERL_HV_ARRAY_ALLOC_BYTES(newsize), char);
1138     was_shared = HvSHAREKEYS(hv);
1139
1140     xhv->xhv_fill = 0;
1141     HvSHAREKEYS_off(hv);
1142     HvREHASH_on(hv);
1143
1144     aep = (HE **) xhv->xhv_array;
1145
1146     for (i=0; i<newsize; i++,aep++) {
1147         entry = *aep;
1148         while (entry) {
1149             /* We're going to trash this HE's next pointer when we chain it
1150                into the new hash below, so store where we go next.  */
1151             HE *next = HeNEXT(entry);
1152             UV hash;
1153
1154             /* Rehash it */
1155             PERL_HASH_INTERNAL(hash, HeKEY(entry), HeKLEN(entry));
1156
1157             if (was_shared) {
1158                 /* Unshare it.  */
1159                 HEK *new_hek
1160                     = save_hek_flags(HeKEY(entry), HeKLEN(entry),
1161                                      hash, HeKFLAGS(entry));
1162                 unshare_hek (HeKEY_hek(entry));
1163                 HeKEY_hek(entry) = new_hek;
1164             } else {
1165                 /* Not shared, so simply write the new hash in. */
1166                 HeHASH(entry) = hash;
1167             }
1168             /*PerlIO_printf(PerlIO_stderr(), "%d ", HeKFLAGS(entry));*/
1169             HEK_REHASH_on(HeKEY_hek(entry));
1170             /*PerlIO_printf(PerlIO_stderr(), "%d\n", HeKFLAGS(entry));*/
1171
1172             /* Copy oentry to the correct new chain.  */
1173             bep = ((HE**)a) + (hash & (I32) xhv->xhv_max);
1174             if (!*bep)
1175                     xhv->xhv_fill++; /* HvFILL(hv)++ */
1176             HeNEXT(entry) = *bep;
1177             *bep = entry;
1178
1179             entry = next;
1180         }
1181     }
1182     Safefree (xhv->xhv_array);
1183     xhv->xhv_array = a;         /* HvARRAY(hv) = a */
1184 }
1185
1186 void
1187 Perl_hv_ksplit(pTHX_ HV *hv, IV newmax)
1188 {
1189     register XPVHV* xhv = (XPVHV*)SvANY(hv);
1190     I32 oldsize = (I32) xhv->xhv_max+1; /* HvMAX(hv)+1 (sick) */
1191     register I32 newsize;
1192     register I32 i;
1193     register I32 j;
1194     register char *a;
1195     register HE **aep;
1196     register HE *entry;
1197     register HE **oentry;
1198
1199     newsize = (I32) newmax;                     /* possible truncation here */
1200     if (newsize != newmax || newmax <= oldsize)
1201         return;
1202     while ((newsize & (1 + ~newsize)) != newsize) {
1203         newsize &= ~(newsize & (1 + ~newsize)); /* get proper power of 2 */
1204     }
1205     if (newsize < newmax)
1206         newsize *= 2;
1207     if (newsize < newmax)
1208         return;                                 /* overflow detection */
1209
1210     a = xhv->xhv_array; /* HvARRAY(hv) */
1211     if (a) {
1212         PL_nomemok = TRUE;
1213 #if defined(STRANGE_MALLOC) || defined(MYMALLOC)
1214         Renew(a, PERL_HV_ARRAY_ALLOC_BYTES(newsize), char);
1215         if (!a) {
1216           PL_nomemok = FALSE;
1217           return;
1218         }
1219 #else
1220         New(2, a, PERL_HV_ARRAY_ALLOC_BYTES(newsize), char);
1221         if (!a) {
1222           PL_nomemok = FALSE;
1223           return;
1224         }
1225         Copy(xhv->xhv_array /* HvARRAY(hv) */, a, oldsize * sizeof(HE*), char);
1226         if (oldsize >= 64) {
1227             offer_nice_chunk(xhv->xhv_array /* HvARRAY(hv) */,
1228                             PERL_HV_ARRAY_ALLOC_BYTES(oldsize));
1229         }
1230         else
1231             Safefree(xhv->xhv_array /* HvARRAY(hv) */);
1232 #endif
1233         PL_nomemok = FALSE;
1234         Zero(&a[oldsize * sizeof(HE*)], (newsize-oldsize) * sizeof(HE*), char); /* zero 2nd half*/
1235     }
1236     else {
1237         Newz(0, a, PERL_HV_ARRAY_ALLOC_BYTES(newsize), char);
1238     }
1239     xhv->xhv_max = --newsize;   /* HvMAX(hv) = --newsize */
1240     xhv->xhv_array = a;         /* HvARRAY(hv) = a */
1241     if (!xhv->xhv_fill /* !HvFILL(hv) */)       /* skip rest if no entries */
1242         return;
1243
1244     aep = (HE**)a;
1245     for (i=0; i<oldsize; i++,aep++) {
1246         if (!*aep)                              /* non-existent */
1247             continue;
1248         for (oentry = aep, entry = *aep; entry; entry = *oentry) {
1249             if ((j = (HeHASH(entry) & newsize)) != i) {
1250                 j -= i;
1251                 *oentry = HeNEXT(entry);
1252                 if (!(HeNEXT(entry) = aep[j]))
1253                     xhv->xhv_fill++; /* HvFILL(hv)++ */
1254                 aep[j] = entry;
1255                 continue;
1256             }
1257             else
1258                 oentry = &HeNEXT(entry);
1259         }
1260         if (!*aep)                              /* everything moved */
1261             xhv->xhv_fill--; /* HvFILL(hv)-- */
1262     }
1263 }
1264
1265 /*
1266 =for apidoc newHV
1267
1268 Creates a new HV.  The reference count is set to 1.
1269
1270 =cut
1271 */
1272
1273 HV *
1274 Perl_newHV(pTHX)
1275 {
1276     register HV *hv;
1277     register XPVHV* xhv;
1278
1279     hv = (HV*)NEWSV(502,0);
1280     sv_upgrade((SV *)hv, SVt_PVHV);
1281     xhv = (XPVHV*)SvANY(hv);
1282     SvPOK_off(hv);
1283     SvNOK_off(hv);
1284 #ifndef NODEFAULT_SHAREKEYS
1285     HvSHAREKEYS_on(hv);         /* key-sharing on by default */
1286 #endif
1287
1288     xhv->xhv_max    = 7;        /* HvMAX(hv) = 7 (start with 8 buckets) */
1289     xhv->xhv_fill   = 0;        /* HvFILL(hv) = 0 */
1290     xhv->xhv_pmroot = 0;        /* HvPMROOT(hv) = 0 */
1291     (void)hv_iterinit(hv);      /* so each() will start off right */
1292     return hv;
1293 }
1294
1295 HV *
1296 Perl_newHVhv(pTHX_ HV *ohv)
1297 {
1298     HV *hv = newHV();
1299     STRLEN hv_max, hv_fill;
1300
1301     if (!ohv || (hv_fill = HvFILL(ohv)) == 0)
1302         return hv;
1303     hv_max = HvMAX(ohv);
1304
1305     if (!SvMAGICAL((SV *)ohv)) {
1306         /* It's an ordinary hash, so copy it fast. AMS 20010804 */
1307         STRLEN i;
1308         bool shared = !!HvSHAREKEYS(ohv);
1309         HE **ents, **oents = (HE **)HvARRAY(ohv);
1310         char *a;
1311         New(0, a, PERL_HV_ARRAY_ALLOC_BYTES(hv_max+1), char);
1312         ents = (HE**)a;
1313
1314         /* In each bucket... */
1315         for (i = 0; i <= hv_max; i++) {
1316             HE *prev = NULL, *ent = NULL, *oent = oents[i];
1317
1318             if (!oent) {
1319                 ents[i] = NULL;
1320                 continue;
1321             }
1322
1323             /* Copy the linked list of entries. */
1324             for (oent = oents[i]; oent; oent = HeNEXT(oent)) {
1325                 U32 hash   = HeHASH(oent);
1326                 char *key  = HeKEY(oent);
1327                 STRLEN len = HeKLEN(oent);
1328                 int flags  = HeKFLAGS(oent);
1329
1330                 ent = new_HE();
1331                 HeVAL(ent)     = newSVsv(HeVAL(oent));
1332                 HeKEY_hek(ent)
1333                     = shared ? share_hek_flags(key, len, hash, flags)
1334                              :  save_hek_flags(key, len, hash, flags);
1335                 if (prev)
1336                     HeNEXT(prev) = ent;
1337                 else
1338                     ents[i] = ent;
1339                 prev = ent;
1340                 HeNEXT(ent) = NULL;
1341             }
1342         }
1343
1344         HvMAX(hv)   = hv_max;
1345         HvFILL(hv)  = hv_fill;
1346         HvTOTALKEYS(hv)  = HvTOTALKEYS(ohv);
1347         HvARRAY(hv) = ents;
1348     }
1349     else {
1350         /* Iterate over ohv, copying keys and values one at a time. */
1351         HE *entry;
1352         I32 riter = HvRITER(ohv);
1353         HE *eiter = HvEITER(ohv);
1354
1355         /* Can we use fewer buckets? (hv_max is always 2^n-1) */
1356         while (hv_max && hv_max + 1 >= hv_fill * 2)
1357             hv_max = hv_max / 2;
1358         HvMAX(hv) = hv_max;
1359
1360         hv_iterinit(ohv);
1361         while ((entry = hv_iternext_flags(ohv, 0))) {
1362             hv_store_flags(hv, HeKEY(entry), HeKLEN(entry),
1363                            newSVsv(HeVAL(entry)), HeHASH(entry),
1364                            HeKFLAGS(entry));
1365         }
1366         HvRITER(ohv) = riter;
1367         HvEITER(ohv) = eiter;
1368     }
1369
1370     return hv;
1371 }
1372
1373 void
1374 Perl_hv_free_ent(pTHX_ HV *hv, register HE *entry)
1375 {
1376     SV *val;
1377
1378     if (!entry)
1379         return;
1380     val = HeVAL(entry);
1381     if (val && isGV(val) && GvCVu(val) && HvNAME(hv))
1382         PL_sub_generation++;    /* may be deletion of method from stash */
1383     SvREFCNT_dec(val);
1384     if (HeKLEN(entry) == HEf_SVKEY) {
1385         SvREFCNT_dec(HeKEY_sv(entry));
1386         Safefree(HeKEY_hek(entry));
1387     }
1388     else if (HvSHAREKEYS(hv))
1389         unshare_hek(HeKEY_hek(entry));
1390     else
1391         Safefree(HeKEY_hek(entry));
1392     del_HE(entry);
1393 }
1394
1395 void
1396 Perl_hv_delayfree_ent(pTHX_ HV *hv, register HE *entry)
1397 {
1398     if (!entry)
1399         return;
1400     if (isGV(HeVAL(entry)) && GvCVu(HeVAL(entry)) && HvNAME(hv))
1401         PL_sub_generation++;    /* may be deletion of method from stash */
1402     sv_2mortal(HeVAL(entry));   /* free between statements */
1403     if (HeKLEN(entry) == HEf_SVKEY) {
1404         sv_2mortal(HeKEY_sv(entry));
1405         Safefree(HeKEY_hek(entry));
1406     }
1407     else if (HvSHAREKEYS(hv))
1408         unshare_hek(HeKEY_hek(entry));
1409     else
1410         Safefree(HeKEY_hek(entry));
1411     del_HE(entry);
1412 }
1413
1414 /*
1415 =for apidoc hv_clear
1416
1417 Clears a hash, making it empty.
1418
1419 =cut
1420 */
1421
1422 void
1423 Perl_hv_clear(pTHX_ HV *hv)
1424 {
1425     register XPVHV* xhv;
1426     if (!hv)
1427         return;
1428
1429     DEBUG_A(Perl_hv_assert(aTHX_ hv));
1430
1431     xhv = (XPVHV*)SvANY(hv);
1432
1433     if (SvREADONLY(hv) && xhv->xhv_array != NULL) {
1434         /* restricted hash: convert all keys to placeholders */
1435         I32 i;
1436         HE* entry;
1437         for (i = 0; i <= (I32) xhv->xhv_max; i++) {
1438             entry = ((HE**)xhv->xhv_array)[i];
1439             for (; entry; entry = HeNEXT(entry)) {
1440                 /* not already placeholder */
1441                 if (HeVAL(entry) != &PL_sv_placeholder) {
1442                     if (HeVAL(entry) && SvREADONLY(HeVAL(entry))) {
1443                         SV* keysv = hv_iterkeysv(entry);
1444                         Perl_croak(aTHX_
1445         "Attempt to delete readonly key '%"SVf"' from a restricted hash",
1446                                    keysv);
1447                     }
1448                     SvREFCNT_dec(HeVAL(entry));
1449                     HeVAL(entry) = &PL_sv_placeholder;
1450                     xhv->xhv_placeholders++; /* HvPLACEHOLDERS(hv)++ */
1451                 }
1452             }
1453         }
1454         goto reset;
1455     }
1456
1457     hfreeentries(hv);
1458     xhv->xhv_placeholders = 0; /* HvPLACEHOLDERS(hv) = 0 */
1459     if (xhv->xhv_array /* HvARRAY(hv) */)
1460         (void)memzero(xhv->xhv_array /* HvARRAY(hv) */,
1461                       (xhv->xhv_max+1 /* HvMAX(hv)+1 */) * sizeof(HE*));
1462
1463     if (SvRMAGICAL(hv))
1464         mg_clear((SV*)hv);
1465
1466     HvHASKFLAGS_off(hv);
1467     HvREHASH_off(hv);
1468     reset:
1469     HvEITER(hv) = NULL;
1470 }
1471
1472 /*
1473 =for apidoc hv_clear_placeholders
1474
1475 Clears any placeholders from a hash.  If a restricted hash has any of its keys
1476 marked as readonly and the key is subsequently deleted, the key is not actually
1477 deleted but is marked by assigning it a value of &PL_sv_placeholder.  This tags
1478 it so it will be ignored by future operations such as iterating over the hash,
1479 but will still allow the hash to have a value reaasigned to the key at some
1480 future point.  This function clears any such placeholder keys from the hash.
1481 See Hash::Util::lock_keys() for an example of its use.
1482
1483 =cut
1484 */
1485
1486 void
1487 Perl_hv_clear_placeholders(pTHX_ HV *hv)
1488 {
1489     I32 items = (I32)HvPLACEHOLDERS(hv);
1490     I32 i = HvMAX(hv);
1491
1492     if (items == 0)
1493         return;
1494
1495     do {
1496         /* Loop down the linked list heads  */
1497         int first = 1;
1498         HE **oentry = &(HvARRAY(hv))[i];
1499         HE *entry = *oentry;
1500
1501         if (!entry)
1502             continue;
1503
1504         for (; entry; entry = *oentry) {
1505             if (HeVAL(entry) == &PL_sv_placeholder) {
1506                 *oentry = HeNEXT(entry);
1507                 if (first && !*oentry)
1508                     HvFILL(hv)--; /* This linked list is now empty.  */
1509                 if (HvEITER(hv))
1510                     HvLAZYDEL_on(hv);
1511                 else
1512                     hv_free_ent(hv, entry);
1513
1514                 if (--items == 0) {
1515                     /* Finished.  */
1516                     HvTOTALKEYS(hv) -= HvPLACEHOLDERS(hv);
1517                     if (HvKEYS(hv) == 0)
1518                         HvHASKFLAGS_off(hv);
1519                     HvPLACEHOLDERS(hv) = 0;
1520                     return;
1521                 }
1522             } else {
1523                 oentry = &HeNEXT(entry);
1524                 first = 0;
1525             }
1526         }
1527     } while (--i >= 0);
1528     /* You can't get here, hence assertion should always fail.  */
1529     assert (items == 0);
1530     assert (0);
1531 }
1532
1533 STATIC void
1534 S_hfreeentries(pTHX_ HV *hv)
1535 {
1536     register HE **array;
1537     register HE *entry;
1538     register HE *oentry = Null(HE*);
1539     I32 riter;
1540     I32 max;
1541
1542     if (!hv)
1543         return;
1544     if (!HvARRAY(hv))
1545         return;
1546
1547     riter = 0;
1548     max = HvMAX(hv);
1549     array = HvARRAY(hv);
1550     /* make everyone else think the array is empty, so that the destructors
1551      * called for freed entries can't recusively mess with us */
1552     HvARRAY(hv) = Null(HE**); 
1553     HvFILL(hv) = 0;
1554     ((XPVHV*) SvANY(hv))->xhv_keys = 0;
1555
1556     entry = array[0];
1557     for (;;) {
1558         if (entry) {
1559             oentry = entry;
1560             entry = HeNEXT(entry);
1561             hv_free_ent(hv, oentry);
1562         }
1563         if (!entry) {
1564             if (++riter > max)
1565                 break;
1566             entry = array[riter];
1567         }
1568     }
1569     HvARRAY(hv) = array;
1570     (void)hv_iterinit(hv);
1571 }
1572
1573 /*
1574 =for apidoc hv_undef
1575
1576 Undefines the hash.
1577
1578 =cut
1579 */
1580
1581 void
1582 Perl_hv_undef(pTHX_ HV *hv)
1583 {
1584     register XPVHV* xhv;
1585     if (!hv)
1586         return;
1587     DEBUG_A(Perl_hv_assert(aTHX_ hv));
1588     xhv = (XPVHV*)SvANY(hv);
1589     hfreeentries(hv);
1590     Safefree(xhv->xhv_array /* HvARRAY(hv) */);
1591     if (HvNAME(hv)) {
1592         if(PL_stashcache)
1593             hv_delete(PL_stashcache, HvNAME(hv), strlen(HvNAME(hv)), G_DISCARD);
1594         Safefree(HvNAME(hv));
1595         HvNAME(hv) = 0;
1596     }
1597     xhv->xhv_max   = 7; /* HvMAX(hv) = 7 (it's a normal hash) */
1598     xhv->xhv_array = 0; /* HvARRAY(hv) = 0 */
1599     xhv->xhv_placeholders = 0; /* HvPLACEHOLDERS(hv) = 0 */
1600
1601     if (SvRMAGICAL(hv))
1602         mg_clear((SV*)hv);
1603 }
1604
1605 /*
1606 =for apidoc hv_iterinit
1607
1608 Prepares a starting point to traverse a hash table.  Returns the number of
1609 keys in the hash (i.e. the same as C<HvKEYS(tb)>).  The return value is
1610 currently only meaningful for hashes without tie magic.
1611
1612 NOTE: Before version 5.004_65, C<hv_iterinit> used to return the number of
1613 hash buckets that happen to be in use.  If you still need that esoteric
1614 value, you can get it through the macro C<HvFILL(tb)>.
1615
1616
1617 =cut
1618 */
1619
1620 I32
1621 Perl_hv_iterinit(pTHX_ HV *hv)
1622 {
1623     register XPVHV* xhv;
1624     HE *entry;
1625
1626     if (!hv)
1627         Perl_croak(aTHX_ "Bad hash");
1628     xhv = (XPVHV*)SvANY(hv);
1629     entry = xhv->xhv_eiter; /* HvEITER(hv) */
1630     if (entry && HvLAZYDEL(hv)) {       /* was deleted earlier? */
1631         HvLAZYDEL_off(hv);
1632         hv_free_ent(hv, entry);
1633     }
1634     xhv->xhv_riter = -1;        /* HvRITER(hv) = -1 */
1635     xhv->xhv_eiter = Null(HE*); /* HvEITER(hv) = Null(HE*) */
1636     /* used to be xhv->xhv_fill before 5.004_65 */
1637     return XHvTOTALKEYS(xhv);
1638 }
1639 /*
1640 =for apidoc hv_iternext
1641
1642 Returns entries from a hash iterator.  See C<hv_iterinit>.
1643
1644 You may call C<hv_delete> or C<hv_delete_ent> on the hash entry that the
1645 iterator currently points to, without losing your place or invalidating your
1646 iterator.  Note that in this case the current entry is deleted from the hash
1647 with your iterator holding the last reference to it.  Your iterator is flagged
1648 to free the entry on the next call to C<hv_iternext>, so you must not discard
1649 your iterator immediately else the entry will leak - call C<hv_iternext> to
1650 trigger the resource deallocation.
1651
1652 =cut
1653 */
1654
1655 HE *
1656 Perl_hv_iternext(pTHX_ HV *hv)
1657 {
1658     return hv_iternext_flags(hv, 0);
1659 }
1660
1661 /*
1662 =for apidoc hv_iternext_flags
1663
1664 Returns entries from a hash iterator.  See C<hv_iterinit> and C<hv_iternext>.
1665 The C<flags> value will normally be zero; if HV_ITERNEXT_WANTPLACEHOLDERS is
1666 set the placeholders keys (for restricted hashes) will be returned in addition
1667 to normal keys. By default placeholders are automatically skipped over.
1668 Currently a placeholder is implemented with a value that is
1669 C<&Perl_sv_placeholder>. Note that the implementation of placeholders and
1670 restricted hashes may change, and the implementation currently is
1671 insufficiently abstracted for any change to be tidy.
1672
1673 =cut
1674 */
1675
1676 HE *
1677 Perl_hv_iternext_flags(pTHX_ HV *hv, I32 flags)
1678 {
1679     register XPVHV* xhv;
1680     register HE *entry;
1681     HE *oldentry;
1682     MAGIC* mg;
1683
1684     if (!hv)
1685         Perl_croak(aTHX_ "Bad hash");
1686     xhv = (XPVHV*)SvANY(hv);
1687     oldentry = entry = xhv->xhv_eiter; /* HvEITER(hv) */
1688
1689     if ((mg = SvTIED_mg((SV*)hv, PERL_MAGIC_tied))) {
1690         SV *key = sv_newmortal();
1691         if (entry) {
1692             sv_setsv(key, HeSVKEY_force(entry));
1693             SvREFCNT_dec(HeSVKEY(entry));       /* get rid of previous key */
1694         }
1695         else {
1696             char *k;
1697             HEK *hek;
1698
1699             /* one HE per MAGICAL hash */
1700             xhv->xhv_eiter = entry = new_HE(); /* HvEITER(hv) = new_HE() */
1701             Zero(entry, 1, HE);
1702             Newz(54, k, HEK_BASESIZE + sizeof(SV*), char);
1703             hek = (HEK*)k;
1704             HeKEY_hek(entry) = hek;
1705             HeKLEN(entry) = HEf_SVKEY;
1706         }
1707         magic_nextpack((SV*) hv,mg,key);
1708         if (SvOK(key)) {
1709             /* force key to stay around until next time */
1710             HeSVKEY_set(entry, SvREFCNT_inc(key));
1711             return entry;               /* beware, hent_val is not set */
1712         }
1713         if (HeVAL(entry))
1714             SvREFCNT_dec(HeVAL(entry));
1715         Safefree(HeKEY_hek(entry));
1716         del_HE(entry);
1717         xhv->xhv_eiter = Null(HE*); /* HvEITER(hv) = Null(HE*) */
1718         return Null(HE*);
1719     }
1720 #ifdef DYNAMIC_ENV_FETCH  /* set up %ENV for iteration */
1721     if (!entry && SvRMAGICAL((SV*)hv) && mg_find((SV*)hv, PERL_MAGIC_env))
1722         prime_env_iter();
1723 #endif
1724
1725     if (!xhv->xhv_array /* !HvARRAY(hv) */)
1726         Newz(506, xhv->xhv_array /* HvARRAY(hv) */,
1727              PERL_HV_ARRAY_ALLOC_BYTES(xhv->xhv_max+1 /* HvMAX(hv)+1 */),
1728              char);
1729     /* At start of hash, entry is NULL.  */
1730     if (entry)
1731     {
1732         entry = HeNEXT(entry);
1733         if (!(flags & HV_ITERNEXT_WANTPLACEHOLDERS)) {
1734             /*
1735              * Skip past any placeholders -- don't want to include them in
1736              * any iteration.
1737              */
1738             while (entry && HeVAL(entry) == &PL_sv_placeholder) {
1739                 entry = HeNEXT(entry);
1740             }
1741         }
1742     }
1743     while (!entry) {
1744         /* OK. Come to the end of the current list.  Grab the next one.  */
1745
1746         xhv->xhv_riter++; /* HvRITER(hv)++ */
1747         if (xhv->xhv_riter > (I32)xhv->xhv_max /* HvRITER(hv) > HvMAX(hv) */) {
1748             /* There is no next one.  End of the hash.  */
1749             xhv->xhv_riter = -1; /* HvRITER(hv) = -1 */
1750             break;
1751         }
1752         /* entry = (HvARRAY(hv))[HvRITER(hv)]; */
1753         entry = ((HE**)xhv->xhv_array)[xhv->xhv_riter];
1754
1755         if (!(flags & HV_ITERNEXT_WANTPLACEHOLDERS)) {
1756             /* If we have an entry, but it's a placeholder, don't count it.
1757                Try the next.  */
1758             while (entry && HeVAL(entry) == &PL_sv_placeholder)
1759                 entry = HeNEXT(entry);
1760         }
1761         /* Will loop again if this linked list starts NULL
1762            (for HV_ITERNEXT_WANTPLACEHOLDERS)
1763            or if we run through it and find only placeholders.  */
1764     }
1765
1766     if (oldentry && HvLAZYDEL(hv)) {            /* was deleted earlier? */
1767         HvLAZYDEL_off(hv);
1768         hv_free_ent(hv, oldentry);
1769     }
1770
1771     /*if (HvREHASH(hv) && entry && !HeKREHASH(entry))
1772       PerlIO_printf(PerlIO_stderr(), "Awooga %p %p\n", hv, entry);*/
1773
1774     xhv->xhv_eiter = entry; /* HvEITER(hv) = entry */
1775     return entry;
1776 }
1777
1778 /*
1779 =for apidoc hv_iterkey
1780
1781 Returns the key from the current position of the hash iterator.  See
1782 C<hv_iterinit>.
1783
1784 =cut
1785 */
1786
1787 char *
1788 Perl_hv_iterkey(pTHX_ register HE *entry, I32 *retlen)
1789 {
1790     if (HeKLEN(entry) == HEf_SVKEY) {
1791         STRLEN len;
1792         char *p = SvPV(HeKEY_sv(entry), len);
1793         *retlen = len;
1794         return p;
1795     }
1796     else {
1797         *retlen = HeKLEN(entry);
1798         return HeKEY(entry);
1799     }
1800 }
1801
1802 /* unlike hv_iterval(), this always returns a mortal copy of the key */
1803 /*
1804 =for apidoc hv_iterkeysv
1805
1806 Returns the key as an C<SV*> from the current position of the hash
1807 iterator.  The return value will always be a mortal copy of the key.  Also
1808 see C<hv_iterinit>.
1809
1810 =cut
1811 */
1812
1813 SV *
1814 Perl_hv_iterkeysv(pTHX_ register HE *entry)
1815 {
1816     if (HeKLEN(entry) != HEf_SVKEY) {
1817         HEK *hek = HeKEY_hek(entry);
1818         int flags = HEK_FLAGS(hek);
1819         SV *sv;
1820
1821         if (flags & HVhek_WASUTF8) {
1822             /* Trouble :-)
1823                Andreas would like keys he put in as utf8 to come back as utf8
1824             */
1825             STRLEN utf8_len = HEK_LEN(hek);
1826             U8 *as_utf8 = bytes_to_utf8 ((U8*)HEK_KEY(hek), &utf8_len);
1827
1828             sv = newSVpvn ((char*)as_utf8, utf8_len);
1829             SvUTF8_on (sv);
1830             Safefree (as_utf8); /* bytes_to_utf8() allocates a new string */
1831         } else if (flags & HVhek_REHASH) {
1832             /* We don't have a pointer to the hv, so we have to replicate the
1833                flag into every HEK. This hv is using custom a hasing
1834                algorithm. Hence we can't return a shared string scalar, as
1835                that would contain the (wrong) hash value, and might get passed
1836                into an hv routine with a regular hash  */
1837
1838             sv = newSVpvn (HEK_KEY(hek), HEK_LEN(hek));
1839             if (HEK_UTF8(hek))
1840                 SvUTF8_on (sv);
1841         } else {
1842             sv = newSVpvn_share(HEK_KEY(hek),
1843                                 (HEK_UTF8(hek) ? -HEK_LEN(hek) : HEK_LEN(hek)),
1844                                 HEK_HASH(hek));
1845         }
1846         return sv_2mortal(sv);
1847     }
1848     return sv_mortalcopy(HeKEY_sv(entry));
1849 }
1850
1851 /*
1852 =for apidoc hv_iterval
1853
1854 Returns the value from the current position of the hash iterator.  See
1855 C<hv_iterkey>.
1856
1857 =cut
1858 */
1859
1860 SV *
1861 Perl_hv_iterval(pTHX_ HV *hv, register HE *entry)
1862 {
1863     if (SvRMAGICAL(hv)) {
1864         if (mg_find((SV*)hv, PERL_MAGIC_tied)) {
1865             SV* sv = sv_newmortal();
1866             if (HeKLEN(entry) == HEf_SVKEY)
1867                 mg_copy((SV*)hv, sv, (char*)HeKEY_sv(entry), HEf_SVKEY);
1868             else mg_copy((SV*)hv, sv, HeKEY(entry), HeKLEN(entry));
1869             return sv;
1870         }
1871     }
1872     return HeVAL(entry);
1873 }
1874
1875 /*
1876 =for apidoc hv_iternextsv
1877
1878 Performs an C<hv_iternext>, C<hv_iterkey>, and C<hv_iterval> in one
1879 operation.
1880
1881 =cut
1882 */
1883
1884 SV *
1885 Perl_hv_iternextsv(pTHX_ HV *hv, char **key, I32 *retlen)
1886 {
1887     HE *he;
1888     if ( (he = hv_iternext_flags(hv, 0)) == NULL)
1889         return NULL;
1890     *key = hv_iterkey(he, retlen);
1891     return hv_iterval(hv, he);
1892 }
1893
1894 /*
1895 =for apidoc hv_magic
1896
1897 Adds magic to a hash.  See C<sv_magic>.
1898
1899 =cut
1900 */
1901
1902 void
1903 Perl_hv_magic(pTHX_ HV *hv, GV *gv, int how)
1904 {
1905     sv_magic((SV*)hv, (SV*)gv, how, Nullch, 0);
1906 }
1907
1908 #if 0 /* use the macro from hv.h instead */
1909
1910 char*   
1911 Perl_sharepvn(pTHX_ const char *sv, I32 len, U32 hash)
1912 {
1913     return HEK_KEY(share_hek(sv, len, hash));
1914 }
1915
1916 #endif
1917
1918 /* possibly free a shared string if no one has access to it
1919  * len and hash must both be valid for str.
1920  */
1921 void
1922 Perl_unsharepvn(pTHX_ const char *str, I32 len, U32 hash)
1923 {
1924     unshare_hek_or_pvn (NULL, str, len, hash);
1925 }
1926
1927
1928 void
1929 Perl_unshare_hek(pTHX_ HEK *hek)
1930 {
1931     unshare_hek_or_pvn(hek, NULL, 0, 0);
1932 }
1933
1934 /* possibly free a shared string if no one has access to it
1935    hek if non-NULL takes priority over the other 3, else str, len and hash
1936    are used.  If so, len and hash must both be valid for str.
1937  */
1938 STATIC void
1939 S_unshare_hek_or_pvn(pTHX_ HEK *hek, const char *str, I32 len, U32 hash)
1940 {
1941     register XPVHV* xhv;
1942     register HE *entry;
1943     register HE **oentry;
1944     register I32 i = 1;
1945     I32 found = 0;
1946     bool is_utf8 = FALSE;
1947     int k_flags = 0;
1948     const char *save = str;
1949
1950     if (hek) {
1951         hash = HEK_HASH(hek);
1952     } else if (len < 0) {
1953         STRLEN tmplen = -len;
1954         is_utf8 = TRUE;
1955         /* See the note in hv_fetch(). --jhi */
1956         str = (char*)bytes_from_utf8((U8*)str, &tmplen, &is_utf8);
1957         len = tmplen;
1958         if (is_utf8)
1959             k_flags = HVhek_UTF8;
1960         if (str != save)
1961             k_flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
1962     }
1963
1964     /* what follows is the moral equivalent of:
1965     if ((Svp = hv_fetch(PL_strtab, tmpsv, FALSE, hash))) {
1966         if (--*Svp == Nullsv)
1967             hv_delete(PL_strtab, str, len, G_DISCARD, hash);
1968     } */
1969     xhv = (XPVHV*)SvANY(PL_strtab);
1970     /* assert(xhv_array != 0) */
1971     LOCK_STRTAB_MUTEX;
1972     /* oentry = &(HvARRAY(hv))[hash & (I32) HvMAX(hv)]; */
1973     oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
1974     if (hek) {
1975         for (entry = *oentry; entry; i=0, oentry = &HeNEXT(entry), entry = *oentry) {
1976             if (HeKEY_hek(entry) != hek)
1977                 continue;
1978             found = 1;
1979             break;
1980         }
1981     } else {
1982         int flags_masked = k_flags & HVhek_MASK;
1983         for (entry = *oentry; entry; i=0, oentry = &HeNEXT(entry), entry = *oentry) {
1984             if (HeHASH(entry) != hash)          /* strings can't be equal */
1985                 continue;
1986             if (HeKLEN(entry) != len)
1987                 continue;
1988             if (HeKEY(entry) != str && memNE(HeKEY(entry),str,len))     /* is this it? */
1989                 continue;
1990             if (HeKFLAGS(entry) != flags_masked)
1991                 continue;
1992             found = 1;
1993             break;
1994         }
1995     }
1996
1997     if (found) {
1998         if (--HeVAL(entry) == Nullsv) {
1999             *oentry = HeNEXT(entry);
2000             if (i && !*oentry)
2001                 xhv->xhv_fill--; /* HvFILL(hv)-- */
2002             Safefree(HeKEY_hek(entry));
2003             del_HE(entry);
2004             xhv->xhv_keys--; /* HvKEYS(hv)-- */
2005         }
2006     }
2007
2008     UNLOCK_STRTAB_MUTEX;
2009     if (!found && ckWARN_d(WARN_INTERNAL))
2010         Perl_warner(aTHX_ packWARN(WARN_INTERNAL),
2011                     "Attempt to free non-existent shared string '%s'%s",
2012                     hek ? HEK_KEY(hek) : str,
2013                     (k_flags & HVhek_UTF8) ? " (utf8)" : "");
2014     if (k_flags & HVhek_FREEKEY)
2015         Safefree(str);
2016 }
2017
2018 /* get a (constant) string ptr from the global string table
2019  * string will get added if it is not already there.
2020  * len and hash must both be valid for str.
2021  */
2022 HEK *
2023 Perl_share_hek(pTHX_ const char *str, I32 len, register U32 hash)
2024 {
2025     bool is_utf8 = FALSE;
2026     int flags = 0;
2027     const char *save = str;
2028
2029     if (len < 0) {
2030       STRLEN tmplen = -len;
2031       is_utf8 = TRUE;
2032       /* See the note in hv_fetch(). --jhi */
2033       str = (char*)bytes_from_utf8((U8*)str, &tmplen, &is_utf8);
2034       len = tmplen;
2035       /* If we were able to downgrade here, then than means that we were passed
2036          in a key which only had chars 0-255, but was utf8 encoded.  */
2037       if (is_utf8)
2038           flags = HVhek_UTF8;
2039       /* If we found we were able to downgrade the string to bytes, then
2040          we should flag that it needs upgrading on keys or each.  Also flag
2041          that we need share_hek_flags to free the string.  */
2042       if (str != save)
2043           flags |= HVhek_WASUTF8 | HVhek_FREEKEY;
2044     }
2045
2046     return share_hek_flags (str, len, hash, flags);
2047 }
2048
2049 STATIC HEK *
2050 S_share_hek_flags(pTHX_ const char *str, I32 len, register U32 hash, int flags)
2051 {
2052     register XPVHV* xhv;
2053     register HE *entry;
2054     register HE **oentry;
2055     register I32 i = 1;
2056     I32 found = 0;
2057     int flags_masked = flags & HVhek_MASK;
2058
2059     /* what follows is the moral equivalent of:
2060
2061     if (!(Svp = hv_fetch(PL_strtab, str, len, FALSE)))
2062         hv_store(PL_strtab, str, len, Nullsv, hash);
2063
2064         Can't rehash the shared string table, so not sure if it's worth
2065         counting the number of entries in the linked list
2066     */
2067     xhv = (XPVHV*)SvANY(PL_strtab);
2068     /* assert(xhv_array != 0) */
2069     LOCK_STRTAB_MUTEX;
2070     /* oentry = &(HvARRAY(hv))[hash & (I32) HvMAX(hv)]; */
2071     oentry = &((HE**)xhv->xhv_array)[hash & (I32) xhv->xhv_max];
2072     for (entry = *oentry; entry; i=0, entry = HeNEXT(entry)) {
2073         if (HeHASH(entry) != hash)              /* strings can't be equal */
2074             continue;
2075         if (HeKLEN(entry) != len)
2076             continue;
2077         if (HeKEY(entry) != str && memNE(HeKEY(entry),str,len)) /* is this it? */
2078             continue;
2079         if (HeKFLAGS(entry) != flags_masked)
2080             continue;
2081         found = 1;
2082         break;
2083     }
2084     if (!found) {
2085         entry = new_HE();
2086         HeKEY_hek(entry) = save_hek_flags(str, len, hash, flags_masked);
2087         HeVAL(entry) = Nullsv;
2088         HeNEXT(entry) = *oentry;
2089         *oentry = entry;
2090         xhv->xhv_keys++; /* HvKEYS(hv)++ */
2091         if (i) {                                /* initial entry? */
2092             xhv->xhv_fill++; /* HvFILL(hv)++ */
2093         } else if (xhv->xhv_keys > (IV)xhv->xhv_max /* HvKEYS(hv) > HvMAX(hv) */) {
2094                 hsplit(PL_strtab);
2095         }
2096     }
2097
2098     ++HeVAL(entry);                             /* use value slot as REFCNT */
2099     UNLOCK_STRTAB_MUTEX;
2100
2101     if (flags & HVhek_FREEKEY)
2102         Safefree(str);
2103
2104     return HeKEY_hek(entry);
2105 }
2106
2107
2108 /*
2109 =for apidoc hv_assert
2110
2111 Check that a hash is in an internally consistent state.
2112
2113 =cut
2114 */
2115
2116 void
2117 Perl_hv_assert(pTHX_ HV *hv)
2118 {
2119   HE* entry;
2120   int withflags = 0;
2121   int placeholders = 0;
2122   int real = 0;
2123   int bad = 0;
2124   I32 riter = HvRITER(hv);
2125   HE *eiter = HvEITER(hv);
2126
2127   (void)hv_iterinit(hv);
2128
2129   while ((entry = hv_iternext_flags(hv, HV_ITERNEXT_WANTPLACEHOLDERS))) {
2130     /* sanity check the values */
2131     if (HeVAL(entry) == &PL_sv_placeholder) {
2132       placeholders++;
2133     } else {
2134       real++;
2135     }
2136     /* sanity check the keys */
2137     if (HeSVKEY(entry)) {
2138       /* Don't know what to check on SV keys.  */
2139     } else if (HeKUTF8(entry)) {
2140       withflags++;
2141        if (HeKWASUTF8(entry)) {
2142          PerlIO_printf(Perl_debug_log,
2143                        "hash key has both WASUFT8 and UTF8: '%.*s'\n",
2144                        (int) HeKLEN(entry),  HeKEY(entry));
2145          bad = 1;
2146        }
2147     } else if (HeKWASUTF8(entry)) {
2148       withflags++;
2149     }
2150   }
2151   if (!SvTIED_mg((SV*)hv, PERL_MAGIC_tied)) {
2152     if (HvUSEDKEYS(hv) != real) {
2153       PerlIO_printf(Perl_debug_log, "Count %d key(s), but hash reports %d\n",
2154                     (int) real, (int) HvUSEDKEYS(hv));
2155       bad = 1;
2156     }
2157     if (HvPLACEHOLDERS(hv) != placeholders) {
2158       PerlIO_printf(Perl_debug_log,
2159                     "Count %d placeholder(s), but hash reports %d\n",
2160                     (int) placeholders, (int) HvPLACEHOLDERS(hv));
2161       bad = 1;
2162     }
2163   }
2164   if (withflags && ! HvHASKFLAGS(hv)) {
2165     PerlIO_printf(Perl_debug_log,
2166                   "Hash has HASKFLAGS off but I count %d key(s) with flags\n",
2167                   withflags);
2168     bad = 1;
2169   }
2170   if (bad) {
2171     sv_dump((SV *)hv);
2172   }
2173   HvRITER(hv) = riter;          /* Restore hash iterator state */
2174   HvEITER(hv) = eiter;
2175 }