src.it.unimi.dsi.fastutil.chars.CharCollections Maven / Gradle / Ivy
/* 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-2013 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(); }
@SuppressWarnings("unchecked")
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.
*/
@SuppressWarnings("unchecked")
public static CharCollection asCollection( final CharIterable iterable ) {
if ( iterable instanceof CharCollection ) return (CharCollection )iterable;
return new IterableCollection ( iterable );
}
}