com.github.dm.rf.android.iterator.LongSparseIterable Maven / Gradle / Ivy

Go to download
/**
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.github.dm.rf.android.iterator;

import com.github.dm.rf.android.filter.Filter;
import com.github.dm.rf.android.filter.LongFilterBuilder;

import java.util.Collection;

/**
 * This interface extends the {@link ElementSparseIterable} one by adding specific methods handling
 * long elements.
 * 
 * Created by davide-maestroni on 3/10/14.
 */
public interface LongSparseIterable extends ElementSparseIterable {

    @Override
    public LongFilterBuilder but();

    @Override
    public LongSparseIterable but(Filter filter);

    @Override
    public LongSparseIterable doWhile(Condition condition);

    @Override
    public LongSparseIterable forEach(Action action);

    @Override
    public LongFilterBuilder only();

    @Override
    public LongSparseIterable only(Filter filter);

    @Override
    public LongSparseIterable remove();

    @Override
    public LongSparseIterable retain();

    @Override
    public LongSparseIterable reverse();

    @Override
    public LongSparseIterable fill(Collection collection);

    /**
     * Fills the specified array with the elements returned by this iterable, in the iteration
     * order, starting from the index 0 of the array.
     * 

     * Note that, in case the array is not big enough to contain all the elements, an
     * {@link java.lang.IndexOutOfBoundsException} will be thrown.
     *
     * @param array the array to fill.
     * @return this iterable.
     */
    public LongSparseIterable fill(long[] array);

    /**
     * Fills the specified array with the elements returned by this iterable, in the iteration
     * order, starting from the specified offset inside the array.
     * 
     * Note that, in case the array is not big enough to contain all the elements, an
     * {@link java.lang.IndexOutOfBoundsException} will be thrown.
     *
     * @param array  the array to fill.
     * @param offset the offset from which to start filling the array.
     * @return this iterable.
     */
    public LongSparseIterable fill(long[] array, int offset);

    /**
     * Creates and returns a new array filled with the elements returned by this iterable, in the
     * iteration order.
     *
     * @return the new array.
     */
    public long[] toArray();
}