$replaceOne (operador de expressão )

Campos do operador

$replaceOne e valores nulos

Se entrada ou localização se referirem a um campo ausente, elas retornarão null.

Se qualquer um de entrada, localização ou substituição for avaliado como null, a expressão $replaceOne inteira será avaliada como null:

$replaceOne e Agrupamento

a correspondência de strings para expressões $replaceOne sempre faz distinção entre maiúsculas e minúsculas e diacríticos. Qualquer agrupamento configurado é ignorado ao realizar comparações de strings com $replaceOne.

Por exemplo, crie uma collection de amostras com força de agrupamento 1:

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

A força de um agrupamento de 1 compara apenas o caractere base e ignora outras diferenças, como letras maiúsculas, letras minúsculas e diacríticos.

Em seguida, insira documentos de exemplo :

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

A operação $replaceOne a seguir tenta localizar e substituir a primeira instância de "Cafe" no camponame :

db.restaurants.aggregate( [
{
   $addFields:
      {
         resultObject: {
            $replaceOne: {
               input: "$name",
               find: "Cafe",
               replacement: "CAFE"
            }
         }
      }
}
] )

{ "_id" : 1, "name" : "cafe", "resultObject" : "cafe" }
{ "_id" : 2, "name" : "Cafe", "resultObject" : "CAFE" }
{ "_id" : 3, "name" : "café", "resultObject" : "café" }

Como $replaceOne ignora o agrupamento configurado para essa collection, a operação corresponde apenas à instância de "Cafe" no documento 2.

Os operadores que respeitam o agrupamento, como $match, corresponderiam a todos os três documentos ao realizar uma comparação de strings de "Cafe" devido à força de agrupamento dessa collection de 1.

$replaceOne e normalização Unicode

A expressão de agregação $replaceOne não executa nenhuma normalização unicode. Isso significa que a correspondência de strings de todas as expressões $replaceOne considerará o número de pontos de código usados para representar um caractere em unicode ao tentar uma correspondência.

Por exemplo, o caractere é pode ser representado em unicode usando um ou dois pontos de código:

Usar $replaceOne com uma string localização em que o caractere é é representado em unicode com um ponto de código não corresponderá a nenhuma instância de é que use dois pontos de código na string de entrada.

A tabela a seguir mostra se ocorre uma correspondência para uma string localização de "café" quando comparado a strings de entrada em que é é representado por um ou dois ponto de código. A string localização nesse exemplo usa um ponto de código para representar o caractere é:

Como $replaceOne não executa nenhuma normalização unicode, somente a primeira comparação de strings corresponde, em que as strings de localização e entrada usam um ponto de código para representar é.

Substituir usando uma string

O exemplo a seguir substitui a primeira instância de "blue paint" no campo item por "red paint":

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

A operação retorna os seguintes 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" }

Observe que, com o documento 3, somente a primeira instância correspondente de "blue print" é substituída.

Substitua usando Regex

O exemplo a seguir substitui a primeira instância de "blue" como uma palavra inteira no campo item por "navy":

db.inventory.aggregate([
   {
     $project:
      {
         item: { $replaceOne: { input: "$item", find: \\bblue\\b, replacement: "navy" } }
      }
   }
]);

A operação retorna os seguintes resultados:

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

Observe que, com o document 3, somente a primeira instância correspondente de "blue" é substituída.