com.google.gwt.emul.java.util.Spliterator Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of gwt-servlet Show documentation
There is a newer version: 2.10.0
/*
 * Copyright 2016 Google Inc.
 *
 * 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 java.util;

import java.util.function.Consumer;
import java.util.function.DoubleConsumer;
import java.util.function.IntConsumer;
import java.util.function.LongConsumer;

/**
 * See 
 * the official Java API doc for details.
 *
 * @param  the type of elements returned by Spliterator.
 */
public interface Spliterator {

  int DISTINCT = 0x00000001;

  int ORDERED = 0x00000010;

  int NONNULL = 0x00000100;

  int CONCURRENT = 0x00001000;

  int SORTED = 0x00000004;

  int SIZED = 0x00000040;

  int IMMUTABLE = 0x00000400;

  int SUBSIZED = 0x00004000;

  int characteristics();

  long estimateSize();

  default void forEachRemaining(Consumer consumer) {
    while (tryAdvance(consumer)) { }
  }

  default Comparator getComparator() {
    throw new IllegalStateException();
  }

  default long getExactSizeIfKnown() {
    return hasCharacteristics(SIZED) ? estimateSize() : -1L;
  }

  default boolean hasCharacteristics(int characteristics) {
    return (characteristics() & characteristics) != 0;
  }

  boolean tryAdvance(Consumer consumer);

  Spliterator trySplit();

  /**
   * See 
   * the official Java API doc for details.
   *
   * @param  the type of elements returned by this Spliterator.
   * @param  the type of primitive Consumer.
   * @param  the type of primitive Spliterator.
   */
  interface OfPrimitive> extends Spliterator {

    boolean tryAdvance(C consumer);

    @Override
    S trySplit();

    default void forEachRemaining(C consumer) {
      while (tryAdvance(consumer)) { }
    }
  }

  /**
   * See 
   * the official Java API doc for details.
   */
  interface OfDouble extends OfPrimitive {
    @Override
    default boolean tryAdvance(Consumer consumer) {
      if (consumer instanceof DoubleConsumer) {
        return tryAdvance((DoubleConsumer) consumer);
      } else {
        return tryAdvance((DoubleConsumer) consumer::accept);
      }
    }

    @Override
    default void forEachRemaining(Consumer consumer) {
      if (consumer instanceof DoubleConsumer) {
        forEachRemaining((DoubleConsumer) consumer);
      } else {
        forEachRemaining((DoubleConsumer) consumer::accept);
      }
    }
  }

  /**
   * See 
   * the official Java API doc for details.
   */
  interface OfInt extends OfPrimitive {
    @Override
    default boolean tryAdvance(Consumer consumer) {
      if (consumer instanceof IntConsumer) {
        return tryAdvance((IntConsumer) consumer);
      } else {
        return tryAdvance((IntConsumer) consumer::accept);
      }
    }

    @Override
    default void forEachRemaining(Consumer consumer) {
      if (consumer instanceof IntConsumer) {
        forEachRemaining((IntConsumer) consumer);
      } else {
        forEachRemaining((IntConsumer) consumer::accept);
      }
    }
  }

  /**
   * See 
   * the official Java API doc for details.
   */
  interface OfLong extends OfPrimitive {
    @Override
    default boolean tryAdvance(Consumer consumer) {
      if (consumer instanceof LongConsumer) {
        return tryAdvance((LongConsumer) consumer);
      } else {
        return tryAdvance((LongConsumer) consumer::accept);
      }
    }

    @Override
    default void forEachRemaining(Consumer consumer) {
      if (consumer instanceof LongConsumer) {
        forEachRemaining((LongConsumer) consumer);
      } else {
        forEachRemaining((LongConsumer) consumer::accept);
      }
    }
  }
}