/ /

Operadores

Operadores de tuberías de agregación

Docs Home

Manual de base de datos

Referencia

Operadores

Operadores de tuberías de agregación

$replaceOne (agregación)

Esta versión de la documentación está archivada y ya no recibe soporte. Para actualizar su implementación 6.0, consulte Procedimientos de actualización de MongoDB.7.0

Definición

$replaceOne

Reemplaza la primera instancia de una cadena de búsqueda en una cadena de entrada con una cadena de reemplazo.

Si no se encuentran ocurrencias, evalúa la cadena de$replaceOne entrada.

$replaceOne distingue entre mayúsculas y minúsculas y distingue entre diacríticos e ignora cualquier intercalación presente en una colección.

Sintaxis

El operador tiene lo $replaceOne siguiente Sintaxis de expresión del operador:

{ $replaceOne: { input: <expression>, find: <expression>, replacement: <expression> } }

Campos del operador

Campo	Descripción
entrada	La cadena a la que desea aplicar la búsqueda.Puede ser cualquier expresión válida que se resuelva en una cadena o en `null` un. Si `input` hace referencia a un campo`$replaceOne` faltante,`null` devuelve.
buscar	La cadena que se busca en la entrada dada. Puede ser cualquier expresión válida que se resuelva en una cadena o en `null` un. Si `find` hace referencia a un campo`$replaceOne` faltante,`null` devuelve.
sustitución	La cadena que se usará para reemplazar la primera coincidencia de find en la entrada. Puede ser cualquier expresión válida que se resuelva en una cadena o en `null` un.

Comportamiento

Si no se encuentran ocurrencias de find en la entrada, se$replaceOne evalúa como la cadena de entrada.

Las expresiones de entrada, búsqueda y reemplazo deben evaluarse como una cadena o un,null $replaceOne de lo contrario fallará con un error.

`$replaceOne` y valores nulos

Si input o find se refieren a un campo que falta, devuelven null.

Si cualquiera de las opciones de entrada, búsqueda o reemplazo se evalúa null como, la $replaceOne expresión completa se evalúa null como:

Ejemplo	Resultado
`{ $replaceOne: { input: null, find: "abc", replacement: "ABC" } }`	`null`
`{ $replaceOne: { input: "abc", find: null, replacement: "ABC" } }`	`null`
`{ $replaceOne: { input: "abc", find: "abc", replacement: null } }`	`null`

$replaceOne y intercalación

La coincidencia de cadenas $replaceOne con expresiones siempre distingue entre mayúsculas y minúsculas y diacríticas. Cualquier intercalación configurada se ignora al realizar comparaciones de cadenas $replaceOne con.

Por ejemplo, cree una colección de muestra con un nivel de intercalación de 1:

db.createCollection( "restaurants", { collation: { locale: "fr", strength: 1 } } )

Un nivel de intercalación de 1 compara únicamente el carácter base e ignora otras diferencias, como mayúsculas y minúsculas y signos diacríticos.

A continuación, inserte documentos de ejemplo:

db.restaurants.insertMany( [
   { _id: 1, name: "cafe" },
   { _id: 2, name: "Cafe" },
   { _id: 3, name: "café" }
] )

La siguiente operación intenta encontrar y reemplazar la primera instancia de "Cafe" en $replaceOne el name campo:

.. output::
   :language: javascript
   :emphasize-lines: 2
   { "_id" : 1, "name" : "cafe", "resultObject" : "cafe" }
   { "_id" : 2, "name" : "Cafe", "resultObject" : "CAFE" }
   { "_id" : 3, "name" : "café", "resultObject" : "café" }

Debido a que ignora la intercalación configurada para esta colección, la operación solo coincide con la instancia de "Cafe" en $replaceOne el 2 documento.

Los operadores que respetan $match la intercalación, como, coincidirían con los tres documentos al realizar una comparación de cadenas con "Cafe" debido a la fuerza de intercalación de esta colección 1 de.

`$replaceOne` y normalización Unicode

La $replaceOne expresión de agregación no realiza ninguna normalización Unicode. Esto significa que la coincidencia de cadenas para todas las $replaceOne expresiones considerará el número de puntos de código utilizados para representar un carácter Unicode al intentar una coincidencia.

Por ejemplo, el carácter é se puede representar en Unicode utilizando uno o dos puntos de código:

Unicode	Se muestra como	Puntos de código
`\xe9`	`é`	1 ( `\xe9` )
`e\u0301`	`é`	2 ( `e` + `\u0301` )

El $replaceOne uso de con una cadena de búsqueda donde el carácter é está representado en Unicode con un punto de código no coincidirá con ninguna instancia de é que use dos puntos de código en la cadena de entrada.

La siguiente tabla muestra si se produce una coincidencia para la cadena de búsqueda "café" al compararla con cadenas de entrada donde é se representa con uno o dos puntos de código. La cadena de búsqueda de este ejemplo utiliza un punto de código para representar el é carácter:

Ejemplo	Match
`{ $replaceOne: { input: "caf\xe9", find: "café", replacement: "CAFE" } }`	sí
`{ $replaceOne: { input: "cafe\u0301", find: "café", replacement: "CAFE" } }`	no

Debido a que no realiza ninguna normalización Unicode, solo coincide $replaceOne la primera comparación de cadenas, donde tanto la cadena de búsqueda como la de entrada utilizan un punto de código para é representar.

Ejemplo

Crea una colección inventory con los siguientes documentos:

db.inventory.insertMany( [
   { _id: 1, item: "blue paint" },
   { _id: 2, item: "blue and green paint" },
   { _id: 3, item: "blue paint with blue paintbrush" },
   { _id: 4, item: "blue paint with green paintbrush" },
] )

El siguiente ejemplo reemplaza la primera instancia de "pintura azul" en el campo item con "pintura roja":

db.inventory.aggregate([
   {
     $project:
      {
         item: { $replaceOne: { input: "$item", find: "blue paint", replacement: "red paint" } }
      }
   }
])

La operación devuelve los siguientes resultados:

{ _id: 1, item: "red paint" }
{ _id: 2, item: "blue and green paint" }
{ _id: 3, item: "red paint with blue paintbrush" }
{ _id: 4, item: "red paint with green paintbrush" }

Tenga en cuenta que con el documento 3, solo se reemplaza la primera instancia coincidente de "pintura azul".

Volver

$regexMatch

$replaceAll