replace_strings()

Reemplaza todas las cadenas coincide con cadenas especificadas.

Para reemplazar una cadena individual, consulte replace_string().

Syntax

replace_strings(Texto,Búsquedas,Reescribe)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
text	string	✔️	Cadena de origen.
Búsquedas	dynamic	✔️	Matriz que incluye cadenas de búsqueda. Elemento array que no es una cadena se omite.
Reescribe	dynamic	✔️	Matriz que incluye reescrituras. Elemento array que no es una cadena se omite (no se realiza ningún reemplazo).

Devoluciones

Devuelve texto después de reemplazar todas las coincidencias de búsquedas por evaluaciones de reescrituras. Las coincidencias no se superponen.

Ejemplos

Reemplazo simple

Ejecución de la consulta

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['cat', 'dog']), // Lookup strings
        dynamic(['dog', 'pigeon']) // Replacements
        )

Message	Resultado
Un truco mágico puede convertir a un gato en un perro	Un truco mágico puede convertir a un perro en una paloma

Reemplazo con una cadena vacía

El reemplazo con una cadena vacía quita la cadena coincidente.

Ejecución de la consulta

print Message="A magic trick can turn a cat into a dog"
| extend Outcome = replace_strings(
        Message,
        dynamic(['turn', ' into a dog']), // Lookup strings
        dynamic(['disappear', '']) // Replacements
        )

Message	Resultado
Un truco mágico puede convertir a un gato en un perro	Un truco mágico puede desaparecer un gato

Orden de reemplazo

El orden de los elementos coincidentes importa: la coincidencia anterior tiene prioridad. Tenga en cuenta la diferencia entre Outcome1 y Outcome2: This frente a Thwas.

Ejecución de la consulta

 print Message="This is an example of using replace_strings()"
| extend Outcome1 = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic(['This', 'was']) // Replacements
        ),
        Outcome2 = replace_strings(
        Message,
        dynamic(['is', 'This']), // Lookup strings
        dynamic(['was', 'This']) // Replacements
        )

Message	Resultado1	Resultado2
Este es un ejemplo de uso de replace_strings()	Este fue un ejemplo de uso de replace_strings()	Thwas era un ejemplo de uso de replace_strings()

Reemplazo de cadena no cadena

Los elementos replace que no son cadenas no se reemplazan y se mantiene la cadena original. La coincidencia todavía se considera válida y no se realizan otros reemplazos posibles en la cadena coincidente. En el ejemplo siguiente, "This" no se reemplaza por el numérico 12345y permanece en la salida sin verse afectada por la posible coincidencia con "is".

Ejecución de la consulta

 print Message="This is an example of using replace_strings()"
| extend Outcome = replace_strings(
        Message,
        dynamic(['This', 'is']), // Lookup strings
        dynamic([12345, 'was']) // Replacements
        )

Message	Resultado
Este es un ejemplo de uso de replace_strings()	Este fue un ejemplo de uso de replace_strings()

Contenido relacionado

• Para obtener un reemplazo de una sola cadena, consulte replace_string().
• Para obtener un reemplazo basado en la expresión regular, consulte replace_regex().
• Para reemplazar un conjunto de caracteres, consulte translate().