基本的な呼び出し方まで追記

Author: k163377

README.md

@@ -59,3 +59,44 @@ val fastKFunction = FastKFunction(sample::instanceFun, sample)
 
 Depending on how you get the `KFunction`, the `instance parameter` may be required.
 Even if the `instance parameter` is not required, passing an `instance parameter` will make the call faster.
+
+### How to call.
+`FastKFunction` supports two major types of calls.
+
+#### Call by vararg or Collection.
+Calling with `vararg` or `Collection` is faster if you don't need to use the default arguments and
+ can get them in the order in which they are defined.
+
+```kotlin
+val fastKFunction: FastKFunction<Sample> = FastKFunction(function)
+
+// call by vararg
+val result: Sample = fastKFunction.call(1, 2, 3, 4, 5)
+
+// call by Collection
+val result: Sample = fastKFunction.callByCollection(listOf(1, 2, 3, 4, 5))
+```
+
+#### Call by ArgumentBucket.
+If the default argument is expected to be used, a call using `ArgumentBucket` is available.
+
+`ArgumentBucket` has interfaces like `MutableMap<KParameter, Any?>`, which can be used, for example, as follows.
+
+```kotlin
+data class Sample(
+    val arg1: Int,
+    val arg2: Int = 0,
+    val arg3: String? = null
+)
+
+private val fastKFunction: FastKFunction<Sample> = FastKFunction(::Sample)
+
+fun map(src: Map<String, Any?>): Sample {
+    return fastKFunction.generateBucket()
+        .apply { 
+            fastKFunction.valueParameters.forEach {
+                if (src.containsKey(it.name!!)) this[it] = src.getValue(it.name!!)
+            }
+        }.let { fastKFunction.callBy(it) }
+}
+```