org.eclipse.collections.api.map.primitive.MutableLongObjectMap Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of eclipse-collections-api Show documentation
There is a newer version: 12.0.0.M3
Show newest version
/*
 * Copyright (c) 2018 Goldman Sachs.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * and Eclipse Distribution License v. 1.0 which accompany this distribution.
 * The Eclipse Public License is available at http://www.eclipse.org/legal/epl-v10.html
 * and the Eclipse Distribution License is available at
 * http://www.eclipse.org/org/documents/edl-v10.php.
 */

package org.eclipse.collections.api.map.primitive;

import org.eclipse.collections.api.LongIterable;
import org.eclipse.collections.api.block.function.Function;
import org.eclipse.collections.api.block.function.Function0;
import org.eclipse.collections.api.block.function.Function2;
import org.eclipse.collections.api.block.function.primitive.LongToObjectFunction;
import org.eclipse.collections.api.block.predicate.primitive.LongObjectPredicate;
import org.eclipse.collections.api.block.procedure.Procedure;
import org.eclipse.collections.api.tuple.primitive.LongObjectPair;

/**
 * This file was automatically generated from template file mutablePrimitiveObjectMap.stg.
 *
 * @since 3.0.
 */
public interface MutableLongObjectMap extends LongObjectMap, MutablePrimitiveObjectMap
{
    V put(long key, V value);

    /**
     * This method allows MutableLongObjectMap the ability to add an element in the form of {@code LongObjectPair}.
     *
     * @see #put(long, Object)
     * @since 9.1.0
     */
    default V putPair(LongObjectPair keyValuePair)
    {
        return this.put(keyValuePair.getOne(), keyValuePair.getTwo());
    }

    /**
     * @since 5.0.
     */
    void putAll(LongObjectMap map);

    V removeKey(long key);

    V remove(long key);

    V getIfAbsentPut(long key, V value);

    V getIfAbsentPut(long key, Function0 function);

    V getIfAbsentPutWithKey(long key, LongToObjectFunction function);

     V getIfAbsentPutWith(long key, Function function, P parameter);

    /**
     * Look up the value associated with {@code key}, apply the {@code function} to it, and replace the value. If there
     * is no value associated with {@code key}, start it off with a value supplied by {@code factory}.
     */
    V updateValue(long key, Function0 factory, Function function);

    /**
     * Same as {@link #updateValue(long, Function0, Function)} with a Function2 and specified parameter which is
     * passed to the function.
     */
     V updateValueWith(long key, Function0 factory, Function2 function, P parameter);

    @Override
    MutableObjectLongMap flipUniqueValues();

    @Override
    MutableLongObjectMap tap(Procedure procedure);

    @Override
    MutableLongObjectMap select(LongObjectPredicate predicate);

    @Override
    MutableLongObjectMap reject(LongObjectPredicate predicate);

    MutableLongObjectMap withKeyValue(long key, V value);

    MutableLongObjectMap withoutKey(long key);

    MutableLongObjectMap withoutAllKeys(LongIterable keys);

    default MutableLongObjectMap withAllKeyValues(Iterable> keyValuePairs)
    {
        for (LongObjectPair keyValuePair : keyValuePairs)
        {
            this.putPair(keyValuePair);
        }
        return this;
    }

    MutableLongObjectMap asUnmodifiable();

    MutableLongObjectMap asSynchronized();
}