$replaceAll (operador de expressão )

Campos do operador

$replaceAll 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 $replaceAll inteira será avaliada como null:

$replaceAll e Agrupamento

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

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 seguinte operação do $replaceAll tenta localizar e substituir todas as instâncias do "Cafe" no campo name :

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 $replaceAll ignora o agrupamento configurado para essa collection, a operação corresponde apenas à instância de "Cafe" no documento 2:

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

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.

$replaceAll e normalização Unicode

A expressão de agregação $replaceAll não executa nenhuma normalização unicode. Isso significa que a correspondência de strings de todas as expressões $replaceAll 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 $replaceAll 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 $replaceAll 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 é.