aboutsummaryrefslogtreecommitdiffhomepage
path: root/Firestore/third_party/Immutable/FSTTreeSortedDictionary.h
blob: ca1a2908a29de47edbe574e3dd46bf902bcb3e80 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
/**
 * Implementation of an immutable SortedMap using a Left-leaning
 * Red-Black Tree, adapted from the implementation in Mugs
 * (http://mads379.github.com/mugs/) by Mads Hartmann Jensen
 * (mads379@gmail.com).
 *
 * Original paper on Left-leaning Red-Black Trees:
 *   http://www.cs.princeton.edu/~rs/talks/LLRB/LLRB.pdf
 *
 * Invariant 1: No red node has a red child
 * Invariant 2: Every leaf path has the same number of black nodes
 * Invariant 3: Only the left child can be red (left leaning)
 */

#import <Foundation/Foundation.h>

#import "Firestore/third_party/Immutable/FSTImmutableSortedDictionary.h"
#import "Firestore/third_party/Immutable/FSTLLRBNode.h"

NS_ASSUME_NONNULL_BEGIN

/**
 * FSTTreeSortedDictionary is a tree-based implementation of FSTImmutableSortedDictionary.
 * You should not use this class directly. You should use FSTImmutableSortedDictionary.
 */
@interface FSTTreeSortedDictionary <KeyType, ValueType> :
    FSTImmutableSortedDictionary<KeyType, ValueType>

@property(nonatomic, copy, readonly) NSComparator comparator;
@property(nonatomic, strong, readonly) id<FSTLLRBNode> root;

- (id)init __attribute__((unavailable("Use initWithComparator:withRoot: instead.")));

- (instancetype)initWithComparator:(NSComparator)aComparator;

- (instancetype)initWithComparator:(NSComparator)aComparator
                          withRoot:(id<FSTLLRBNode>)aRoot NS_DESIGNATED_INITIALIZER;

@end

NS_ASSUME_NONNULL_END