Mercurial > projects > ldc

comparison tango/tango/util/collection/model/BagView.d @ 132:1700239cab2e trunk

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[svn r136] MAJOR UNSTABLE UPDATE!!! Initial commit after moving to Tango instead of Phobos. Lots of bugfixes... This build is not suitable for most things.
author lindquist
date Fri, 11 Jan 2008 17:57:40 +0100
parents
children
comparison
equal deleted inserted replaced
131:5825d48b27d1 132:1700239cab2e
1 /*
2 File: BagView.d
3
4 Originally written by Doug Lea and released into the public domain.
5 Thanks for the assistance and support of Sun Microsystems Labs, Agorics
6 Inc, Loral, and everyone contributing, testing, and using this code.
7
8 History:
9 Date Who What
10 24Sep95 dl@cs.oswego.edu Create from collections.d working file
11
12 */
13
14
15 module tango.util.collection.model.BagView;
16
17 private import tango.util.collection.model.View;
18
19
20 /**
21 *
22 * Bags are collections supporting multiple occurrences of elements.
23 *
24 author: Doug Lea
25 * @version 0.93
26 *
27 * <P> For an introduction to this package see <A HREF="index.html"> Overview </A>.
28 *
29 **/
30
31 public interface BagView(V) : View!(V)
32 {
33 version (VERBOSE)
34 {
35 public alias adding opCat;
36
37 /**
38 * Construct a new Bag that is a clone of self except
39 * that it includes indicated element. This can be used
40 * to create a series of Bag, each differing from the
41 * other only in that they contain additional elements.
42 *
43 * @param the element to add to the new Bag
44 * Returns: the new Bag c, with the matches as this except that
45 * c.occurrencesOf(element) == occurrencesOf(element)+1
46 * Throws: IllegalElementException if !canInclude(element)
47 **/
48
49 public Bag adding(V element);
50
51 /**
52 * Construct a new Collection that is a clone of self except
53 * that it adds the indicated element if not already present. This can be used
54 * to create a series of collections, each differing from the
55 * other only in that they contain additional elements.
56 *
57 * @param element the element to include in the new collection
58 * Returns: a new collection c, with the matches as this, except that
59 * c.occurrencesOf(element) = min(1, occurrencesOfElement)
60 * Throws: IllegalElementException if !canInclude(element)
61 **/
62
63 public Bag addingIfAbsent(V element);
64 } // version
65
66 }