D Programming Language
Improve this page Quickly fork, edit online, and submit a pull request for this page. Requires a signed-in GitHub account. This works well for small changes. If you'd like to make larger changes you may want to consider using local clone. Page wiki View or edit the community-maintained wiki page associated with this page.

# std.container.rbtree

This module implements a red-black tree container.
This module is a submodule of std.container.

Source: std/container/rbtree.d

License:
Distributed under the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at boost.org/LICENSE_1_0.txt).
Authors:
Steven Schveighoffer, Andrei Alexandrescu

class RedBlackTree(T, alias less = "a < b", bool allowDuplicates = false) if (is(typeof(binaryFun!less(T.init, T.init))));
  Implementation of a red-black tree container.
  All inserts, removes, searches, and any function in general has complexity of Ο(lg(n)).

  To use a different comparison than "a < b", pass a different operator string that can be used by std.functional.binaryFun, or pass in a function, delegate, functor, or any type where less(a, b) results in a bool value.

  Note that less should produce a strict ordering. That is, for two unequal elements a and b, less(a, b) == !less(b, a). less(a, a) should always equal false.

  If allowDuplicates is set to true, then inserting the same element more than once continues to add more elements. If it is false, duplicate elements are ignored on insertion. If duplicates are allowed, then new elements are inserted after all existing duplicate elements.
  alias Elem = T;
    Element type for the tree
  struct Range;
    The range type for RedBlackTree
    const @property bool empty();
      Returns true if the range is empty
    @property Elem front();
      Returns the first element in the range
    @property Elem back();
      Returns the last element in the range
    void popFront();
      pop the front element from the range

      complexity: amortized Ο(1)

    void popBack();
      pop the back element from the range

      complexity: amortized Ο(1)

    @property Range save();
      Trivial save implementation, needed for isForwardRange.
  @property bool empty();
    Check if any elements exist in the container. Returns false if at least one element exists.
  @property size_t length();
    Returns the number of elements in the container.

    Complexity: Ο(1).

  @property RedBlackTree dup();
    Duplicate this container. The resulting container contains a shallow copy of the elements.

    Complexity: Ο(n)

  Range opSlice();
    Fetch a range that spans all the elements in the container.

    Complexity: Ο(1)

  Elem front();
    The front element in the container

    Complexity: Ο(1)

  Elem back();
    The last element in the container

    Complexity: Ο(log(n))

  bool opBinaryRight(string op)(Elem e) if (op == "in");
    in operator. Check to see if the given element exists in the container.

    Complexity: Ο(log(n))

  bool opEquals(Object rhs);
    Compares two trees for equality.

    Complexity: Ο(n*log(n))

  void clear();
    Removes all elements from the container.

    Complexity: Ο(1)

  size_t stableInsert(Stuff)(Stuff stuff) if (isImplicitlyConvertible!(Stuff, Elem));
    Insert a single element in the container. Note that this does not invalidate any ranges currently iterating the container.

    Complexity: Ο(log(n))

  size_t stableInsert(Stuff)(Stuff stuff) if (isInputRange!Stuff && isImplicitlyConvertible!(ElementType!Stuff, Elem));
  alias insert = stableInsert;
    Insert a range of elements in the container. Note that this does not invalidate any ranges currently iterating the container.

    Complexity: Ο(m * log(n))

  Elem removeAny();
    Remove an element from the container and return its value.

    Complexity: Ο(log(n))

  void removeFront();
    Remove the front element from the container.

    Complexity: Ο(log(n))

  void removeBack();
    Remove the back element from the container.

    Complexity: Ο(log(n))

  Range remove(Range r);
    Removes the given range from the container.
    Returns:
    A range containing all of the elements that were after the given range.

    Complexity: Ο(m * log(n)) (where m is the number of elements in the range)

  Range remove(Take!Range r);
    Removes the given Take!Range from the container
    Returns:
    A range containing all of the elements that were after the given range.

    Complexity: Ο(m * log(n)) (where m is the number of elements in the range)

  size_t removeKey(U...)(U elems) if (allSatisfy!(isImplicitlyConvertibleToElem, U));
  size_t removeKey(U)(U[] elems) if (isImplicitlyConvertible!(U, Elem));
  size_t removeKey(Stuff)(Stuff stuff) if (isInputRange!Stuff && isImplicitlyConvertible!(ElementType!Stuff, Elem) && !isDynamicArray!Stuff);
    Removes elements from the container that are equal to the given values according to the less comparator. One element is removed for each value given which is in the container. If allowDuplicates is true, duplicates are removed only if duplicate values are given.
    Returns:
    The number of elements removed.

    Complexity: Ο(m log(n)) (where m is the number of elements to remove)

    Examples:

        auto rbt = redBlackTree!true(0, 1, 1, 1, 4, 5, 7);
        rbt.removeKey(1, 4, 7);
        assert(equal(rbt[], [0, 1, 1, 5]));
        rbt.removeKey(1, 1, 0);
        assert(equal(rbt[], [5]));

  Range upperBound(Elem e);
    Get a range from the container with all elements that are > e according to the less comparator

    Complexity: Ο(log(n))

  Range lowerBound(Elem e);
    Get a range from the container with all elements that are < e according to the less comparator

    Complexity: Ο(log(n))

  Range equalRange(Elem e);
    Get a range from the container with all elements that are == e according to the less comparator

    Complexity: Ο(log(n))

  this(Elem[] elems...);
    Constructor. Pass in an array of elements, or individual elements to initialize the tree with.
  this(Stuff)(Stuff stuff) if (isInputRange!Stuff && isImplicitlyConvertible!(ElementType!Stuff, Elem));
    Constructor. Pass in a range of elements to initialize the tree with.
  this();

auto redBlackTree(E)(E[] elems...);
auto redBlackTree(bool allowDuplicates, E)(E[] elems...);
auto redBlackTree(alias less, E)(E[] elems...);
auto redBlackTree(alias less, bool allowDuplicates, E)(E[] elems...) if (is(typeof(binaryFun!less(E.init, E.init))));
  Convenience function for creating a RedBlackTree!E from a list of values.
  Examples:

      auto rbt1 = redBlackTree(0, 1, 5, 7);
      auto rbt2 = redBlackTree!string("hello", "world");
      auto rbt3 = redBlackTree!true(0, 1, 5, 7, 5);
      auto rbt4 = redBlackTree!"a > b"(0, 1, 5, 7);
      auto rbt5 = redBlackTree!("a > b", true)(0.1, 1.3, 5.9, 7.2, 5.9);

Red-black tree code copyright (C) 2008- by Steven Schveighoffer. Other code copyright 2010- Andrei Alexandrescu. All rights reserved by the respective holders. | Page generated by Ddoc on Tue Mar 24 14:30:27 2015