it.unimi.dsi.fastutil.chars.CharCollections Maven / Gradle / Ivy
Show all versions of fastutil Show documentation
/* Generic definitions */
/* Assertions (useful to generate conditional code) */
/* Current type and class (and size, if applicable) */
/* Value methods */
/* Interfaces (keys) */
/* Interfaces (values) */
/* Abstract implementations (keys) */
/* Abstract implementations (values) */
/* Static containers (keys) */
/* Static containers (values) */
/* Implementations */
/* Synchronized wrappers */
/* Unmodifiable wrappers */
/* Other wrappers */
/* Methods (keys) */
/* Methods (values) */
/* Methods (keys/values) */
/* Methods that have special names depending on keys (but the special names depend on values) */
/* Equality */
/* Object/Reference-only definitions (keys) */
/* Primitive-type-only definitions (keys) */
/* Object/Reference-only definitions (values) */
/*
* Copyright (C) 2002-2016 Sebastiano Vigna
*
* 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 it.unimi.dsi.fastutil.chars;
import java.util.Collection;
import it.unimi.dsi.fastutil.objects.ObjectArrays;
/**
* A class providing static methods and objects that do useful things with
* type-specific collections.
*
* @see java.util.Collections
*/
public class CharCollections {
private CharCollections() {
}
/**
* An immutable class representing an empty type-specific collection.
*
*
* This class may be useful to implement your own in case you subclass a
* type-specific collection.
*/
public abstract static class EmptyCollection extends AbstractCharCollection {
protected EmptyCollection() {
}
public boolean add(char k) {
throw new UnsupportedOperationException();
}
public boolean contains(char k) {
return false;
}
public Object[] toArray() {
return ObjectArrays.EMPTY_ARRAY;
}
public char[] toCharArray(char[] a) {
return a;
}
public char[] toCharArray() {
return CharArrays.EMPTY_ARRAY;
}
public boolean rem(char k) {
throw new UnsupportedOperationException();
}
public boolean addAll(CharCollection c) {
throw new UnsupportedOperationException();
}
public boolean removeAll(CharCollection c) {
throw new UnsupportedOperationException();
}
public boolean retainAll(CharCollection c) {
throw new UnsupportedOperationException();
}
public boolean containsAll(CharCollection c) {
return c.isEmpty();
}
public CharBidirectionalIterator iterator() {
return CharIterators.EMPTY_ITERATOR;
}
public int size() {
return 0;
}
public void clear() {
}
public int hashCode() {
return 0;
}
public boolean equals(Object o) {
if (o == this)
return true;
if (!(o instanceof Collection))
return false;
return ((Collection) o).isEmpty();
}
}
/** A synchronized wrapper class for collections. */
public static class SynchronizedCollection
implements
CharCollection,
java.io.Serializable {
private static final long serialVersionUID = -7046029254386353129L;
protected final CharCollection collection;
protected final Object sync;
protected SynchronizedCollection(final CharCollection c,
final Object sync) {
if (c == null)
throw new NullPointerException();
this.collection = c;
this.sync = sync;
}
protected SynchronizedCollection(final CharCollection c) {
if (c == null)
throw new NullPointerException();
this.collection = c;
this.sync = this;
}
public int size() {
synchronized (sync) {
return collection.size();
}
}
public boolean isEmpty() {
synchronized (sync) {
return collection.isEmpty();
}
}
public boolean contains(final char o) {
synchronized (sync) {
return collection.contains(o);
}
}
public char[] toCharArray() {
synchronized (sync) {
return collection.toCharArray();
}
}
public Object[] toArray() {
synchronized (sync) {
return collection.toArray();
}
}
public char[] toCharArray(final char[] a) {
synchronized (sync) {
return collection.toCharArray(a);
}
}
public char[] toArray(final char[] a) {
synchronized (sync) {
return collection.toCharArray(a);
}
}
public boolean addAll(final CharCollection c) {
synchronized (sync) {
return collection.addAll(c);
}
}
public boolean containsAll(final CharCollection c) {
synchronized (sync) {
return collection.containsAll(c);
}
}
public boolean removeAll(final CharCollection c) {
synchronized (sync) {
return collection.removeAll(c);
}
}
public boolean retainAll(final CharCollection c) {
synchronized (sync) {
return collection.retainAll(c);
}
}
public boolean add(final Character k) {
synchronized (sync) {
return collection.add(k);
}
}
public boolean contains(final Object k) {
synchronized (sync) {
return collection.contains(k);
}
}
public T[] toArray(final T[] a) {
synchronized (sync) {
return collection.toArray(a);
}
}
public CharIterator iterator() {
return collection.iterator();
}
@Deprecated
public CharIterator charIterator() {
return iterator();
}
public boolean add(final char k) {
synchronized (sync) {
return collection.add(k);
}
}
public boolean rem(final char k) {
synchronized (sync) {
return collection.rem(k);
}
}
public boolean remove(final Object ok) {
synchronized (sync) {
return collection.remove(ok);
}
}
public boolean addAll(final Collection c) {
synchronized (sync) {
return collection.addAll(c);
}
}
public boolean containsAll(final Collection c) {
synchronized (sync) {
return collection.containsAll(c);
}
}
public boolean removeAll(final Collection c) {
synchronized (sync) {
return collection.removeAll(c);
}
}
public boolean retainAll(final Collection c) {
synchronized (sync) {
return collection.retainAll(c);
}
}
public void clear() {
synchronized (sync) {
collection.clear();
}
}
public String toString() {
synchronized (sync) {
return collection.toString();
}
}
}
/**
* Returns a synchronized collection backed by the specified collection.
*
* @param c
* the collection to be wrapped in a synchronized collection.
* @return a synchronized view of the specified collection.
* @see java.util.Collections#synchronizedCollection(Collection)
*/
public static CharCollection synchronize(final CharCollection c) {
return new SynchronizedCollection(c);
}
/**
* Returns a synchronized collection backed by the specified collection,
* using an assigned object to synchronize.
*
* @param c
* the collection to be wrapped in a synchronized collection.
* @param sync
* an object that will be used to synchronize the list access.
* @return a synchronized view of the specified collection.
* @see java.util.Collections#synchronizedCollection(Collection)
*/
public static CharCollection synchronize(final CharCollection c,
final Object sync) {
return new SynchronizedCollection(c, sync);
}
/** An unmodifiable wrapper class for collections. */
public static class UnmodifiableCollection
implements
CharCollection,
java.io.Serializable {
private static final long serialVersionUID = -7046029254386353129L;
protected final CharCollection collection;
protected UnmodifiableCollection(final CharCollection c) {
if (c == null)
throw new NullPointerException();
this.collection = c;
}
public int size() {
return collection.size();
}
public boolean isEmpty() {
return collection.isEmpty();
}
public boolean contains(final char o) {
return collection.contains(o);
}
public CharIterator iterator() {
return CharIterators.unmodifiable(collection.iterator());
}
@Deprecated
public CharIterator charIterator() {
return iterator();
}
public boolean add(final char k) {
throw new UnsupportedOperationException();
}
public boolean remove(final Object ok) {
throw new UnsupportedOperationException();
}
public boolean addAll(final Collection c) {
throw new UnsupportedOperationException();
}
public boolean containsAll(final Collection c) {
return collection.containsAll(c);
}
public boolean removeAll(final Collection c) {
throw new UnsupportedOperationException();
}
public boolean retainAll(final Collection c) {
throw new UnsupportedOperationException();
}
public void clear() {
throw new UnsupportedOperationException();
}
public String toString() {
return collection.toString();
}
public T[] toArray(final T[] a) {
return collection.toArray(a);
}
public Object[] toArray() {
return collection.toArray();
}
public char[] toCharArray() {
return collection.toCharArray();
}
public char[] toCharArray(final char[] a) {
return collection.toCharArray(a);
}
public char[] toArray(final char[] a) {
return collection.toArray(a);
}
public boolean rem(final char k) {
throw new UnsupportedOperationException();
}
public boolean addAll(final CharCollection c) {
throw new UnsupportedOperationException();
}
public boolean containsAll(final CharCollection c) {
return collection.containsAll(c);
}
public boolean removeAll(final CharCollection c) {
throw new UnsupportedOperationException();
}
public boolean retainAll(final CharCollection c) {
throw new UnsupportedOperationException();
}
public boolean add(final Character k) {
throw new UnsupportedOperationException();
}
public boolean contains(final Object k) {
return collection.contains(k);
}
}
/**
* Returns an unmodifiable collection backed by the specified collection.
*
* @param c
* the collection to be wrapped in an unmodifiable collection.
* @return an unmodifiable view of the specified collection.
* @see java.util.Collections#unmodifiableCollection(Collection)
*/
public static CharCollection unmodifiable(final CharCollection c) {
return new UnmodifiableCollection(c);
}
/** A collection wrapper class for iterables. */
public static class IterableCollection extends AbstractCharCollection
implements
java.io.Serializable {
private static final long serialVersionUID = -7046029254386353129L;
protected final CharIterable iterable;
protected IterableCollection(final CharIterable iterable) {
if (iterable == null)
throw new NullPointerException();
this.iterable = iterable;
}
public int size() {
int c = 0;
final CharIterator iterator = iterator();
while (iterator.hasNext()) {
iterator.next();
c++;
}
return c;
}
public boolean isEmpty() {
return !iterable.iterator().hasNext();
}
public CharIterator iterator() {
return iterable.iterator();
}
@Deprecated
public CharIterator charIterator() {
return iterator();
}
}
/**
* Returns an unmodifiable collection backed by the specified iterable.
*
* @param iterable
* the iterable object to be wrapped in an unmodifiable
* collection.
* @return an unmodifiable collection view of the specified iterable.
*/
public static CharCollection asCollection(final CharIterable iterable) {
if (iterable instanceof CharCollection)
return (CharCollection) iterable;
return new IterableCollection(iterable);
}
}