global.namespace.fun.io.delta.model.HashMaps Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of fun-io-delta Show documentation

Fun I/O Delta

There is a newer version: 2.4.1

/*
 * Copyright (C) 2013-2018 Schlichtherle IT Services.
 * All rights reserved. Use is subject to license terms.
 */
package global.namespace.fun.io.delta.model;

/**
 * Provides functions for hash maps.
 *
 * @author Christian Schlichtherle (copied from TrueCommons Shed 2.3.2)
 */
class HashMaps {

    private HashMaps() { }

    /**
     * The number of entries which should be additionally accomodated by a hash map with a load factor of 75% before
     * resizing it, which is {@value}.
     * When a new hash map gets created, this constant should get used in order to compute the initial capacity or
     * overhead for additional entries.
     *
     * @see   #initialCapacity(int)
     */
    private static final int OVERHEAD_SIZE = (64 - 1) * 3 / 4; // consider 75% load factor

    /**
     * Returns the initial capacity for a hash table with a load factor of 75%.
     *
     * @param  size the number of entries to accommodate space for.
     * @return The initial capacity for a hash table with a load factor of 75%.
     * @see    #OVERHEAD_SIZE
     */
    static int initialCapacity(int size) {
        if (size < OVERHEAD_SIZE)
            size = OVERHEAD_SIZE;
        final long capacity = size * 4L / 3 + 1;
        return Integer.MAX_VALUE >= capacity
                ? powerOfTwo((int) capacity)
                : Integer.MAX_VALUE; // not very realistic
    }

    // "Borrowed" from Scala's HashTable.
    private static int powerOfTwo(int c) {
      /* See http://bits.stephan-brumme.com/roundUpToNextPowerOfTwo.html */
        c--;
        c |= c >>>  1;
        c |= c >>>  2;
        c |= c >>>  4;
        c |= c >>>  8;
        c |= c >>> 16;
        return c + 1;
    }
}