$strcasecmp (Comparação sem Diferenciar Maiúsculas/Minúsculas)

Última atualização: 2026-10-09

$strcasecmp (Comparação sem Diferenciar Maiúsculas/Minúsculas)

$strcasecmp compara duas strings sem diferenciar maiúsculas de minúsculas e retorna -1, 0 ou 1 — útil para ordenação, agrupamento ou lógica condicional. Aceita apenas strings; outros tipos geram erro. Observe que compara pela ordem dos code points, não por colação de linguagem natural: o chinês é ordenado por code points Unicode, o que pode diferir da ordem por pinyin ou de dicionário. Qualquer argumento null resulta em null.

📝 Sintaxe

{ $strcasecmp: [ <expressão de string1>, <expressão de string2> ] }

⚙️ Parâmetros

Retorno：Resultado da comparação: -1, 0 ou 1; null se qualquer argumento for null.

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// $strcasecmp: comparar com alice ignorando maiúsculas/minúsculas
db.users.aggregate([
  { $project: { cmp: { $strcasecmp: [ '$name', 'alice' ] } } }
])

Saída：

{ "_id": 1, "cmp": 0 }
{ "_id": 2, "cmp": 1 }

📌 Notas

• Sem diferenciar maiúsculas/minúsculas: 'ALICE' versus 'alice' resulta em 0
• Entrada que não é string gera erro — converta com $toString antes
• O sinal corresponde à direção da ordenação, então funciona como auxiliar de ordenação

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós