Files
sdk/lib/core/set.dart
T
lrn@google.com ee569ce10a Reapply conversion of most core interfaces to abstract classes.
Previous commit was reverted due to hitting an unrelated error.

TBR=ahe@google.com

Review URL: https://codereview.chromium.org//10939030

git-svn-id: https://dart.googlecode.com/svn/branches/bleeding_edge/dart@12551 260f80e4-7a28-3924-810f-c04153c831b5
2012-09-19 10:48:14 +00:00

81 lines
2.0 KiB
Dart

// Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.
/**
* This class is the public interface of a set. A set is a collection
* without duplicates.
*/
abstract class Set<E> extends Collection<E> {
factory Set() => new HashSetImplementation<E>();
/**
* Creates a [Set] that contains all elements of [other].
*/
factory Set.from(Iterable<E> other) {
return new HashSetImplementation<E>.from(other);
}
/**
* Returns true if [value] is in the set.
*/
bool contains(E value);
/**
* Adds [value] into the set. The method has no effect if
* [value] was already in the set.
*/
void add(E value);
/**
* Removes [value] from the set. Returns true if [value] was
* in the set. Returns false otherwise. The method has no effect
* if [value] value was not in the set.
*/
bool remove(E value);
/**
* Adds all the elements of the given collection to the set.
*/
void addAll(Collection<E> collection);
/**
* Removes all the elements of the given collection from the set.
*/
void removeAll(Collection<E> collection);
/**
* Returns true if [collection] contains all the elements of this
* collection.
*/
bool isSubsetOf(Collection<E> collection);
/**
* Returns true if this collection contains all the elements of
* [collection].
*/
bool containsAll(Collection<E> collection);
/**
* Returns a new set which is the intersection between this set and
* the given collection.
*/
Set<E> intersection(Collection<E> other);
/**
* Removes all elements in the set.
*/
void clear();
}
abstract class HashSet<E extends Hashable> extends Set<E> {
factory HashSet() => new HashSetImplementation<E>();
/**
* Creates a [Set] that contains all elements of [other].
*/
factory HashSet.from(Iterable<E> other) =>
new HashSetImplementation<E>.from(other);
}