Merge pull request #50 from ankurp/davidpdrsn-master

Adding example and remove scheme files

Dollar/Dollar.swift

@@ -392,6 +392,14 @@ class $ {
         return result
     }
 
+    /// The identity function. Returns the argument it is given.
+    ///
+    /// :param arg Value to return
+    /// :return Argument that was passed
+    class func id<T>(arg: T) -> T {
+        return arg
+    }
+
     /// Gets the index at which the first occurrence of value is found.
     ///
     /// :param array The array to source from.

DollarTests/DollarTests.swift

@@ -323,6 +323,7 @@ class DollarTests: XCTestCase {
     func testReduce() {
         XCTAssertEqual($.reduce([1, 2, 3, 4, 5], initial: 0) { $0 + $1 }, 15, "Reduce function should sum elements in the array")
     }
+
 
     func testSlice() {
         XCTAssertEqualObjects($.slice([1,2,3,4,5], start: 0, end: 2), [1, 2], "Slice subarray 0..2")
@@ -351,5 +352,10 @@ class DollarTests: XCTestCase {
         let z = fibMemo(6)
         XCTAssertEqualObjects(times, 1, "Function called 1 times due to memoize")
     }
+
+
+    func testId() {
+        XCTAssertEqual($.id(1), 1, "Id should return the argument it gets passed")
+    }
 
 }

README.md

@@ -97,6 +97,7 @@ Method | Usage
 ---- | ---------
 **`$.after`**|Creates a function that executes passed function only after being called n times.
 **`$.bind`**|Creates a function that, when called, invokes func with the binding of arguments provided.
+**`$.id`**|The identify function which simply returns the argument its given.
 **`$.partial`**|Creates a function that, when called, invokes func with any additional partial arguments prepended to those provided to the new function.
 **`$.times`**|Call a function n times and also passes the index. If a value is returned in the function then the times method will return an array of those values.
 
@@ -662,6 +663,15 @@ helloWorldFunc()
 => "Hello World from Swift"
 ```
 
+### id - `$.id`
+
+The identify function which simply returns the argument its given.
+
+```swift
+$.id("Hello World from Swift")
+=> "Hello World from Swift"
+```
+
 ### partial - `$.partial`
 
 Creates a function that, when called, invokes func with any additional partial arguments prepended to those provided to the new function.