|
@@ -24,11 +24,11 @@
|
|
The `Lambda` class is a collection of methods to support functional
|
|
The `Lambda` class is a collection of methods to support functional
|
|
programming. It is ideally used with 'using Lambda' and then acts as an
|
|
programming. It is ideally used with 'using Lambda' and then acts as an
|
|
extension to Iterable types.
|
|
extension to Iterable types.
|
|
-
|
|
|
|
|
|
+
|
|
On static platforms, working with the Iterable structure might be slower
|
|
On static platforms, working with the Iterable structure might be slower
|
|
than performing the operations directly on known types, such as Array and
|
|
than performing the operations directly on known types, such as Array and
|
|
List.
|
|
List.
|
|
-
|
|
|
|
|
|
+
|
|
If the first argument to any of the methods is null, the result is
|
|
If the first argument to any of the methods is null, the result is
|
|
unspecified.
|
|
unspecified.
|
|
**/
|
|
**/
|
|
@@ -36,7 +36,7 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Creates an Array from Iterable `it`.
|
|
Creates an Array from Iterable `it`.
|
|
-
|
|
|
|
|
|
+
|
|
If `it` is an Array, this function returns a copy of it.
|
|
If `it` is an Array, this function returns a copy of it.
|
|
**/
|
|
**/
|
|
public static function array<A>( it : Iterable<A> ) : Array<A> {
|
|
public static function array<A>( it : Iterable<A> ) : Array<A> {
|
|
@@ -48,7 +48,7 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Creates a List form Iterable `it`.
|
|
Creates a List form Iterable `it`.
|
|
-
|
|
|
|
|
|
+
|
|
If `it` is a List, this function returns a copy of it.
|
|
If `it` is a List, this function returns a copy of it.
|
|
**/
|
|
**/
|
|
public static function list<A>( it : Iterable<A> ) : List<A> {
|
|
public static function list<A>( it : Iterable<A> ) : List<A> {
|
|
@@ -60,9 +60,9 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Creates a new List by applying function `f` to all elements of `it`.
|
|
Creates a new List by applying function `f` to all elements of `it`.
|
|
-
|
|
|
|
|
|
+
|
|
The order of elements is preserved.
|
|
The order of elements is preserved.
|
|
-
|
|
|
|
|
|
+
|
|
If `f` is null, the result is unspecified.
|
|
If `f` is null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function map<A,B>( it : Iterable<A>, f : A -> B ) : List<B> {
|
|
public static function map<A,B>( it : Iterable<A>, f : A -> B ) : List<B> {
|
|
@@ -74,9 +74,9 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Similar to map, but also passes the index of each element to `f`.
|
|
Similar to map, but also passes the index of each element to `f`.
|
|
-
|
|
|
|
|
|
+
|
|
The order of elements is preserved.
|
|
The order of elements is preserved.
|
|
-
|
|
|
|
|
|
+
|
|
If `f` is null, the result is unspecified.
|
|
If `f` is null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function mapi<A,B>( it : Iterable<A>, f : Int -> A -> B ) : List<B> {
|
|
public static function mapi<A,B>( it : Iterable<A>, f : Int -> A -> B ) : List<B> {
|
|
@@ -89,10 +89,10 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Tells if `it` contains `elt`.
|
|
Tells if `it` contains `elt`.
|
|
-
|
|
|
|
|
|
+
|
|
This function returns true as soon as an element is found which is equal
|
|
This function returns true as soon as an element is found which is equal
|
|
to `elt` according to the `==` operator.
|
|
to `elt` according to the `==` operator.
|
|
-
|
|
|
|
|
|
+
|
|
If no such element is found, the result is false.
|
|
If no such element is found, the result is false.
|
|
**/
|
|
**/
|
|
public static function has<A>( it : Iterable<A>, elt : A ) : Bool {
|
|
public static function has<A>( it : Iterable<A>, elt : A ) : Bool {
|
|
@@ -104,12 +104,12 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Tells if `it` contains an element for which `f` is true.
|
|
Tells if `it` contains an element for which `f` is true.
|
|
-
|
|
|
|
|
|
+
|
|
This function returns true as soon as an element is found for which a
|
|
This function returns true as soon as an element is found for which a
|
|
call to `f` returns true.
|
|
call to `f` returns true.
|
|
-
|
|
|
|
|
|
+
|
|
If no such element is found, the result is false.
|
|
If no such element is found, the result is false.
|
|
-
|
|
|
|
|
|
+
|
|
If `f` is null, the result is unspecified.
|
|
If `f` is null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function exists<A>( it : Iterable<A>, f : A -> Bool ) {
|
|
public static function exists<A>( it : Iterable<A>, f : A -> Bool ) {
|
|
@@ -121,14 +121,14 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Tells if `f` is true for all elements of `it`.
|
|
Tells if `f` is true for all elements of `it`.
|
|
-
|
|
|
|
|
|
+
|
|
This function returns false as soon as an element is found for which a
|
|
This function returns false as soon as an element is found for which a
|
|
call to `f` returns false.
|
|
call to `f` returns false.
|
|
-
|
|
|
|
|
|
+
|
|
If no such element is found, the result is true.
|
|
If no such element is found, the result is true.
|
|
-
|
|
|
|
|
|
+
|
|
In particular, this function always returns true if `it` is empty.
|
|
In particular, this function always returns true if `it` is empty.
|
|
-
|
|
|
|
|
|
+
|
|
If `f` is null, the result is unspecified.
|
|
If `f` is null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function foreach<A>( it : Iterable<A>, f : A -> Bool ) {
|
|
public static function foreach<A>( it : Iterable<A>, f : A -> Bool ) {
|
|
@@ -140,7 +140,7 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Calls `f` on all elements of `it`, in order.
|
|
Calls `f` on all elements of `it`, in order.
|
|
-
|
|
|
|
|
|
+
|
|
If `f` is null, the result is unspecified.
|
|
If `f` is null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function iter<A>( it : Iterable<A>, f : A -> Void ) {
|
|
public static function iter<A>( it : Iterable<A>, f : A -> Void ) {
|
|
@@ -151,9 +151,9 @@ class Lambda {
|
|
/**
|
|
/**
|
|
Returns a List containing those elements of `it` for which `f` returned
|
|
Returns a List containing those elements of `it` for which `f` returned
|
|
true.
|
|
true.
|
|
-
|
|
|
|
|
|
+
|
|
If `it` is empty, the result is the empty List even if `f` is null.
|
|
If `it` is empty, the result is the empty List even if `f` is null.
|
|
-
|
|
|
|
|
|
+
|
|
Otherwise if `f` is null, the result is unspecified.
|
|
Otherwise if `f` is null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function filter<A>( it : Iterable<A>, f : A -> Bool ) {
|
|
public static function filter<A>( it : Iterable<A>, f : A -> Bool ) {
|
|
@@ -167,13 +167,13 @@ class Lambda {
|
|
/**
|
|
/**
|
|
Functional fold on Iterable `it`, using function `f` with start argument
|
|
Functional fold on Iterable `it`, using function `f` with start argument
|
|
`first`.
|
|
`first`.
|
|
-
|
|
|
|
|
|
+
|
|
If `it` has no elements, the result is `first`.
|
|
If `it` has no elements, the result is `first`.
|
|
-
|
|
|
|
|
|
+
|
|
Otherwise the first element of `it` is passed to `f` alongside `first`.
|
|
Otherwise the first element of `it` is passed to `f` alongside `first`.
|
|
The result of that call is then passed to `f` with the next element of
|
|
The result of that call is then passed to `f` with the next element of
|
|
`it`, and so on until `it` has no more elements.
|
|
`it`, and so on until `it` has no more elements.
|
|
-
|
|
|
|
|
|
+
|
|
If `it` or `f` are null, the result is unspecified.
|
|
If `it` or `f` are null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function fold<A,B>( it : Iterable<A>, f : A -> B -> B, first : B ) : B {
|
|
public static function fold<A,B>( it : Iterable<A>, f : A -> B -> B, first : B ) : B {
|
|
@@ -185,7 +185,7 @@ class Lambda {
|
|
/**
|
|
/**
|
|
Returns the number of elements in `it` for which `pred` is true, or the
|
|
Returns the number of elements in `it` for which `pred` is true, or the
|
|
total number of elements in `it` if `pred` is null.
|
|
total number of elements in `it` if `pred` is null.
|
|
-
|
|
|
|
|
|
+
|
|
This function traverses all elements.
|
|
This function traverses all elements.
|
|
**/
|
|
**/
|
|
public static function count<A>( it : Iterable<A>, ?pred : A -> Bool ) {
|
|
public static function count<A>( it : Iterable<A>, ?pred : A -> Bool ) {
|
|
@@ -209,9 +209,9 @@ class Lambda {
|
|
|
|
|
|
/**
|
|
/**
|
|
Returns the index of the first element `v` within Iterable `it`.
|
|
Returns the index of the first element `v` within Iterable `it`.
|
|
-
|
|
|
|
|
|
+
|
|
This function uses operator `==` to check for equality.
|
|
This function uses operator `==` to check for equality.
|
|
-
|
|
|
|
|
|
+
|
|
If `v` does not exist in `it`, the result is -1.
|
|
If `v` does not exist in `it`, the result is -1.
|
|
**/
|
|
**/
|
|
public static function indexOf<T>( it : Iterable<T>, v : T ) : Int {
|
|
public static function indexOf<T>( it : Iterable<T>, v : T ) : Int {
|
|
@@ -223,15 +223,15 @@ class Lambda {
|
|
}
|
|
}
|
|
return -1;
|
|
return -1;
|
|
}
|
|
}
|
|
-
|
|
|
|
|
|
+
|
|
/**
|
|
/**
|
|
Returns the first element of `it` for which `f` is true.
|
|
Returns the first element of `it` for which `f` is true.
|
|
-
|
|
|
|
|
|
+
|
|
This function returns true as soon as an element is found for which a
|
|
This function returns true as soon as an element is found for which a
|
|
call to `f` returns true.
|
|
call to `f` returns true.
|
|
-
|
|
|
|
|
|
+
|
|
If no such element is found, the result is null.
|
|
If no such element is found, the result is null.
|
|
-
|
|
|
|
|
|
+
|
|
If `f` is null, the result is unspecified.
|
|
If `f` is null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function find<T>( it : Iterable<T>, f : T -> Bool ) : Null<T> {
|
|
public static function find<T>( it : Iterable<T>, f : T -> Bool ) : Null<T> {
|
|
@@ -244,7 +244,7 @@ class Lambda {
|
|
/**
|
|
/**
|
|
Returns a new List containing all elements of Iterable `a` followed by
|
|
Returns a new List containing all elements of Iterable `a` followed by
|
|
all elements of Iterable `b`.
|
|
all elements of Iterable `b`.
|
|
-
|
|
|
|
|
|
+
|
|
If `a` or `b` are null, the result is unspecified.
|
|
If `a` or `b` are null, the result is unspecified.
|
|
**/
|
|
**/
|
|
public static function concat<T>( a : Iterable<T>, b : Iterable<T> ) : List<T> {
|
|
public static function concat<T>( a : Iterable<T>, b : Iterable<T> ) : List<T> {
|