Skip to content

MongoDB request DSL • opensavvy.ktmongo.dsl.aggregation.operators • StringValueOperators • replace

replace

open fun <Context : Any> Value<Context, String?>.replace(find: Value<Context, String?>, replacement: Value<Context, String?>): Value<Context, String?>

Replaces all instances of find with a replacement string.

If no occurrences of find are found in the input string, the input string is returned. If any of the input, find or replacement is null, null is returned.

The input, find, and replacement expressions must evaluate to a string or a null, or $replaceAll fails with an error.

Example

class Document(
    val item: String,
)

collection.aggregate()
    .set {
        Document::item set of(Document::item).replace(find = of("blue paint"), replacement = of("red paint"))
    }.toList()

External resources

open fun <Context : Any> Value<Context, String?>.replace(find: String, replacement: String): Value<Context, String?>

Replaces all instances of find with a replacement string.

If no occurrences of find are found in the input string, the input string is returned. If the input is null, null is returned.

The input must evaluate to a string or a null, or $replaceAll fails with an error.

Example

class Document(
    val item: String,
)

collection.aggregate()
    .set {
        Document::item set of(Document::item).replace(find = "blue paint", replacement = "red paint")
    }.toList()

External resources