From 87e613a8c28e8f3766628829fcdf2471a9356bb1 Mon Sep 17 00:00:00 2001
From: James Strachan <james.strachan@gmail.com>
Date: Mon, 16 Apr 2012 19:59:12 +0100
Subject: [PATCH] refactored the to(Collection) methods to be called
 toCollection(Collection) to avoid clashing with a potentially new method
 called to(T) for making a pair/tuple/Map.Entry

---
 .../src/generated/ArraysFromJLangIterables.kt      | 12 ++++++------
 .../src/generated/ArraysFromJLangIterablesLazy.kt  |  4 ++--
 .../src/generated/ArraysFromJUtilCollections.kt    |  7 +++++--
 .../JUtilIterablesFromJUtilCollections.kt          |  7 +++++--
 .../generated/JUtilIteratorsFromJLangIterables.kt  | 12 ++++++------
 .../src/generated/StandardFromJLangIterables.kt    | 12 ++++++------
 .../generated/StandardFromJLangIterablesLazy.kt    |  4 ++--
 .../src/generated/StandardFromJUtilCollections.kt  |  7 +++++--
 libraries/stdlib/src/kotlin/JLangIterables.kt      | 12 ++++++------
 libraries/stdlib/src/kotlin/JLangIterablesLazy.kt  |  4 ++--
 libraries/stdlib/src/kotlin/JUtil.kt               | 10 +++++-----
 libraries/stdlib/src/kotlin/Standard.kt            | 14 +++++++-------
 libraries/stdlib/src/kotlin/nullable/Nullables.kt  | 10 +++++-----
 13 files changed, 62 insertions(+), 53 deletions(-)

diff --git a/libraries/stdlib/src/generated/ArraysFromJLangIterables.kt b/libraries/stdlib/src/generated/ArraysFromJLangIterables.kt
index c8d1fed1ab7..2d370e35619 100644
--- a/libraries/stdlib/src/generated/ArraysFromJLangIterables.kt
+++ b/libraries/stdlib/src/generated/ArraysFromJLangIterables.kt
@@ -193,25 +193,25 @@ public inline fun <T> Array<T>.reverse() : List<T> {
 }
 
 /** Copies all elements into the given collection */
-public inline fun <in T, C: Collection<in T>> Array<T>.to(result: C) : C {
+public inline fun <in T, C: Collection<in T>> Array<T>.toCollection(result: C) : C {
     for (element in this) result.add(element)
     return result
 }
 
 /** Copies all elements into a [[LinkedList]]  */
-public inline fun <in T> Array<T>.toLinkedList() : LinkedList<T> = to(LinkedList<T>())
+public inline fun <in T> Array<T>.toLinkedList() : LinkedList<T> = toCollection(LinkedList<T>())
 
 /** Copies all elements into a [[List]] */
-public inline fun <in T> Array<T>.toList() : List<T> = to(ArrayList<T>())
+public inline fun <in T> Array<T>.toList() : List<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[List] */
-public inline fun <in T> Array<T>.toCollection() : Collection<T> = to(ArrayList<T>())
+public inline fun <in T> Array<T>.toCollection() : Collection<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[Set]] */
-public inline fun <in T> Array<T>.toSet() : Set<T> = to(HashSet<T>())
+public inline fun <in T> Array<T>.toSet() : Set<T> = toCollection(HashSet<T>())
 
 /** Copies all elements into a [[SortedSet]] */
-public inline fun <in T> Array<T>.toSortedSet() : SortedSet<T> = to(TreeSet<T>())
+public inline fun <in T> Array<T>.toSortedSet() : SortedSet<T> = toCollection(TreeSet<T>())
 
 /**
   TODO figure out necessary variance/generics ninja stuff... :)
diff --git a/libraries/stdlib/src/generated/ArraysFromJLangIterablesLazy.kt b/libraries/stdlib/src/generated/ArraysFromJLangIterablesLazy.kt
index 6bd375e692c..82a8c13afb7 100644
--- a/libraries/stdlib/src/generated/ArraysFromJLangIterablesLazy.kt
+++ b/libraries/stdlib/src/generated/ArraysFromJLangIterablesLazy.kt
@@ -48,7 +48,7 @@ public inline fun <T, R> Array<T>.flatMap(transform: (T)-> Collection<R>) : Coll
  * @includeFunctionBody ../../test/CollectionTest.kt plus
  */
 public inline fun <in T> Array<T>.plus(element: T): List<in T> {
-    val list = to(ArrayList<T>())
+    val list = toCollection(ArrayList<T>())
     list.add(element)
     return list
 }
@@ -60,7 +60,7 @@ public inline fun <in T> Array<T>.plus(element: T): List<in T> {
  * @includeFunctionBody ../../test/CollectionTest.kt plusCollection
  */
 public inline fun <in T> Array<T>.plus(elements: Array<T>): List<T> {
-    val list = to(ArrayList<T>())
+    val list = toCollection(ArrayList<T>())
     list.addAll(elements.toCollection())
     return list
 }
diff --git a/libraries/stdlib/src/generated/ArraysFromJUtilCollections.kt b/libraries/stdlib/src/generated/ArraysFromJUtilCollections.kt
index 2ec6befa344..e14666b5178 100644
--- a/libraries/stdlib/src/generated/ArraysFromJUtilCollections.kt
+++ b/libraries/stdlib/src/generated/ArraysFromJUtilCollections.kt
@@ -11,7 +11,7 @@ import java.util.*
 //
 
 /**
- * Returns a new List containing the results of applying the given function to each element in this collection
+ * Returns a new List containing the results of applying the given *transform* function to each element in this collection
  *
  * @includeFunctionBody ../../test/CollectionTest.kt map
  */
@@ -19,7 +19,10 @@ public inline fun <T, R> Array<T>.map(transform : (T) -> R) : java.util.List<R>
     return mapTo(java.util.ArrayList<R>(this.size), transform)
 }
 
-/** Transforms each element of this collection with the given function then adds the results to the given collection */
+/**
+ * Transforms each element of this collection with the given *transform* function and
+ * adds each return value to the given *results* collection
+ */
 public inline fun <T, R, C: Collection<in R>> Array<T>.mapTo(result: C, transform : (T) -> R) : C {
   for (item in this)
     result.add(transform(item))
diff --git a/libraries/stdlib/src/generated/JUtilIterablesFromJUtilCollections.kt b/libraries/stdlib/src/generated/JUtilIterablesFromJUtilCollections.kt
index 6cdb191c32e..6c8c4c84e70 100644
--- a/libraries/stdlib/src/generated/JUtilIterablesFromJUtilCollections.kt
+++ b/libraries/stdlib/src/generated/JUtilIterablesFromJUtilCollections.kt
@@ -11,7 +11,7 @@ import java.util.*
 //
 
 /**
- * Returns a new List containing the results of applying the given function to each element in this collection
+ * Returns a new List containing the results of applying the given *transform* function to each element in this collection
  *
  * @includeFunctionBody ../../test/CollectionTest.kt map
  */
@@ -19,7 +19,10 @@ public inline fun <T, R> java.lang.Iterable<T>.map(transform : (T) -> R) : java.
     return mapTo(java.util.ArrayList<R>(), transform)
 }
 
-/** Transforms each element of this collection with the given function then adds the results to the given collection */
+/**
+ * Transforms each element of this collection with the given *transform* function and
+ * adds each return value to the given *results* collection
+ */
 public inline fun <T, R, C: Collection<in R>> java.lang.Iterable<T>.mapTo(result: C, transform : (T) -> R) : C {
   for (item in this)
     result.add(transform(item))
diff --git a/libraries/stdlib/src/generated/JUtilIteratorsFromJLangIterables.kt b/libraries/stdlib/src/generated/JUtilIteratorsFromJLangIterables.kt
index a5f246eb0cf..3e3b1c39591 100644
--- a/libraries/stdlib/src/generated/JUtilIteratorsFromJLangIterables.kt
+++ b/libraries/stdlib/src/generated/JUtilIteratorsFromJLangIterables.kt
@@ -191,25 +191,25 @@ public inline fun <T> java.util.Iterator<T>.reverse() : List<T> {
 }
 
 /** Copies all elements into the given collection */
-public inline fun <in T, C: Collection<in T>> java.util.Iterator<T>.to(result: C) : C {
+public inline fun <in T, C: Collection<in T>> java.util.Iterator<T>.toCollection(result: C) : C {
     for (element in this) result.add(element)
     return result
 }
 
 /** Copies all elements into a [[LinkedList]]  */
-public inline fun <in T> java.util.Iterator<T>.toLinkedList() : LinkedList<T> = to(LinkedList<T>())
+public inline fun <in T> java.util.Iterator<T>.toLinkedList() : LinkedList<T> = toCollection(LinkedList<T>())
 
 /** Copies all elements into a [[List]] */
-public inline fun <in T> java.util.Iterator<T>.toList() : List<T> = to(ArrayList<T>())
+public inline fun <in T> java.util.Iterator<T>.toList() : List<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[List] */
-public inline fun <in T> java.util.Iterator<T>.toCollection() : Collection<T> = to(ArrayList<T>())
+public inline fun <in T> java.util.Iterator<T>.toCollection() : Collection<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[Set]] */
-public inline fun <in T> java.util.Iterator<T>.toSet() : Set<T> = to(HashSet<T>())
+public inline fun <in T> java.util.Iterator<T>.toSet() : Set<T> = toCollection(HashSet<T>())
 
 /** Copies all elements into a [[SortedSet]] */
-public inline fun <in T> java.util.Iterator<T>.toSortedSet() : SortedSet<T> = to(TreeSet<T>())
+public inline fun <in T> java.util.Iterator<T>.toSortedSet() : SortedSet<T> = toCollection(TreeSet<T>())
 
 /**
   TODO figure out necessary variance/generics ninja stuff... :)
diff --git a/libraries/stdlib/src/generated/StandardFromJLangIterables.kt b/libraries/stdlib/src/generated/StandardFromJLangIterables.kt
index 037ebe1ba58..e9684b9457e 100644
--- a/libraries/stdlib/src/generated/StandardFromJLangIterables.kt
+++ b/libraries/stdlib/src/generated/StandardFromJLangIterables.kt
@@ -193,25 +193,25 @@ public inline fun <T> Iterable<T>.reverse() : List<T> {
 }
 
 /** Copies all elements into the given collection */
-public inline fun <in T, C: Collection<in T>> Iterable<T>.to(result: C) : C {
+public inline fun <in T, C: Collection<in T>> Iterable<T>.toCollection(result: C) : C {
     for (element in this) result.add(element)
     return result
 }
 
 /** Copies all elements into a [[LinkedList]]  */
-public inline fun <in T> Iterable<T>.toLinkedList() : LinkedList<T> = to(LinkedList<T>())
+public inline fun <in T> Iterable<T>.toLinkedList() : LinkedList<T> = toCollection(LinkedList<T>())
 
 /** Copies all elements into a [[List]] */
-public inline fun <in T> Iterable<T>.toList() : List<T> = to(ArrayList<T>())
+public inline fun <in T> Iterable<T>.toList() : List<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[List] */
-public inline fun <in T> Iterable<T>.toCollection() : Collection<T> = to(ArrayList<T>())
+public inline fun <in T> Iterable<T>.toCollection() : Collection<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[Set]] */
-public inline fun <in T> Iterable<T>.toSet() : Set<T> = to(HashSet<T>())
+public inline fun <in T> Iterable<T>.toSet() : Set<T> = toCollection(HashSet<T>())
 
 /** Copies all elements into a [[SortedSet]] */
-public inline fun <in T> Iterable<T>.toSortedSet() : SortedSet<T> = to(TreeSet<T>())
+public inline fun <in T> Iterable<T>.toSortedSet() : SortedSet<T> = toCollection(TreeSet<T>())
 
 /**
   TODO figure out necessary variance/generics ninja stuff... :)
diff --git a/libraries/stdlib/src/generated/StandardFromJLangIterablesLazy.kt b/libraries/stdlib/src/generated/StandardFromJLangIterablesLazy.kt
index da63be3f6c9..65c3248dc2b 100644
--- a/libraries/stdlib/src/generated/StandardFromJLangIterablesLazy.kt
+++ b/libraries/stdlib/src/generated/StandardFromJLangIterablesLazy.kt
@@ -48,7 +48,7 @@ public inline fun <T, R> Iterable<T>.flatMap(transform: (T)-> Collection<R>) : C
  * @includeFunctionBody ../../test/CollectionTest.kt plus
  */
 public inline fun <in T> Iterable<T>.plus(element: T): List<in T> {
-    val list = to(ArrayList<T>())
+    val list = toCollection(ArrayList<T>())
     list.add(element)
     return list
 }
@@ -60,7 +60,7 @@ public inline fun <in T> Iterable<T>.plus(element: T): List<in T> {
  * @includeFunctionBody ../../test/CollectionTest.kt plusCollection
  */
 public inline fun <in T> Iterable<T>.plus(elements: Iterable<T>): List<T> {
-    val list = to(ArrayList<T>())
+    val list = toCollection(ArrayList<T>())
     list.addAll(elements.toCollection())
     return list
 }
diff --git a/libraries/stdlib/src/generated/StandardFromJUtilCollections.kt b/libraries/stdlib/src/generated/StandardFromJUtilCollections.kt
index 9820e5dfd94..4dbe8042091 100644
--- a/libraries/stdlib/src/generated/StandardFromJUtilCollections.kt
+++ b/libraries/stdlib/src/generated/StandardFromJUtilCollections.kt
@@ -11,7 +11,7 @@ import java.util.*
 //
 
 /**
- * Returns a new List containing the results of applying the given function to each element in this collection
+ * Returns a new List containing the results of applying the given *transform* function to each element in this collection
  *
  * @includeFunctionBody ../../test/CollectionTest.kt map
  */
@@ -19,7 +19,10 @@ public inline fun <T, R> Iterable<T>.map(transform : (T) -> R) : java.util.List<
     return mapTo(java.util.ArrayList<R>(), transform)
 }
 
-/** Transforms each element of this collection with the given function then adds the results to the given collection */
+/**
+ * Transforms each element of this collection with the given *transform* function and
+ * adds each return value to the given *results* collection
+ */
 public inline fun <T, R, C: Collection<in R>> Iterable<T>.mapTo(result: C, transform : (T) -> R) : C {
   for (item in this)
     result.add(transform(item))
diff --git a/libraries/stdlib/src/kotlin/JLangIterables.kt b/libraries/stdlib/src/kotlin/JLangIterables.kt
index 63a3400fbda..cee9694517d 100644
--- a/libraries/stdlib/src/kotlin/JLangIterables.kt
+++ b/libraries/stdlib/src/kotlin/JLangIterables.kt
@@ -190,25 +190,25 @@ public inline fun <T> java.lang.Iterable<T>.reverse() : List<T> {
 }
 
 /** Copies all elements into the given collection */
-public inline fun <in T, C: Collection<in T>> java.lang.Iterable<T>.to(result: C) : C {
+public inline fun <in T, C: Collection<in T>> java.lang.Iterable<T>.toCollection(result: C) : C {
     for (element in this) result.add(element)
     return result
 }
 
 /** Copies all elements into a [[LinkedList]]  */
-public inline fun <in T> java.lang.Iterable<T>.toLinkedList() : LinkedList<T> = to(LinkedList<T>())
+public inline fun <in T> java.lang.Iterable<T>.toLinkedList() : LinkedList<T> = toCollection(LinkedList<T>())
 
 /** Copies all elements into a [[List]] */
-public inline fun <in T> java.lang.Iterable<T>.toList() : List<T> = to(ArrayList<T>())
+public inline fun <in T> java.lang.Iterable<T>.toList() : List<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[List] */
-public inline fun <in T> java.lang.Iterable<T>.toCollection() : Collection<T> = to(ArrayList<T>())
+public inline fun <in T> java.lang.Iterable<T>.toCollection() : Collection<T> = toCollection(ArrayList<T>())
 
 /** Copies all elements into a [[Set]] */
-public inline fun <in T> java.lang.Iterable<T>.toSet() : Set<T> = to(HashSet<T>())
+public inline fun <in T> java.lang.Iterable<T>.toSet() : Set<T> = toCollection(HashSet<T>())
 
 /** Copies all elements into a [[SortedSet]] */
-public inline fun <in T> java.lang.Iterable<T>.toSortedSet() : SortedSet<T> = to(TreeSet<T>())
+public inline fun <in T> java.lang.Iterable<T>.toSortedSet() : SortedSet<T> = toCollection(TreeSet<T>())
 
 /**
   TODO figure out necessary variance/generics ninja stuff... :)
diff --git a/libraries/stdlib/src/kotlin/JLangIterablesLazy.kt b/libraries/stdlib/src/kotlin/JLangIterablesLazy.kt
index 60acefb602e..314748efd14 100644
--- a/libraries/stdlib/src/kotlin/JLangIterablesLazy.kt
+++ b/libraries/stdlib/src/kotlin/JLangIterablesLazy.kt
@@ -45,7 +45,7 @@ public inline fun <T, R> java.lang.Iterable<T>.flatMap(transform: (T)-> Collecti
  * @includeFunctionBody ../../test/CollectionTest.kt plus
  */
 public inline fun <in T> java.lang.Iterable<T>.plus(element: T): List<in T> {
-    val list = to(ArrayList<T>())
+    val list = toCollection(ArrayList<T>())
     list.add(element)
     return list
 }
@@ -57,7 +57,7 @@ public inline fun <in T> java.lang.Iterable<T>.plus(element: T): List<in T> {
  * @includeFunctionBody ../../test/CollectionTest.kt plusCollection
  */
 public inline fun <in T> java.lang.Iterable<T>.plus(elements: java.lang.Iterable<T>): List<T> {
-    val list = to(ArrayList<T>())
+    val list = toCollection(ArrayList<T>())
     list.addAll(elements.toCollection())
     return list
 }
diff --git a/libraries/stdlib/src/kotlin/JUtil.kt b/libraries/stdlib/src/kotlin/JUtil.kt
index 1fa691766c2..10bac18540c 100644
--- a/libraries/stdlib/src/kotlin/JUtil.kt
+++ b/libraries/stdlib/src/kotlin/JUtil.kt
@@ -12,23 +12,23 @@ val Collection<*>.empty : Boolean
     get() = isEmpty()
 
 /** Returns a new ArrayList with a variable number of initial elements */
-public inline fun arrayList<T>(vararg values: T) : ArrayList<T> = values.to(ArrayList<T>(values.size))
+public inline fun arrayList<T>(vararg values: T) : ArrayList<T> = values.toCollection(ArrayList<T>(values.size))
 
 /** Returns a new LinkedList with a variable number of initial elements */
-public inline fun linkedList<T>(vararg values: T) : LinkedList<T>  = values.to(LinkedList<T>())
+public inline fun linkedList<T>(vararg values: T) : LinkedList<T>  = values.toCollection(LinkedList<T>())
 
 /** Returns a new HashSet with a variable number of initial elements */
-public inline fun hashSet<T>(vararg values: T) : HashSet<T> = values.to(HashSet<T>(values.size))
+public inline fun hashSet<T>(vararg values: T) : HashSet<T> = values.toCollection(HashSet<T>(values.size))
 
 /**
  * Returns a new [[SortedSet]] with the initial elements
  */
-public inline fun sortedSet<T>(vararg values: T) : TreeSet<T> = values.to(TreeSet<T>())
+public inline fun sortedSet<T>(vararg values: T) : TreeSet<T> = values.toCollection(TreeSet<T>())
 
 /**
  * Returns a new [[SortedSet]] with the given *comparator* and the initial elements
  */
-public inline fun sortedSet<T>(comparator: Comparator<T>, vararg values: T) : TreeSet<T> = values.to(TreeSet<T>(comparator))
+public inline fun sortedSet<T>(comparator: Comparator<T>, vararg values: T) : TreeSet<T> = values.toCollection(TreeSet<T>(comparator))
 
 /**
  * Returns a new [[HashMap]] populated with the given tuple values where the first value in each tuple
diff --git a/libraries/stdlib/src/kotlin/Standard.kt b/libraries/stdlib/src/kotlin/Standard.kt
index ec63b159b77..eaa5ff71019 100644
--- a/libraries/stdlib/src/kotlin/Standard.kt
+++ b/libraries/stdlib/src/kotlin/Standard.kt
@@ -36,7 +36,7 @@ public fun <erased T> java.util.Enumeration<T>.iterator(): Iterator<T> = object:
 /**
 Add iterated elements to given container
 */
-public fun <T,U: Collection<in T>> Iterator<T>.to(container: U) : U {
+public fun <T,U: Collection<in T>> Iterator<T>.toCollection(container: U) : U {
     while(hasNext)
         container.add(next())
     return container
@@ -45,33 +45,33 @@ public fun <T,U: Collection<in T>> Iterator<T>.to(container: U) : U {
 /**
 Add iterated elements to java.util.ArrayList
 */
-public inline fun <T> Iterator<T>.toArrayList() : ArrayList<T> = to(ArrayList<T>())
+public inline fun <T> Iterator<T>.toArrayList() : ArrayList<T> = toCollection(ArrayList<T>())
 
 /**
 Add iterated elements to java.util.LinkedList
 */
-public inline fun <T> Iterator<T>.toLinkedList() : LinkedList<T> = to(LinkedList<T>())
+public inline fun <T> Iterator<T>.toLinkedList() : LinkedList<T> = toCollection(LinkedList<T>())
 
 /**
 Add iterated elements to java.util.HashSet
 */
-public inline fun <T> Iterator<T>.toHashSet() : HashSet<T> = to(HashSet<T>())
+public inline fun <T> Iterator<T>.toHashSet() : HashSet<T> = toCollection(HashSet<T>())
 
 /**
  * Add iterated elements to a [[LinkedHashSet]] to preserve insertion order
  */
-public inline fun <T> Iterator<T>.toLinkedSet() : LinkedHashSet<T> = to(LinkedHashSet<T>())
+public inline fun <T> Iterator<T>.toLinkedSet() : LinkedHashSet<T> = toCollection(LinkedHashSet<T>())
 
 /**
  * Add iterated elements to [[SortedSet]] to ensure iteration is in the order of the default comparator
  * for the type
  */
-public inline fun <T> Iterator<T>.toSortedSet() : SortedSet<T> = to(TreeSet<T>())
+public inline fun <T> Iterator<T>.toSortedSet() : SortedSet<T> = toCollection(TreeSet<T>())
 
 /**
  * Add iterated elements to [[SortedSet]] with the given *comparator* to ensure iteration is in the order of the given comparator
  */
-public inline fun <T> Iterator<T>.toSortedSet(comparator: Comparator<T>) : SortedSet<T> = to(TreeSet<T>(comparator))
+public inline fun <T> Iterator<T>.toSortedSet(comparator: Comparator<T>) : SortedSet<T> = toCollection(TreeSet<T>(comparator))
 
 /**
 Run function f
diff --git a/libraries/stdlib/src/kotlin/nullable/Nullables.kt b/libraries/stdlib/src/kotlin/nullable/Nullables.kt
index a41e65dab05..7066dcbf329 100644
--- a/libraries/stdlib/src/kotlin/nullable/Nullables.kt
+++ b/libraries/stdlib/src/kotlin/nullable/Nullables.kt
@@ -156,23 +156,23 @@ public inline fun <T> T?.reverse(): T? {
 }
 
 /** Copies the collection into the given collection */
-public inline fun <T, C: Collection<T>> T?.to(result: C): C {
+public inline fun <T, C: Collection<T>> T?.toCollection(result: C): C {
     if (this != null)
         result.add(this)
     return result
 }
 
 /** Converts the collection into a LinkedList */
-public inline fun <T> T?.toLinkedList(): LinkedList<T> = this.to(LinkedList<T>())
+public inline fun <T> T?.toLinkedList(): LinkedList<T> = this.toCollection(LinkedList<T>())
 
 /**  Converts the collection into a List */
-public inline fun <T> T?.toList(): List<T> = this.to(ArrayList<T>())
+public inline fun <T> T?.toList(): List<T> = this.toCollection(ArrayList<T>())
 
 /** Converts the collection into a Set */
-public inline fun <T> T?.toSet(): Set<T> = this.to(HashSet<T>())
+public inline fun <T> T?.toSet(): Set<T> = this.toCollection(HashSet<T>())
 
 /** Converts the collection into a SortedSet */
-public inline fun <T> T?.toSortedSet(): SortedSet<T> = this.to(TreeSet<T>())
+public inline fun <T> T?.toSortedSet(): SortedSet<T> = this.toCollection(TreeSet<T>())
 /**
   TODO figure out necessary variance/generics ninja stuff... :)
 public inline fun <in T> T?.toSortedList(transform: fun(T) : java.lang.Comparable<*>) : List<T> {