<div class='type'>Function</div>


<a id='references'></a>


<h2 id="byvalue-transformation">byValue</h2>

<div class='sourceset sourceset-common'>Common</div>


```kotlin
fun InputTransformation.byValue(
    transformation: (current: CharSequence, proposed: CharSequence) -> CharSequence
): InputTransformation
```


Creates an `InputTransformation` from a function that accepts both the current and proposed
`TextFieldCharSequence` and returns the `TextFieldCharSequence` to use for the field.

`transformation` can return either `current`, `proposed`, or a completely different value.

The selection or cursor will be updated automatically. For more control of selection implement
`InputTransformation` directly.