Update Module-CoreList Changes file for 5.20141002 release
[perl.git] / hv_func.h
1 /* hash a key
2  *--------------------------------------------------------------------------------------
3  * The "hash seed" feature was added in Perl 5.8.1 to perturb the results
4  * to avoid "algorithmic complexity attacks".
5  *
6  * If USE_HASH_SEED is defined, hash randomisation is done by default
7  * If USE_HASH_SEED_EXPLICIT is defined, hash randomisation is done
8  * only if the environment variable PERL_HASH_SEED is set.
9  * (see also perl.c:perl_parse() and S_init_tls_and_interp() and util.c:get_hash_seed())
10  */
11
12 #ifndef PERL_SEEN_HV_FUNC_H /* compile once */
13 #define PERL_SEEN_HV_FUNC_H
14
15 #if !( 0 \
16         || defined(PERL_HASH_FUNC_SIPHASH) \
17         || defined(PERL_HASH_FUNC_SDBM) \
18         || defined(PERL_HASH_FUNC_DJB2) \
19         || defined(PERL_HASH_FUNC_SUPERFAST) \
20         || defined(PERL_HASH_FUNC_MURMUR3) \
21         || defined(PERL_HASH_FUNC_ONE_AT_A_TIME) \
22         || defined(PERL_HASH_FUNC_ONE_AT_A_TIME_HARD) \
23         || defined(PERL_HASH_FUNC_ONE_AT_A_TIME_OLD) \
24         || defined(PERL_HASH_FUNC_MURMUR_HASH_64A) \
25         || defined(PERL_HASH_FUNC_MURMUR_HASH_64B) \
26     )
27 #define PERL_HASH_FUNC_ONE_AT_A_TIME_HARD
28 #endif
29
30 #if defined(PERL_HASH_FUNC_SIPHASH)
31 #   define PERL_HASH_FUNC "SIPHASH_2_4"
32 #   define PERL_HASH_SEED_BYTES 16
33 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_siphash_2_4((seed),(U8*)(str),(len))
34 #elif defined(PERL_HASH_FUNC_SUPERFAST)
35 #   define PERL_HASH_FUNC "SUPERFAST"
36 #   define PERL_HASH_SEED_BYTES 4
37 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_superfast((seed),(U8*)(str),(len))
38 #elif defined(PERL_HASH_FUNC_MURMUR3)
39 #   define PERL_HASH_FUNC "MURMUR3"
40 #   define PERL_HASH_SEED_BYTES 4
41 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_murmur3((seed),(U8*)(str),(len))
42 #elif defined(PERL_HASH_FUNC_DJB2)
43 #   define PERL_HASH_FUNC "DJB2"
44 #   define PERL_HASH_SEED_BYTES 4
45 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_djb2((seed),(U8*)(str),(len))
46 #elif defined(PERL_HASH_FUNC_SDBM)
47 #   define PERL_HASH_FUNC "SDBM"
48 #   define PERL_HASH_SEED_BYTES 4
49 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_sdbm((seed),(U8*)(str),(len))
50 #elif defined(PERL_HASH_FUNC_ONE_AT_A_TIME_HARD)
51 #   define PERL_HASH_FUNC "ONE_AT_A_TIME_HARD"
52 #   define PERL_HASH_SEED_BYTES 8
53 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_one_at_a_time_hard((seed),(U8*)(str),(len))
54 #elif defined(PERL_HASH_FUNC_ONE_AT_A_TIME)
55 #   define PERL_HASH_FUNC "ONE_AT_A_TIME"
56 #   define PERL_HASH_SEED_BYTES 4
57 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_one_at_a_time((seed),(U8*)(str),(len))
58 #elif defined(PERL_HASH_FUNC_ONE_AT_A_TIME_OLD)
59 #   define PERL_HASH_FUNC "ONE_AT_A_TIME_OLD"
60 #   define PERL_HASH_SEED_BYTES 4
61 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_old_one_at_a_time((seed),(U8*)(str),(len))
62 #elif defined(PERL_HASH_FUNC_MURMUR_HASH_64A)
63 #   define PERL_HASH_FUNC "MURMUR_HASH_64A"
64 #   define PERL_HASH_SEED_BYTES 8
65 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_murmur_hash_64a((seed),(U8*)(str),(len))
66 #elif defined(PERL_HASH_FUNC_MURMUR_HASH_64B)
67 #   define PERL_HASH_FUNC "MURMUR_HASH_64B"
68 #   define PERL_HASH_SEED_BYTES 8
69 #   define PERL_HASH_WITH_SEED(seed,hash,str,len) (hash)= S_perl_hash_murmur_hash_64b((seed),(U8*)(str),(len))
70 #endif
71
72 #ifndef PERL_HASH_WITH_SEED
73 #error "No hash function defined!"
74 #endif
75 #ifndef PERL_HASH_SEED_BYTES
76 #error "PERL_HASH_SEED_BYTES not defined"
77 #endif
78 #ifndef PERL_HASH_FUNC
79 #error "PERL_HASH_FUNC not defined"
80 #endif
81
82 #ifndef PERL_HASH_SEED
83 #   if defined(USE_HASH_SEED) || defined(USE_HASH_SEED_EXPLICIT)
84 #       define PERL_HASH_SEED PL_hash_seed
85 #   elif PERL_HASH_SEED_BYTES == 4
86 #       define PERL_HASH_SEED "PeRl"
87 #   elif PERL_HASH_SEED_BYTES == 16
88 #       define PERL_HASH_SEED "PeRlHaShhAcKpErl"
89 #   else
90 #       error "No PERL_HASH_SEED definition for " PERL_HASH_FUNC
91 #   endif
92 #endif
93
94 #define PERL_HASH(hash,str,len) PERL_HASH_WITH_SEED(PERL_HASH_SEED,hash,str,len)
95
96 /*-----------------------------------------------------------------------------
97  * Endianess, misalignment capabilities and util macros
98  *
99  * The following 3 macros are defined in this section. The other macros defined
100  * are only needed to help derive these 3.
101  *
102  * U8TO32_LE(x)   Read a little endian unsigned 32-bit int
103  * UNALIGNED_SAFE   Defined if READ_UINT32 works on non-word boundaries
104  * ROTL32(x,r)      Rotate x left by r bits
105  */
106
107 #if (defined(__GNUC__) && defined(__i386__)) || defined(__WATCOMC__) \
108   || defined(_MSC_VER) || defined (__TURBOC__)
109 #define U8TO16_LE(d) (*((const U16 *) (d)))
110 #endif
111
112 #if !defined (U8TO16_LE)
113 #define U8TO16_LE(d) ((((const U8 *)(d))[1] << 8)\
114                       +((const U8 *)(d))[0])
115 #endif
116
117
118 /* Now find best way we can to READ_UINT32 */
119 #if (BYTEORDER == 0x1234 || BYTEORDER == 0x12345678) && U32SIZE == 4
120   /* CPU endian matches murmurhash algorithm, so read 32-bit word directly */
121   #define U8TO32_LE(ptr)   (*((U32*)(ptr)))
122 #elif BYTEORDER == 0x4321 || BYTEORDER == 0x87654321
123   /* TODO: Add additional cases below where a compiler provided bswap32 is available */
124   #if defined(__GNUC__) && (__GNUC__>4 || (__GNUC__==4 && __GNUC_MINOR__>=3))
125     #define U8TO32_LE(ptr)   (__builtin_bswap32(*((U32*)(ptr))))
126   #else
127     /* Without a known fast bswap32 we're just as well off doing this */
128     #define U8TO32_LE(ptr)   (ptr[0]|ptr[1]<<8|ptr[2]<<16|ptr[3]<<24)
129     #define UNALIGNED_SAFE
130   #endif
131 #else
132   /* Unknown endianess so last resort is to read individual bytes */
133   #define U8TO32_LE(ptr)   (ptr[0]|ptr[1]<<8|ptr[2]<<16|ptr[3]<<24)
134   /* Since we're not doing word-reads we can skip the messing about with realignment */
135   #define UNALIGNED_SAFE
136 #endif
137
138 #ifdef HAS_QUAD
139 #ifndef U64TYPE
140 /* This probably isn't going to work, but failing with a compiler error due to
141    lack of uint64_t is no worse than failing right now with an #error.  */
142 #define U64TYPE uint64_t
143 #endif
144 #endif
145
146 /* Find best way to ROTL32/ROTL64 */
147 #if defined(_MSC_VER)
148   #include <stdlib.h>  /* Microsoft put _rotl declaration in here */
149   #define ROTL32(x,r)  _rotl(x,r)
150   #ifdef HAS_QUAD
151     #define ROTL64(x,r)  _rotl64(x,r)
152   #endif
153 #else
154   /* gcc recognises this code and generates a rotate instruction for CPUs with one */
155   #define ROTL32(x,r)  (((U32)x << r) | ((U32)x >> (32 - r)))
156   #ifdef HAS_QUAD
157     #define ROTL64(x,r)  (((U64TYPE)x << r) | ((U64TYPE)x >> (64 - r)))
158   #endif
159 #endif
160
161
162 #ifdef UV_IS_QUAD
163 #define ROTL_UV(x,r) ROTL64(x,r)
164 #else
165 #define ROTL_UV(x,r) ROTL32(x,r)
166 #endif
167
168 /* This is SipHash by Jean-Philippe Aumasson and Daniel J. Bernstein.
169  * The authors claim it is relatively secure compared to the alternatives
170  * and that performance wise it is a suitable hash for languages like Perl.
171  * See:
172  *
173  * https://www.131002.net/siphash/
174  *
175  * This implementation seems to perform slightly slower than one-at-a-time for
176  * short keys, but degrades slower for longer keys. Murmur Hash outperforms it
177  * regardless of keys size.
178  *
179  * It is 64 bit only.
180  */
181
182 #ifdef HAS_QUAD
183
184 #define U8TO64_LE(p) \
185   (((U64TYPE)((p)[0])      ) | \
186    ((U64TYPE)((p)[1]) <<  8) | \
187    ((U64TYPE)((p)[2]) << 16) | \
188    ((U64TYPE)((p)[3]) << 24) | \
189    ((U64TYPE)((p)[4]) << 32) | \
190    ((U64TYPE)((p)[5]) << 40) | \
191    ((U64TYPE)((p)[6]) << 48) | \
192    ((U64TYPE)((p)[7]) << 56))
193
194 #define SIPROUND            \
195   do {              \
196     v0 += v1; v1=ROTL64(v1,13); v1 ^= v0; v0=ROTL64(v0,32); \
197     v2 += v3; v3=ROTL64(v3,16); v3 ^= v2;     \
198     v0 += v3; v3=ROTL64(v3,21); v3 ^= v0;     \
199     v2 += v1; v1=ROTL64(v1,17); v1 ^= v2; v2=ROTL64(v2,32); \
200   } while(0)
201
202 /* SipHash-2-4 */
203
204 PERL_STATIC_INLINE U32
205 S_perl_hash_siphash_2_4(const unsigned char * const seed, const unsigned char *in, const STRLEN inlen) {
206   /* "somepseudorandomlygeneratedbytes" */
207   U64TYPE v0 = UINT64_C(0x736f6d6570736575);
208   U64TYPE v1 = UINT64_C(0x646f72616e646f6d);
209   U64TYPE v2 = UINT64_C(0x6c7967656e657261);
210   U64TYPE v3 = UINT64_C(0x7465646279746573);
211
212   U64TYPE b;
213   U64TYPE k0 = ((U64TYPE*)seed)[0];
214   U64TYPE k1 = ((U64TYPE*)seed)[1];
215   U64TYPE m;
216   const int left = inlen & 7;
217   const U8 *end = in + inlen - left;
218
219   b = ( ( U64TYPE )(inlen) ) << 56;
220   v3 ^= k1;
221   v2 ^= k0;
222   v1 ^= k1;
223   v0 ^= k0;
224
225   for ( ; in != end; in += 8 )
226   {
227     m = U8TO64_LE( in );
228     v3 ^= m;
229     SIPROUND;
230     SIPROUND;
231     v0 ^= m;
232   }
233
234   switch( left )
235   {
236   case 7: b |= ( ( U64TYPE )in[ 6] )  << 48;
237   case 6: b |= ( ( U64TYPE )in[ 5] )  << 40;
238   case 5: b |= ( ( U64TYPE )in[ 4] )  << 32;
239   case 4: b |= ( ( U64TYPE )in[ 3] )  << 24;
240   case 3: b |= ( ( U64TYPE )in[ 2] )  << 16;
241   case 2: b |= ( ( U64TYPE )in[ 1] )  <<  8;
242   case 1: b |= ( ( U64TYPE )in[ 0] ); break;
243   case 0: break;
244   }
245
246   v3 ^= b;
247   SIPROUND;
248   SIPROUND;
249   v0 ^= b;
250
251   v2 ^= 0xff;
252   SIPROUND;
253   SIPROUND;
254   SIPROUND;
255   SIPROUND;
256   b = v0 ^ v1 ^ v2  ^ v3;
257   return (U32)(b & U32_MAX);
258 }
259 #endif /* defined(HAS_QUAD) */
260
261 /* FYI: This is the "Super-Fast" algorithm mentioned by Bob Jenkins in
262  * (http://burtleburtle.net/bob/hash/doobs.html)
263  * It is by Paul Hsieh (c) 2004 and is analysed here
264  * http://www.azillionmonkeys.com/qed/hash.html
265  * license terms are here:
266  * http://www.azillionmonkeys.com/qed/weblicense.html
267  */
268
269
270 PERL_STATIC_INLINE U32
271 S_perl_hash_superfast(const unsigned char * const seed, const unsigned char *str, STRLEN len) {
272     U32 hash = *((U32*)seed) + len;
273     U32 tmp;
274     int rem= len & 3;
275     len >>= 2;
276
277     for (;len > 0; len--) {
278         hash  += U8TO16_LE (str);
279         tmp    = (U8TO16_LE (str+2) << 11) ^ hash;
280         hash   = (hash << 16) ^ tmp;
281         str   += 2 * sizeof (U16);
282         hash  += hash >> 11;
283     }
284
285     /* Handle end cases */
286     switch (rem) { \
287         case 3: hash += U8TO16_LE (str);
288                 hash ^= hash << 16;
289                 hash ^= str[sizeof (U16)] << 18;
290                 hash += hash >> 11;
291                 break;
292         case 2: hash += U8TO16_LE (str);
293                 hash ^= hash << 11;
294                 hash += hash >> 17;
295                 break;
296         case 1: hash += *str;
297                 hash ^= hash << 10;
298                 hash += hash >> 1;
299     }
300     /* Force "avalanching" of final 127 bits */
301     hash ^= hash << 3;
302     hash += hash >> 5;
303     hash ^= hash << 4;
304     hash += hash >> 17;
305     hash ^= hash << 25;
306     return (hash + (hash >> 6));
307 }
308
309
310 /*-----------------------------------------------------------------------------
311  * MurmurHash3 was written by Austin Appleby, and is placed in the public
312  * domain.
313  *
314  * This implementation was originally written by Shane Day, and is also public domain,
315  * and was modified to function as a macro similar to other perl hash functions by
316  * Yves Orton.
317  *
318  * This is a portable ANSI C implementation of MurmurHash3_x86_32 (Murmur3A)
319  * with support for progressive processing.
320  *
321  * If you want to understand the MurmurHash algorithm you would be much better
322  * off reading the original source. Just point your browser at:
323  * http://code.google.com/p/smhasher/source/browse/trunk/MurmurHash3.cpp
324  *
325  * How does it work?
326  *
327  * We can only process entire 32 bit chunks of input, except for the very end
328  * that may be shorter.
329  *
330  * To handle endianess I simply use a macro that reads a U32 and define
331  * that macro to be a direct read on little endian machines, a read and swap
332  * on big endian machines, or a byte-by-byte read if the endianess is unknown.
333  */
334
335
336 /*-----------------------------------------------------------------------------
337  * Core murmurhash algorithm macros */
338
339 #define MURMUR_C1  (0xcc9e2d51)
340 #define MURMUR_C2  (0x1b873593)
341 #define MURMUR_C3  (0xe6546b64)
342 #define MURMUR_C4  (0x85ebca6b)
343 #define MURMUR_C5  (0xc2b2ae35)
344
345 /* This is the main processing body of the algorithm. It operates
346  * on each full 32-bits of input. */
347 #define MURMUR_DOBLOCK(h1, k1) STMT_START { \
348     k1 *= MURMUR_C1; \
349     k1 = ROTL32(k1,15); \
350     k1 *= MURMUR_C2; \
351     \
352     h1 ^= k1; \
353     h1 = ROTL32(h1,13); \
354     h1 = h1 * 5 + MURMUR_C3; \
355 } STMT_END
356
357
358 /* Append unaligned bytes to carry, forcing hash churn if we have 4 bytes */
359 /* cnt=bytes to process, h1=name of h1 var, c=carry, n=bytes in c, ptr/len=payload */
360 #define MURMUR_DOBYTES(cnt, h1, c, n, ptr, len) STMT_START { \
361     int MURMUR_DOBYTES_i = cnt; \
362     while(MURMUR_DOBYTES_i--) { \
363         c = c>>8 | *ptr++<<24; \
364         n++; len--; \
365         if(n==4) { \
366             MURMUR_DOBLOCK(h1, c); \
367             n = 0; \
368         } \
369     } \
370 } STMT_END
371
372
373 /* now we create the hash function */
374 PERL_STATIC_INLINE U32
375 S_perl_hash_murmur3(const unsigned char * const seed, const unsigned char *ptr, STRLEN len) {
376     U32 h1 = *((U32*)seed);
377     U32 k1;
378     U32 carry = 0;
379
380     const unsigned char *end;
381     int bytes_in_carry = 0; /* bytes in carry */
382     I32 total_length= len;
383
384 #if defined(UNALIGNED_SAFE)
385     /* Handle carry: commented out as its only used in incremental mode - it never fires for us
386     int i = (4-n) & 3;
387     if(i && i <= len) {
388       MURMUR_DOBYTES(i, h1, carry, bytes_in_carry, ptr, len);
389     }
390     */
391
392     /* This CPU handles unaligned word access */
393     /* Process 32-bit chunks */
394     end = ptr + len/4*4;
395     for( ; ptr < end ; ptr+=4) {
396         k1 = U8TO32_LE(ptr);
397         MURMUR_DOBLOCK(h1, k1);
398     }
399 #else
400     /* This CPU does not handle unaligned word access */
401
402     /* Consume enough so that the next data byte is word aligned */
403     STRLEN i = -PTR2IV(ptr) & 3;
404     if(i && i <= len) {
405       MURMUR_DOBYTES(i, h1, carry, bytes_in_carry, ptr, len);
406     }
407
408     /* We're now aligned. Process in aligned blocks. Specialise for each possible carry count */
409     end = ptr + len/4*4;
410     switch(bytes_in_carry) { /* how many bytes in carry */
411         case 0: /* c=[----]  w=[3210]  b=[3210]=w            c'=[----] */
412         for( ; ptr < end ; ptr+=4) {
413             k1 = U8TO32_LE(ptr);
414             MURMUR_DOBLOCK(h1, k1);
415         }
416         break;
417         case 1: /* c=[0---]  w=[4321]  b=[3210]=c>>24|w<<8   c'=[4---] */
418         for( ; ptr < end ; ptr+=4) {
419             k1 = carry>>24;
420             carry = U8TO32_LE(ptr);
421             k1 |= carry<<8;
422             MURMUR_DOBLOCK(h1, k1);
423         }
424         break;
425         case 2: /* c=[10--]  w=[5432]  b=[3210]=c>>16|w<<16  c'=[54--] */
426         for( ; ptr < end ; ptr+=4) {
427             k1 = carry>>16;
428             carry = U8TO32_LE(ptr);
429             k1 |= carry<<16;
430             MURMUR_DOBLOCK(h1, k1);
431         }
432         break;
433         case 3: /* c=[210-]  w=[6543]  b=[3210]=c>>8|w<<24   c'=[654-] */
434         for( ; ptr < end ; ptr+=4) {
435             k1 = carry>>8;
436             carry = U8TO32_LE(ptr);
437             k1 |= carry<<24;
438             MURMUR_DOBLOCK(h1, k1);
439         }
440     }
441 #endif
442     /* Advance over whole 32-bit chunks, possibly leaving 1..3 bytes */
443     len -= len/4*4;
444
445     /* Append any remaining bytes into carry */
446     MURMUR_DOBYTES(len, h1, carry, bytes_in_carry, ptr, len);
447
448     if (bytes_in_carry) {
449         k1 = carry >> ( 4 - bytes_in_carry ) * 8;
450         k1 *= MURMUR_C1;
451         k1 = ROTL32(k1,15);
452         k1 *= MURMUR_C2;
453         h1 ^= k1;
454     }
455     h1 ^= total_length;
456
457     /* fmix */
458     h1 ^= h1 >> 16;
459     h1 *= MURMUR_C4;
460     h1 ^= h1 >> 13;
461     h1 *= MURMUR_C5;
462     h1 ^= h1 >> 16;
463     return h1;
464 }
465
466
467 PERL_STATIC_INLINE U32
468 S_perl_hash_djb2(const unsigned char * const seed, const unsigned char *str, const STRLEN len) {
469     const unsigned char * const end = (const unsigned char *)str + len;
470     U32 hash = *((U32*)seed) + len;
471     while (str < end) {
472         hash = ((hash << 5) + hash) + *str++;
473     }
474     return hash;
475 }
476
477 PERL_STATIC_INLINE U32
478 S_perl_hash_sdbm(const unsigned char * const seed, const unsigned char *str, const STRLEN len) {
479     const unsigned char * const end = (const unsigned char *)str + len;
480     U32 hash = *((U32*)seed) + len;
481     while (str < end) {
482         hash = (hash << 6) + (hash << 16) - hash + *str++;
483     }
484     return hash;
485 }
486
487 /* - ONE_AT_A_TIME_HARD is the 5.17+ recommend ONE_AT_A_TIME algorithm
488  * - ONE_AT_A_TIME_OLD is the unmodified 5.16 and older algorithm
489  * - ONE_AT_A_TIME is a 5.17+ tweak of ONE_AT_A_TIME_OLD to
490  *   prevent strings of only \0 but different lengths from colliding
491  *
492  * Security-wise, from best to worst,
493  * ONE_AT_A_TIME_HARD > ONE_AT_A_TIME > ONE_AT_A_TIME_OLD
494  * There is a big drop-off in security between ONE_AT_A_TIME_HARD and
495  * ONE_AT_A_TIME
496  * */
497
498 /* This is the "One-at-a-Time" algorithm by Bob Jenkins
499  * from requirements by Colin Plumb.
500  * (http://burtleburtle.net/bob/hash/doobs.html)
501  * With seed/len tweak.
502  * */
503 PERL_STATIC_INLINE U32
504 S_perl_hash_one_at_a_time(const unsigned char * const seed, const unsigned char *str, const STRLEN len) {
505     const unsigned char * const end = (const unsigned char *)str + len;
506     U32 hash = *((U32*)seed) + len;
507     while (str < end) {
508         hash += *str++;
509         hash += (hash << 10);
510         hash ^= (hash >> 6);
511     }
512     hash += (hash << 3);
513     hash ^= (hash >> 11);
514     return (hash + (hash << 15));
515 }
516
517 /* Derived from "One-at-a-Time" algorithm by Bob Jenkins */
518 PERL_STATIC_INLINE U32
519 S_perl_hash_one_at_a_time_hard(const unsigned char * const seed, const unsigned char *str, const STRLEN len) {
520     const unsigned char * const end = (const unsigned char *)str + len;
521     U32 hash = *((U32*)seed) + len;
522     
523     while (str < end) {
524         hash += (hash << 10);
525         hash ^= (hash >> 6);
526         hash += *str++;
527     }
528     
529     hash += (hash << 10);
530     hash ^= (hash >> 6);
531     hash += seed[4];
532     
533     hash += (hash << 10);
534     hash ^= (hash >> 6);
535     hash += seed[5];
536     
537     hash += (hash << 10);
538     hash ^= (hash >> 6);
539     hash += seed[6];
540     
541     hash += (hash << 10);
542     hash ^= (hash >> 6);
543     hash += seed[7];
544     
545     hash += (hash << 10);
546     hash ^= (hash >> 6);
547
548     hash += (hash << 3);
549     hash ^= (hash >> 11);
550     return (hash + (hash << 15));
551 }
552
553 PERL_STATIC_INLINE U32
554 S_perl_hash_old_one_at_a_time(const unsigned char * const seed, const unsigned char *str, const STRLEN len) {
555     const unsigned char * const end = (const unsigned char *)str + len;
556     U32 hash = *((U32*)seed);
557     while (str < end) {
558         hash += *str++;
559         hash += (hash << 10);
560         hash ^= (hash >> 6);
561     }
562     hash += (hash << 3);
563     hash ^= (hash >> 11);
564     return (hash + (hash << 15));
565 }
566
567 #ifdef PERL_HASH_FUNC_MURMUR_HASH_64A
568 /* This code is from Austin Appleby and is in the public domain.
569    Altered by Yves Orton to match Perl's hash interface, and to
570    return a 32 bit hash.
571
572    Note uses unaligned 64 bit loads - will NOT work on machines with
573    strict alginment requirements.
574
575    Also this code may not be suitable for big-endian machines.
576 */
577
578 /* a 64 bit hash where we only use the low 32 bits */
579 PERL_STATIC_INLINE U32
580 S_perl_hash_murmur_hash_64a (const unsigned char * const seed, const unsigned char *str, const STRLEN len)
581 {
582         const U64TYPE m = 0xc6a4a7935bd1e995;
583         const int r = 47;
584         U64TYPE h = *((U64TYPE*)seed) ^ len;
585         const U64TYPE * data = (const U64TYPE *)str;
586         const U64TYPE * end = data + (len/8);
587         const unsigned char * data2;
588
589         while(data != end)
590         {
591             U64TYPE k = *data++;
592
593             k *= m;
594             k ^= k >> r;
595             k *= m;
596
597             h ^= k;
598             h *= m;
599         }
600
601         data2 = (const unsigned char *)data;
602
603         switch(len & 7)
604         {
605             case 7: h ^= (U64TYPE)(data2[6]) << 48; /* fallthrough */
606             case 6: h ^= (U64TYPE)(data2[5]) << 40; /* fallthrough */
607             case 5: h ^= (U64TYPE)(data2[4]) << 32; /* fallthrough */
608             case 4: h ^= (U64TYPE)(data2[3]) << 24; /* fallthrough */
609             case 3: h ^= (U64TYPE)(data2[2]) << 16; /* fallthrough */
610             case 2: h ^= (U64TYPE)(data2[1]) << 8;  /* fallthrough */
611             case 1: h ^= (U64TYPE)(data2[0]);       /* fallthrough */
612                     h *= m;
613         };
614
615         h ^= h >> r;
616         h *= m;
617         h ^= h >> r;
618
619         /* was: return h; */
620         return h & 0xFFFFFFFF;
621 }
622
623 #endif
624
625 #ifdef PERL_HASH_FUNC_MURMUR_HASH_64B
626 /* This code is from Austin Appleby and is in the public domain.
627    Altered by Yves Orton to match Perl's hash interface and return
628    a 32 bit value
629
630    Note uses unaligned 32 bit loads - will NOT work on machines with
631    strict alginment requirements.
632
633    Also this code may not be suitable for big-endian machines.
634 */
635
636 /* a 64-bit hash for 32-bit platforms where we only use the low 32 bits */
637 PERL_STATIC_INLINE U32
638 S_perl_hash_murmur_hash_64b (const unsigned char * const seed, const unsigned char *str, STRLEN len)
639 {
640         const U32 m = 0x5bd1e995;
641         const int r = 24;
642
643         U32 h1 = ((U32 *)seed)[0] ^ len;
644         U32 h2 = ((U32 *)seed)[1];
645
646         const U32 * data = (const U32 *)str;
647
648         while(len >= 8)
649         {
650             U32 k1, k2;
651             k1 = *data++;
652             k1 *= m; k1 ^= k1 >> r; k1 *= m;
653             h1 *= m; h1 ^= k1;
654             len -= 4;
655
656             k2 = *data++;
657             k2 *= m; k2 ^= k2 >> r; k2 *= m;
658             h2 *= m; h2 ^= k2;
659             len -= 4;
660         }
661
662         if(len >= 4)
663         {
664             U32 k1 = *data++;
665             k1 *= m; k1 ^= k1 >> r; k1 *= m;
666             h1 *= m; h1 ^= k1;
667             len -= 4;
668         }
669
670         switch(len)
671         {
672             case 3: h2 ^= ((unsigned char*)data)[2] << 16;  /* fallthrough */
673             case 2: h2 ^= ((unsigned char*)data)[1] << 8;   /* fallthrough */
674             case 1: h2 ^= ((unsigned char*)data)[0];        /* fallthrough */
675                     h2 *= m;
676         };
677
678         h1 ^= h2 >> 18; h1 *= m;
679         h2 ^= h1 >> 22; h2 *= m;
680         /*
681         The following code has been removed as it is unused
682         when only the low 32 bits are used. -- Yves
683
684         h1 ^= h2 >> 17; h1 *= m;
685
686         U64TYPE h = h1;
687
688         h = (h << 32) | h2;
689         */
690
691         return h2;
692 }
693 #endif
694
695 /* legacy - only mod_perl should be doing this.  */
696 #ifdef PERL_HASH_INTERNAL_ACCESS
697 #define PERL_HASH_INTERNAL(hash,str,len) PERL_HASH(hash,str,len)
698 #endif
699
700 #endif /*compile once*/
701
702 /*
703  * Local variables:
704  * c-indentation-style: bsd
705  * c-basic-offset: 4
706  * indent-tabs-mode: nil
707  * End:
708  *
709  * ex: set ts=8 sts=4 sw=4 et:
710  */